SkillsMay 12, 2026·2 min read

oh-my-pi — Terminal AI Coding Agent (omp)

oh-my-pi is a terminal AI coding agent (`omp`) with a tool harness, MCP management, session branching, and provider logins for repeatable coding runs.

Agent ready

Review-first install path

This asset needs a review step. The copied prompt tells the agent to dry-run, show the writes, then proceed only after confirmation.

Needs Confirmation · 64/100Policy: confirm
Agent surface
Any MCP/CLI agent
Kind
Skill
Install
Single
Trust
Trust: Established
Entrypoint
Asset
Review-first command
npx -y tokrepo@latest install be17f012-2b4f-4814-9cfe-c916578cf98b --target codex

Dry-run first, confirm the writes, then run this command.

Intro

oh-my-pi is a terminal AI coding agent (omp) with a tool harness, MCP management, session branching, and provider logins for repeatable coding runs.

  • Best for: developers who want a keyboard-first agent harness with slash commands, MCP toggles, and session export
  • Works with: macOS/Linux/Windows terminals; LLM providers via env vars or /login; MCP servers via /mcp
  • Setup time: 8 minutes

Practical Notes

  • Setup time ~8 minutes (install + set one API key + first launch)
  • Ships built-in slash commands for plan/memory/MCP management (e.g., /plan, /memory, /mcp)
  • GitHub stars/forks (verified) for momentum signal: see Source & Thanks

A productive way to use omp is to treat it as a repeatable harness rather than a “chat UI”:

  1. Start in your repo root and keep the agent’s working directory stable.
  2. Use the built-in slash commands to manage state explicitly: switch models, compact context, and toggle MCP servers only when needed.
  3. Keep your runs reviewable: export sessions, and keep changes small enough to validate quickly.

Two tips that save time:

  • If your terminal doesn't support the Kitty keyboard protocol, configure it first (otherwise modifier keys can behave inconsistently).
  • Prefer a single provider/API key at the start. Add more providers only after you’ve stabilized your workflow.

FAQ

Q: What is omp? A: omp is the interactive terminal UI entrypoint for oh-my-pi's coding agent harness.

Q: Do I need Bun? A: The repo recommends Bun for installation in some paths, but the installer script can install a prebuilt binary when available.

Q: How do I connect MCP servers? A: Use the in-chat /mcp command to add/toggle MCP servers as you need them.

🙏

Source & Thanks

Source: https://github.com/can1357/oh-my-pi > License: MIT > GitHub stars: 4,307 · forks: 394

Discussion

Sign in to join the discussion.
No comments yet. Be the first to share your thoughts.

Related Assets