Oh My Pi (omp)

omp is a single agent process with its own TUI, tool set and session store, installed as a native binary or through Bun. The README describes about 80,000 lines of Rust for native pieces such as grep, glob, a bash implementation and shell utilities, with the agent, tools and extensions in TypeScript. The fork is described as Pi rewritten as a coding-first surface with sessions, subagents, slash commands and extensions.

Multi-agent work goes through the task tool. The parent session spawns subagents from bundled, user, project or plugin agent definitions, each with its own tool list, model preference and optional output schema. A child can run in the background, in an isolated workspace that returns patches, or inline. Results come back as artifacts addressable through agent://<id>, and peers can message each other through a wait and IRC-style mechanism. Spawn depth and allowed child agents are governed by a spawn policy.

Sessions persist to disk and can be resumed, forked and shared. Memory is optional and off by default: retain, recall and reflect tools sit on a configurable backend (local, Hindsight or Mnemopi). Rules can be injected mid-stream when a pattern matches, and skills, rules and MCP servers are imported from other tools' config directories.

Interactive runs route ambiguity through the ask tool, a structured picker. Tool approval has three tiers, and always-ask, write and yolo modes; the default is yolo, which auto-approves everything, and --yolo or --auto-approve force it. Per-tool overrides can allow, deny or prompt. In Agent Hub the user can steer, revive or kill any subagent without ending the parent session. Over ACP, editor permission prompts gate edits and shell commands, and read-only /collab view links allow watching without steering.

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

# macOS, Linux
curl -fsSL https://omp.sh/install | sh
# alternatives from the README
brew install can1357/tap/omp
bun install -g @oh-my-pi/pi-coding-agent

# Interactive TUI in a project
omp

# One-shot prompt
omp -p "list the TypeScript files that import the auth module"

# Editor and host integrations
omp acp
omp --mode rpc --no-session

# Shell completions
eval "$(omp completions zsh)"

• Needs Bun 1.3.14 or newer for the Bun install path.
• On Alpine, the prebuilt musl binary needs apk add libstdc++ libgcc.
• The default approval mode is yolo; set tools.approvalMode to always-ask or write if you want prompts.
• Memory tools (retain, recall, reflect) and several other tools are setting-gated and off by default.
• Open issues report --approval-mode write hanging in RPC mode because there is no approval channel, and a relative --session-dir breaking parallel subagent spawns on Windows.
• The project is a fork of Pi; the docs include a porting-from-pi-mono guide.

Yes, as a client. It adds and validates servers in .omp/mcp.json or ~/.omp/agent/mcp.json, imports servers from other tools' config files, and supports stdio, HTTP and SSE transports. It documents no MCP server mode.

The task tool spawns subagents from agent definitions, individually or in a batch. They can run in the background or in isolated workspaces that return patches, and Agent Hub lets you steer, revive or kill them.

Yes. The README says it is a fork of Pi by Mario Zechner, extended with a coding-first workflow. A separate Pi record exists in this directory.

The repository is MIT licensed and no paid plan is documented. The docs site has no pricing page (omp.sh/pricing returned 404). Model provider usage is billed by your provider.

The default approval mode is yolo, so tools run without prompts. Change tools.approvalMode to always-ask or write for approvals.