A coding agent with the IDE wired in.
omp.sh
Fork of Pi by @mariozechner
The most capable agent surface that ships. Continuously tuned by real-world use — complete out of the box, open all the way down.
60+ providers · 31 built-in tools · 14 lsp ops · 28 dap ops · ~80k lines of Rust core.
[!NOTE]
Pull requests are temporarily open to everyone as a trial. We previously
required a vouch before accepting PRs; that requirement is lifted for now
while we evaluate how open contributions go. Depending on the results, the
vouch system may return.
Install
macOS · Linux
curl -fsSL https://omp.sh/install | sh
Alpine / musl: the prebuilt musl binary links libstdc++/libgcc dynamically, which stock Alpine does not ship. Install them first: apk add libstdc++ libgcc.
Homebrew
brew install can1357/tap/omp
Bun (recommended)
bun install -g @oh-my-pi/pi-coding-agent
Nix
# Run without installing
nix run github:can1357/oh-my-pi
# Or install into the active profile
nix profile install github:can1357/oh-my-pi
Flake consumers can use packages.<system>.omp, overlays.default, nixosModules.default, or homeManagerModules.default. A Home Manager configuration can install OMP and own its settings declaratively:
{
inputs.omp.url = "github:can1357/oh-my-pi";
# In your Home Manager module:
imports = [ inputs.omp.homeManagerModules.default ];
programs.omp = {
enable = true;
settings.startup.quiet = true;
};
}
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.
| model |
metric |
what |
| Grok Code Fast 1 |
6.7% → 68.3% |
Tenfold lift the moment the edit format stops eating the model alive. |
| Gemini 3 Flash |
+5 pp |
Over str_replace — beats Google's own best attempt at the format. |
| Grok 4 Fast |
−61% tokens |
Output collapses once the retry loop on bad diffs disappears. |
| MiniMax |
2.1× |
Pass rate more than doubles. Same weights, same prompt. |
read : summarized snippets · ideal defaults · selector hit rategrep : fastest in the westlsp : everything your IDE knows, the agent knowsprompts : adjusted relentlessly for each model
Read the full post ↗
The Pi you love, with batteries included.
Originally built on Mario Zechner's wonderful Pi, omp adds everything you're missing.
Most harnesses give the agent a Python sandbox and call it done. Ours runs persistent Python and a Bun worker, and either kernel can call back into the agent's own tools — read, search, task — over a loopback bridge. The agent loads a CSV with tool.read from inside Python, charts it from JavaScript, and never leaves the cell.
02 · LSP wired into every write
Ask for a rename and you get a rename. The call goes through workspace/willRenameFiles, so re-exports, barrel files, and aliased imports update before the file moves. Everything your IDE knows, the agent knows.
Read the LSP config docs
03 · Drives a real debugger
A C binary segfaults: the agent attaches lldb, steps to the bad pointer, reads the frame. A Go service hangs: it attaches dlv and walks the goroutines. A Python process is wedged: debugpy, pause, inspect, evaluate. Most agents are still sprinkling print statements.
Watch the capture ↗
04 · Time-traveling stream rules
Your rules sit dormant until the model goes off-script. A regex match aborts the stream mid-token, injects the rule as a system reminder, and retries from the same point. You get course-correction without paying context tax on every turn. Injections survive compaction, so the fix sticks.
Watch the capture ↗
05 · First-class subagents
Split a job across workers and get typed results back. task fans out into isolated worktrees, each worker runs its own tool surface, and the final yield is a schema-validated object the parent reads directly. No prose to parse, no merge conflicts between siblings, no orphaned edits.
Watch the capture ↗
Watch the fan-out while it runs: Alt+A opens Agent Hub, where the roster shows current activity and usage for every subagent. Open one to read its live transcript, type a steering message, revive a parked worker, or kill a stuck one without aborting the parent session.
06 · A second model, watching every turn.
Pair a reviewer model to the 'advisor' role and it reads every turn the main agent takes, injecting notes inline — a quiet aside, a concern, or a hard blocker. It runs on its own context and its own model, so it catches what the doer rushed past. The main agent sees the note and course-corrects, or tells you why it won't.
Watch the capture ↗
07 · Hand someone the link, they're in.
/collab puts your live session on a relay and hands back a link — and a QR. A teammate joins from another terminal with omp join, or just opens it in a browser. Share read-write to pair on the same agent, or /collab view for a read-only link anyone can watch but no one can steer. Frames are sealed client-side; the relay never sees your keys.
Watch the capture ↗
08 · Read a pdf on arxiv, why not?
web_search chains twenty-three ranked providers and hands whatever URLs it finds straight to read. Arxiv PDFs, GitHub pages, Stack Overflow threads come back as structured markdown with anchors intact — the same tool surface you use on local files. Cite, follow, quote, never lose where you came from.
Watch the capture ↗
09 · Unapologetically native. Even on Windows.
Other agents shell out to rg, grep, find, and bash. On many machines those binaries don't exist, and on the ones where they do, every call costs a fork-exec round-trip. omp links the real implementations into the process. ripgrep, glob, find: in-process. brush is the bash — with sessions that survive across calls, and 58 command-line utilities (ls, sed, sort, xargs, even jq) ported into the builtins crate and run in-process, zero fork/exec. The same omp binary runs on macOS, Linux, and Windows — no WSL bridge.
10 · Code review with priorities and a verdict
Get a clear verdict on whether the change ships, with every issue ranked P0 through P3 and scored for confidence. /review spawns dedicated reviewer subagents that sweep branches, single commits, or uncommitted work in parallel. You tackle what blocks release first; nothing important hides in a wall of prose.
11 · Hashline: edit by content hash
Perfect edits, fewer tokens. The model points at anchors instead of retyping the lines it wants to change, so whitespace battles and string-not-found loops just stop happening. Edit a stale file and the anchors diverge — we reject the patch before it corrupts anything. Grok 4 Fast spends 61% fewer output tokens on the same work.
12 · GitHub is just another filesystem
Other harnesses bolt on gh_issue_view, gh_pr_view, gh_search — each with its own parameters the agent has to learn and you have to debug. We skipped that. read already handles paths; PRs are paths. One interface to teach the model, one surface to keep correct.
13 · Memory the agent curates
The agent remembers your codebase between sessions. It writes facts mid-run with retain, captures reusable lessons with learn, pulls them back with recall, and compresses each session into a mental model that loads on the first turn of the next one. Pick the engine with memory.backend — local, Hindsight, or Mnemopi. Project-scoped by default, so what it learns about this repo stays with this repo.
14 · ACP: editor-drivable agent
Run omp inside Zed and you get the same agent you drive from the terminal — reading the buffer you're actually looking at, writing through the editor's save path, spawning shells in the editor's terminal. Destructive tools pause for a permission prompt you can answer once and forget. No bridge, no plugin, no second brain to keep in sync.
Every other agent ships an importer and expects you to convert. omp reads the eight formats already on disk in their native shape — Cursor MDC, Cline .clinerules, Codex AGENTS.md, Copilot applyTo, and the rest. No migration script, no YAML-to-TOML port, no "supported subset" footnotes. The config your team wrote last quarter still works tonight.
16 · omp commit: atomic splits, validated messages
omp reads the working tree through git_overview, git_file_diff, and git_hunk, then splits unrelated changes into atomic commits ordered by their dependencies. Cycles are rejected before anything is written. Source files score above tests, docs, and configs, so the headline commit is the one that matters. Lock files are excluded from analysis entirely.
17 · Read PRs. Walk skills. Pull JSON out of subagents.
Sixteen internal schemes — pr://, issue://, agent://, skill://, ssh://, and the rest — resolve transparently inside every FS-shaped tool the agent already calls. read pr://1428 returns the same shape as read src/foo.ts. grep walks a diff like a directory. agent://<id>/findings.0.path pulls a field out of a subagent's output by path.
18 · Conflict resolution, made easy.
Each merge conflict becomes one URL. The agent writes @theirs, @ours, or @base to conflict://N and the file resolves cleanly. Bulk form: conflict://*.
Watch the capture ↗
19 · Preview, then accept.
ast_edit returns a (proposed) card with the replacement count. The change is staged. The agent writes a one-line reason to xd://resolve; the TUI turns it into an Accept card and the disk move happens — atomic, all or nothing.
Watch the capture ↗
20 · Drives a real browser. Or your Slack?
Eval's browser.open(...) returns a tab handle with direct navigation, inspection, interaction, and element helpers; tab.run(...) handles custom JavaScript. It drives Chromium or Electron in an isolated tab runtime. Stealth is on by default, while the browser relay can adopt Chrome tabs you already have open without stealing focus.
21 · Hands on the desktop itself
Eval's computer helpers — computer.window(...), win.screenshot(), win.ax(), el.press(), plus computer.run(fnOrCode, options) for multi-step scripts — control the real host: enumerate windows and displays, capture screenshots, send native input, walk the OS accessibility tree, and use the clipboard. It exposes no browser DOM.
Whatever the task needs, it's already in the box.
Core tools live in the same namespace as read and bash. Pin the active set with --tools read,edit,bash,…; rarely used discoverable tools stay behind xd:// devices. read xd:// lists them, and write xd://<tool> runs one when tools.xdev is enabled.
Files & search
read — files, dirs, archives, SQLite, PDFs, notebooks, URLs, remote ssh:// paths, and internal :// schemes through one path.write — create or overwrite a file, archive entry, or SQLite row.edit — hashline patches with content-hash anchors and stale-anchor recovery.ast_edit — structural rewrites previewed before apply, via ast-grep.ast_grep — structural code queries over 50+ tree-sitter grammars.grep — regex over files, globs, and internal URLs.glob — glob-based path lookup; reach for grep when you need content matches.
Runtime
bash — workspace shell with 46 in-process coreutils, optional PTY, and background-job dispatch.eval — persistent Python and JavaScript cells with shared prelude and tool re-entry.
Code intelligence
lsp — diagnostics, navigation, symbols, renames, code actions, raw requests.debug — drive a DAP session — breakpoints, stepping, threads, stack, variables.security_scan — plan and run native security reviews; drives Codex Security cloud scans.
Coordination
task — fan out subagents in parallel, optionally workspace-isolated.hub — message live agents, wait on or cancel background jobs, and supervise long-running processes.todo — ordered mutations over the session todo list with phase tracking.ask — structured follow-up questions for interactive runs.
Desktop & web
browser — Puppeteer tabs over headless Chromium, CDP-attached apps, or your own Chrome via the relay.computer — persistent JS against the host desktop: windows, screenshots, native input, AX tree, clipboard.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.tts — text-to-speech via xAI Grok Voice — five built-in voices, WAV or MP3.
Memory & skills
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 memory bank.recall — search the memory bank for raw memories.reflect — synthesize an answer over the bank.memory_edit — update, forget, or invalidate stored memories by id.learn — capture a reusable lesson; optionally promote it into a managed skill.manage_skill — create, update, or delete an isolated managed skill.
Setting-gated, off by default: github, security_scan, generate_image, tts, checkpoint, rewind, and the memory tools (retain/recall/reflect/memory_edit, per memory.backend).
Full reference →
Prompt controls
Three standalone, lowercase words opt a turn into specialized agent behavior:
ultrathink — request careful multi-step reasoning and the highest supported automatic thinking effort.orchestrate — run substantial independent work through parallel subagents and verify each phase.workflowz �
omp（oh-my-pi）是一个终端编程助手（coding agent），基于 Mario Zetchner 的 Pi 修改而来，集成了 IDE 功能，由 Stencil Labs 开发：支持 60 多家模型服务商、31 个内置工具、14 种 LSP 操作和 28 种调试器操作，Rust 核心代码约 8 万行。