Beginner on-ramp for omp (oh-my-pi): a terminal coding agent (TUI plus headless) driving Claude, GPT, Gemini and local models against your repo, with LSP, debugger, subagents and a Rust-fast tool layer.
Start here
| You want | Read |
|---|---|
| Install and a first productive session | Getting started |
| Every key, command, flag and path on one page | Cheat sheet |
| Understand and tune config without getting burned | Settings |
| Habits that make omp feel unfair | Tips & tricks |
| Subagents, parallel work, the advisor | Multi-agent |
| The mistakes everyone makes once | Traps |
Five minutes
curl -fsSL https://omp.sh/install | sh
cd your-repo
ompThen, in order:
omp config get tools.approvalMode— ifyolo, every tool call auto-approves, shell included. Decide deliberately (see Settings)./planbefore any non-trivial task: agent goes read-only and writes a plan file. Read it before approving./omfgwhen the agent misbehaves: forges a permanent correction rule from your complaint.Shift+Tabcycles thinking level;Ctrl+Pcycles models.- Read the diff it produced, not the conversation.
Caveats
- Not an official publication; omp moves fast and defaults drift.
- Upstream verifies against the release in
data/version.txt; a weekly CI job snapshots settings schema, subcommands and flags intodata/and opens an issue on drift. - Authority for your machine is your machine:
omp config list.
Condensed from the omp guide by Hugo Lopes (MIT). Verify against your install:
omp config list.