oh-my-pi
⌥ AI Coding agent for the terminal — hash-anchored edits, optimized tool harness, LSP, Python, browser, subagents, and more
oh-my-pi is a comprehensive terminal-native AI coding agent built on Mario Zechner's Pi framework, extended with batteries-included development tools and workflow automation. It provides hash-anchored code editing, LSP integration, debugger control (DAP), persistent Python/JavaScript evaluation, browser automation, desktop control, and parallel subagent orchestration across 60+ LLM providers. The agent runs interactively in your terminal, operates through an SDK, or integrates with editors via the Agent Client Protocol (ACP), making it suitable for autonomous coding tasks, code reviews, debugging sessions, and multi-step development workflows.
Key Features
Use Cases
- 01Autonomous multi-file refactoring and codebase-wide feature implementation with LSP-powered symbol renaming and navigation
- 02Interactive debugging of segfaults, hangs, or logic errors by attaching native or managed debuggers (lldb, dlv, debugpy) and inspecting state
- 03Code review automation with parallel reviewer subagents producing prioritized P0-P3 issues and ship/block verdicts
- 04Research-driven development combining web search (arXiv papers, Stack Overflow, docs) with local code analysis and implementation
- 05Complex task orchestration by fanning out independent work to isolated subagent workers with schema-validated merge-conflict-free results
- 06Cross-repository tooling and GitHub workflow automation via pr:// and issue:// schemes that read PRs/issues as filesystem paths
Related Agents
View morehermes-agent
The agent that grows with you
agency-agents
A complete AI agency at your fingertips - From frontend wizards to Reddit community ninjas, from whimsy injectors to reality checkers. Each agent is a specialized expert with personality, processes, and proven deliverables.
openinterpreter
A coding agent for open models like Kimi K3
cline
Autonomous coding agent as an SDK, IDE extension, or CLI assistant.
oh-my-pi — FAQ
What is oh-my-pi?+
oh-my-pi is a terminal-based AI coding agent extended from Mario Zechner's Pi framework, providing hash-anchored code editing, LSP/DAP integration, persistent code evaluation, browser/desktop automation, subagent orchestration, and support for 60+ LLM providers. It runs interactively in the terminal, embeds via Node SDK, or integrates with editors through the Agent Client Protocol.
How do I install oh-my-pi?+
On macOS/Linux run `curl -fsSL https://omp.sh/install | sh`; on Windows use PowerShell `irm https://omp.sh/install.ps1 | iex`. Alternatively install via Bun with `bun install -g @oh-my-pi/pi-coding-agent`, Homebrew `brew install can1357/tap/omp`, or Nix `nix profile install github:can1357/oh-my-pi`. The minimum requirement is Bun ≥ 1.3.14.
Which AI clients or editors work with oh-my-pi?+
oh-my-pi runs standalone in the terminal as an interactive TUI. It also integrates with Zed and other editors via the Agent Client Protocol (ACP), embeds in Node/TypeScript projects through its SDK, and supports RPC mode for process-isolated embedding. It is not a plugin for existing AI assistants but a full agent runtime.
What API keys or prerequisites does oh-my-pi require?+
oh-my-pi supports 60+ LLM providers; you configure API keys for your chosen provider (e.g., ANTHROPIC_API_KEY, OPENAI_API_KEY, XAI_API_KEY). OAuth providers like Anthropic, Google Gemini, and Cursor authenticate interactively. Local providers (Ollama, LM Studio, llama.cpp, vLLM) require no key. Web search backends have optional keys (e.g., PERPLEXITY_API_KEY, EXA_API_KEY) with keyless fallbacks for many.
Is oh-my-pi free and open source?+
Yes, oh-my-pi is MIT-licensed and fully open source. The runtime, tools, and Rust core are free to use, modify, and distribute. You pay only for the LLM provider API usage or subscription plans (Cursor, Copilot, etc.) you choose to configure.
Can oh-my-pi run and debug code in multiple languages?+
Yes. The eval tool runs persistent Python and JavaScript/TypeScript (via Bun) with shared prelude and tool re-entry. The debug tool drives DAP-compatible debuggers (lldb for C/C++/Rust, dlv for Go, debugpy for Python, etc.) for breakpoints, stepping, and variable inspection. LSP support covers 50+ languages via tree-sitter grammars.
How do I install oh-my-pi?+
Open the source repository on GitHub and follow its README. oh-my-pi is a agent — MCP Agents Market links you directly to the official repo.
Is oh-my-pi free?+
oh-my-pi is an open-source project hosted on GitHub. Check the repository for its license and any usage requirements.