Overview
oh-my-pi — `omp` on the command line — is a coding agent for the terminal, forked from Mario Zechner's Pi and extended into a batteries-included assistant. Its stated premise is "a coding agent with the IDE wired in": rather than editing text blind, the agent talks to a language server, so renames and refactors happen at workspace level with the same symbol information a human editor would have.
The debugging and execution story follows the same idea. omp drives real debuggers through DAP — lldb, dlv and debugpy — and keeps persistent Python and JavaScript sessions alive between tool calls, so state carries across steps instead of every snippet starting from scratch. It ships 31 built-in tools, subagents that run work in parallel and return schema-validated results, a memory system for durable facts and learned skills, and web search across 23 providers with structured extraction.
It is deliberately provider-neutral: 60+ LLM providers are supported, spanning frontier APIs (Anthropic, OpenAI, Google Gemini, xAI, DeepSeek, Mistral, Groq), coding plans routed through Cursor, GitHub Copilot and Devin, and local runtimes via Ollama, LM Studio and llama.cpp. The core is roughly 80,000 lines of Rust with a TypeScript/Bun surface, ripgrep, bash and coreutils are linked in-process, and live collaboration is available through shareable links and QR codes. The project is MIT-licensed; vendored components such as brush-shell keep their upstream licences.
What it does
- LSP integration so edits and refactors are symbol-aware across the whole workspace
- Debugger support through DAP with lldb, dlv and debugpy
- Persistent Python and JavaScript execution environments that keep state across tool calls
- 60+ LLM providers: frontier APIs, coding plans (Cursor, GitHub Copilot, Devin) and local models via Ollama, LM Studio and llama.cpp
- Subagents that run in parallel and return schema-validated results
- Memory system for durable facts and learned skills, plus 31 built-in tools
- Web search across 23 providers with structured extraction
- Live collaboration through shareable links and QR codes
Getting started
omp installs as a single command-line tool. Pick whichever of the project's install paths fits your machine, then run it inside a repository.
Install on macOS or Linux
Use the install script, or the project's Homebrew tap.
curl -fsSL https://omp.sh/install | sh
# or
brew install can1357/tap/ompInstall with Bun
The README calls the Bun package the recommended route if you already have Bun.
bun install -g @oh-my-pi/pi-coding-agentInstall on Windows or with Nix
PowerShell and Nix flake entry points are both published.
irm https://omp.sh/install.ps1 | iex
# Nix
nix run github:can1357/oh-my-piPick a provider and start working
Configure one of the supported providers — a frontier API key, an existing coding plan, or a local endpoint from Ollama, LM Studio or llama.cpp — then run omp from the root of the repository you want it to work on.
Commands and code are distilled from the project's own documentation — always check the official repo for the latest.
When to use it
- Reach for it when you want an agent whose edits are language-server accurate rather than text-substitution guesses
- Use it when a task needs real debugging — setting breakpoints and stepping through with lldb, dlv or debugpy — not just re-running a script
- Good for data-ish work where a persistent Python or JavaScript session between steps saves recomputing state
- Useful when you want one agent front-end across frontier APIs, existing coding plans and local models
How oh-my-pi compares
oh-my-pi alongside other open-source autonomous coding agents tools AI/TLDR tracks, ranked by GitHub stars.
| Tool | Stars | What it does |
|---|---|---|
| opencode | ★ 208k | OpenCode is an open source AI coding agent that runs in your terminal, with built-in build and plan agents and an optional desktop app. |
| Claude Code | ★ 145k | Anthropic's agentic coding tool for the terminal, IDE and GitHub: it understands your codebase, executes routine tasks, explains code and handles git workflows from natural-language commands. |
| OpenAI Codex | ★ 125k | OpenAI's cloud and CLI coding agent that writes features, fixes bugs, and proposes code changes across a repo, running tasks in parallel. |
| Gemini CLI | ★ 107k | An open-source command-line AI agent from Google that connects your terminal to Gemini models for reading code, editing files, running shell commands, and searching the web. |
| Pi | ★ 106k | Minimal terminal coding agent harness with four built-in tools, extended through TypeScript extensions, skills and prompt templates instead of forks. |
| autoresearch | ★ 96.1k | Karpathy's minimal harness that hands a coding agent a single-GPU LLM training script and lets it run fixed five-minute experiments, keeping or discarding each change on its own. |
| OpenHands | ★ 88.2k | An open-source AI software-development agent that plans tasks, edits files, runs commands, and tests code, usable from a terminal CLI, a local web GUI, or a Python SDK. |
| oh-my-pi | ★ 31.4k | A terminal coding agent with the IDE — LSP, debugger, live runtimes — wired in |