# oh-my-pi

> Terminal coding agent (fork of Pi) with LSP and DAP debugger integration, subagents, Python/Bun execution, and in-process native tools. Supports 60+ providers.

Stars: 37.0k · Language: TypeScript · License: MIT · Categories: AI

- Repository: https://github.com/can1357/oh-my-pi
- Website: https://omp.sh
- Page: https://www.trmn.sh/tools/oh-my-pi

## Install

- Homebrew: `brew install can1357/tap/omp`
- Bun: `bun install -g @oh-my-pi/pi-coding-agent`
- Shell script (macOS/Linux): `curl -fsSL https://omp.sh/install | sh`

## Overview

oh-my-pi (command: `omp`) is a terminal coding agent with a TUI, built by Stencil Labs as a fork of Mario Zechner's Pi. It connects to 60+ model providers and ships 31 built-in tools, with a Rust core of roughly 80k lines. It runs on macOS, Linux and Windows from the same binary, without a WSL bridge, and generates shell completions for bash, zsh and fish with `omp completions`.

The agent is wired into IDE-style tooling. Edits and renames go through language servers (for example, `workspace/willRenameFiles` updates re-exports and aliased imports before a file moves), with 14 LSP operations exposed. It can also drive real debuggers through DAP (28 operations), such as lldb, dlv and debugpy, to attach, step and inspect frames. Code execution uses persistent Python and Bun workers that can call back into the agent's own tools such as read, search and task. Tools like ripgrep, glob, find and a bash implementation (brush) run in-process, along with 58 ported utilities including ls, sed, sort, xargs and jq, so there is no fork/exec.

Other documented features include time-traveling stream rules, where a regex match aborts the stream, injects a rule as a system reminder and retries. Subagents via `task` run in isolated worktrees and return schema-validated results, and `Alt+A` opens an Agent Hub to monitor or steer them. An 'advisor' role pairs a second reviewer model that comments on each turn. `/collab` shares a live session through a relay with a link or QR code, and teammates join with `omp join` or a browser. `web_search` chains 23 providers and feeds URLs, including arXiv PDFs, to `read` as structured markdown.

It targets developers who want a configurable agent that works across many models and uses language-server and debugger data. It can be installed via script, Homebrew, Bun, Nix (including Home Manager modules) or mise.

### Installation

```bash
# via Homebrew
brew install can1357/tap/omp
```

```bash
# via Bun
bun install -g @oh-my-pi/pi-coding-agent
```

```bash
# via Shell script (macOS/Linux)
curl -fsSL https://omp.sh/install | sh
```

![omp TUI with TypeScript and Biome language servers active](https://media.trmn.sh/cached/1052f90db2bb98269fe653b79872e1df82c85074ce34081baadb7d94abc8f36c.webp)

![omp TUI in a live lldb-dap debugging session](https://media.trmn.sh/cached/97a6f0c97d18c58614fbad9cd1dd30745d8b306c0b05a28942a2b4c2b873dceb.webp)

![omp TUI showing task spawning two subagents](https://media.trmn.sh/cached/7f56cfebf97e2ec2519196bbd79e230fe4625a860d39d20515bf4ca7c6c2b26c.webp)

## Alternatives

- [Continue](https://www.trmn.sh/tools/continue.md): Open-source coding agent distributed as a CLI, VS Code extension, and JetBrains plugin. Repository is read-only after the final 2.0.0 release. (TypeScript, 36.4k stars)
- [OpenClaude](https://www.trmn.sh/tools/openclaude.md): Open-source terminal coding-agent CLI that works with OpenAI-compatible APIs, Gemini, GitHub Models, Codex, Ollama and other cloud or local model backends. (TypeScript, 34.2k stars)
- [Qwen Code](https://www.trmn.sh/tools/qwen-code.md): Open-source AI coding agent that runs in the terminal, with IDE plugins, desktop app, SDKs, and multi-provider model support (OpenAI, Anthropic, Gemini, Qwen). (TypeScript, 28.8k stars)
- [Kilo Code](https://www.trmn.sh/tools/kilocode.md): Open source AI coding agent for VS Code, JetBrains, and the terminal, with 500+ selectable models at provider pricing and an autonomous mode for CI/CD. (TypeScript, 27.8k stars)
- [OmO](https://www.trmn.sh/tools/oh-my-openagent.md): Terminal coding agent run through the omo command. It runs on senpi, a fork of pi, and can split a job into parallel agents across multiple models. (TypeScript, 70.4k stars)

---

Canonical: https://www.trmn.sh/tools/oh-my-pi