oh-my-pi

Supports Codex, Cursor, Windsurf, Mcp

macOS · Linux

curl -fsSL https://omp.sh/install | sh

Homebrew

brew install can1357/tap/omp

Bun (recommended)

bun install -g @oh-my-pi/pi-coding-agent

Windows (PowerShell)

irm https://omp.sh/install.ps1 | iex

Pinned versions (mise)

mise use -g github:can1357/oh-my-pi

macOS · Linux · Windows · bun ≥ 1.3.14

Shell completions

omp generates its own completion scripts for bash, zsh, and fish from the live command/flag metadata, so they never drift from the actual CLI. Subcommands, flags, and enum values complete statically; model names (--model, --smol, --slow, --plan) resolve against the bundled model catalog and --resume against your on-disk sessions.

# zsh — add to ~/.zshrc (or write the output into a file on your $fpath)
eval "$(omp completions zsh)"

# bash — add to ~/.bashrc
eval "$(omp completions bash)"

# fish
omp completions fish > ~/.config/fish/completions/omp.fish

Edits that land on the first attempt. Reads that summarize files instead of dumping their content. Searches that return instantly. Pick any model — omp will get it right.

• read : summarized snippets · ideal defaults · selector hit rate
• search : fastest in the west
• lsp : everything your IDE knows, the agent knows
• prompts : adjusted relentlessly for each model

Read the full post ↗

Coordination

• task — fan out subagents in parallel, optionally workspace-isolated.
• irc — short prose between live agents in this process.
• todo — ordered mutations over the session todo list with phase tracking.
• job — wait on or cancel background jobs.
• ask — structured follow-up questions for interactive runs.

Outside the box

• browser — Puppeteer tabs over headless Chromium or CDP-attached apps.
• web_search — one query across configured providers, returning answer plus citations.
• github — GitHub CLI ops — repo, PR, issues, code search, Actions run-watch.
• generate_image — generate or edit raster images via Gemini, GPT, or xAI Grok image models.
• inspect_image — vision-model analysis of a local image file.
• tts — text-to-speech via xAI Grok Voice — five built-in voices, WAV or MP3.

Memory & state

• checkpoint — mark conversation state for a later collapse-and-report.
• rewind — prune exploratory context, keep a concise report.
• retain — queue durable facts into the active Hindsight bank.
• recall — search the Hindsight bank for raw memories.
• reflect — ask Hindsight to synthesize an answer over the bank.

Misc

• resolve — apply or discard a queued preview action.
• search_tool_bm25 — BM25 over the hidden tool index; activates top matches mid-session.

Setting-gated, off by default: github, inspect_image, tts, checkpoint, rewind, search_tool_bm25, retain, recall, reflect. Flip them on once, scoped per project.

Full reference →

Run it yourself

OpenAI-compatible /v1/models. Local instances skip the key.

Ollama local · Ollama Cloud · LM Studio local · llama.cpp local · vLLM local · LiteLLM

Four knobs that make routing useful

• Custom providers — Declare anything that speaks openai-completions, openai-responses, openai-codex-responses, azure-openai-responses, anthropic-messages, google-generative-ai, or google-vertex in ~/.omp/agent/models.yml.
• Fallback chains — Per-role chains under retry.fallbackChains. When the primary throws 429s or hits a quota wall, the next entry takes the rest of the turn — restored on cooldown.
• Path-scoped models — Scope enabledModels and disabledProviders entries to a path: prefix to pin a different model set on one repo without touching the global config. Scoped entries cover the path and everything under it.
• Round-robin credentials — Stack API keys per provider and the runtime rotates with session affinity and per-credential backoff. Useful when one key would burn its quota by lunch.

Full provider & routing reference at omp.sh/docs/providers.