# 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.

## Install

Copy the content below into your project:

## Quick Use

1. Install / set up:
   ```bash
   curl -fsSL https://raw.githubusercontent.com/can1357/oh-my-pi/main/scripts/install.sh | sh
   ```
2. Start / smoke test:
   ```bash
   omp
   ```
3. Verify:
   - In the interactive UI, run `/model` to confirm the model picker opens, then run `/mcp` to confirm MCP management is available.

## 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

---

<!-- ZH -->

## 快速使用

1. 安装 / 设置：
   ```bash
   curl -fsSL https://raw.githubusercontent.com/can1357/oh-my-pi/main/scripts/install.sh | sh
   ```
2. 启动 / 冒烟测试：
   ```bash
   omp
   ```
3. 验证：
   - 进入交互 UI 后先运行 `/model`（确认能打开模型选择器），再运行 `/mcp`（确认 MCP 管理可用）。

## 简介

oh-my-pi 是一个在终端运行的 AI 编码 Agent（命令为 `omp`）：集成工具编排、MCP 管理、会话分支/压缩与多 Provider 登录，让“可重复的编码跑法”变得更顺手。

- **适合谁：** 希望用键盘优先的 Agent 交互（slash 命令、MCP 开关、会话导出）的开发者
- **可搭配：** macOS/Linux/Windows 终端；通过环境变量或 `/login` 接入模型；通过 `/mcp` 管理 MCP
- **准备时间：** 8 分钟

## 实战建议

- 准备时间约 8 分钟（安装 + 配一把 key + 首次启动）
- 内置大量 slash 命令用于 plan/memory/MCP（例如 `/plan`、`/memory`、`/mcp`）
- GitHub stars / forks（已核验）作为热度信号：见「来源与感谢」

更高效的用法是把 `omp` 当作“可重复的执行框架”，而不是普通聊天窗口：

1. 在仓库根目录启动，保持 cwd 稳定（让工具调用与路径解析更可靠）。
2. 用 slash 命令显式管理状态：切模型、压缩上下文、按需开启/关闭 MCP。
3. 让每次 run 都可复盘：必要时导出会话，改动保持足够小以便快速验证。

两个省时的小建议：

- 先把终端输入协议配置好（尤其是 Kitty keyboard protocol 相关），不然快捷键/修饰键可能不稳定。
- 一开始只接入一个 provider/key，把工作流稳定下来后再扩展更多来源。

### FAQ

**`omp` 是什么？**
答：`omp` 是 oh-my-pi 的交互式终端入口命令，用来启动编码 Agent。

**一定需要 Bun 吗？**
答：仓库推荐 Bun 路径，但安装脚本在可用时也会安装预编译二进制。

**怎么接入 MCP？**
答：在对话里使用 `/mcp` 来添加/启用/禁用 MCP 服务器。

## 来源与感谢

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


---
Source: https://tokrepo.com/en/workflows/oh-my-pi-terminal-ai-coding-agent-omp
Author: Agent Toolkit