oh-my-pi is an MIT-licensed, terminal-based coding agent distributed as omp, built for developers who want a complete agent surface — 60+ model providers, 31 built-in tools, language-server and debug-adapter integration — that runs on their own machine instead of assembling a stack of separate tools.

What it is

oh-my-pi is a coding agent for the command line, surfaced through Rust core code of roughly 80,000 lines and installed through a shell script, Homebrew, Bun, Nix, or mise. It is a fork of Pi by Mario Zechner, and the README describes it as keeping Pi's foundation while adding what it calls the missing pieces: 60+ providers, 31 built-in tools, 14 LSP operations, and 28 DAP operations. It lives in the TypeScript and Bun ecosystem at the edges and in Rust underneath. Its topics place it among AI coding agents for Anthropic, OpenAI, and multi-provider setups, with MCP listed as a supported integration. The project's homepage is omp.sh.

The problem it solves is framed in the README as a harness problem, not a model problem: edit formats that consume a model alive, retry loops on malformed diffs, and file reads that dump contents instead of summarizing them. omp replaces the bare agent-plus-sandbox pattern — in its words, most harnesses give the agent a Python sandbox and call it done — with a harness that runs a persistent Python kernel and a Bun worker side by side, either of which can call back into the agent's own tools such as read, search, and task over a loopback bridge. It likewise replaces bolting editor awareness onto an agent after the fact, routing language-server calls such as workspace/willRenameFiles through the write path itself.

Key capabilities

• 31 built-in tools alongside 14 LSP operations and 28 DAP operations, so editing, searching, and debugging share one tool surface.
• Code execution with tool-calling: a persistent Python kernel and a Bun worker live in the same session, and the agent can load a CSV with tool.read from inside Python and chart it from JavaScript without leaving the cell.
• LSP wired into every write, so a rename goes through workspace/willRenameFiles and re-exports, barrel files, and aliased imports update before the file moves.
• read returns summarized snippets rather than full file contents, with grep handling repository search.
• Multi-provider support across 60+ providers, with Anthropic, OpenAI, and MCP named in the project topics, and prompts adjusted per model.
• Shell completions generated for bash, zsh, and fish from live command and flag metadata; subcommands, flags, and enum values complete statically, while --model, --smol, --slow, and --plan resolve against the bundled model catalog and --resume resolves against on-disk sessions.
• Nix flake outputs in packages.omp, overlays.default, nixosModules.default, and homeManagerModules.default, plus pinned installs through mise.

Who uses it and how

• Terminal-first developers on macOS, Linux, and Windows install through the shell script, the PowerShell script, the Homebrew tap can1357/tap/omp, or the Bun package @oh-my-pi/pi-coding-agent.
• Nix and Home Manager users manage the agent declaratively, enabling programs.omp with settings such as settings.startup.quiet rather than editing config by hand.
• Alpine and musl users run it after adding libstdc++ and libgcc, since the prebuilt musl binary links them dynamically and stock Alpine does not ship them.
• Teams that switch between providers use one agent surface across models instead of maintaining per-model tooling, which is the outcome the README's benchmark tables and per-model prompt tuning are aimed at.
• Contributors currently submit pull requests without a vouch, a requirement the project lifted on a trial basis after previously gating contributions.

Getting started

Install with the shell script at https://omp.sh/install, or with bun install -g @oh-my-pi/pi-coding-agent, brew install can1357/tap/omp, or nix profile install github:can1357/oh-my-pi. Windows users run the PowerShell installer at https://omp.sh/install.ps1, and pinned versions are available through mise.

How it compares

The facts name one comparable tool: Pi by Mario Zechner, the upstream project oh-my-pi forks. Where Pi provides the base agent, oh-my-pi layers on code execution with tool-calling, LSP and DAP operations, a bundled model catalog, and packaging across Homebrew, Bun, Nix, and mise.

When to use it — and when not to

There is no hosted option, so adopters install and run everything themselves, and Alpine users must add libstdc++ and libgcc before the musl binary works. The project carries 2,964 open issues against 3,309 forks, and its contribution policy is explicitly provisional, since the vouch requirement may return depending on how open pull requests go. Anyone who needs a frozen governance model, a guaranteed contribution path, or a managed service should look elsewhere; developers who want the agent surface on their own machine and are comfortable with that churn are the intended audience.

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

brew install can1357/tap/omp

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

# Run without installing
nix run github:can1357/oh-my-pi

# Or install into the active profile
nix profile install github:can1357/oh-my-pi

{
  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;
  };
}

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

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

# 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