Oh My Pi

Why this agent

Oh My Pi(omp)是从 pi-mono 派生出来的终端 AI 编程 agent,带 OMP 专用工具、模型角色、会话/分支、子 agent、插件 和 skill 扩展。它的 MCP-server 策略是继承式的 —— 首次启动时, omp 从你现有的 IDE 配置(.claude、.cursor、.codex 等)读 MCP 服务,所以你已经通过 install://claude-code(或同类)接好的 任何 agent,在 Oh My Pi 里也直接可用。

Prerequisites

• 已安装 Oh My Pi;omp --version 能跑。安装说明见 https://github.com/can1357/oh-my-pi#installation。
• espctl 已安装在磁盘上某个稳定位置(下文需要完整路径)。
• 至少有一个 Oh My Pi 继承的 IDE 配置文件: .claude/settings.json、.cursor/mcp.json、 ~/.codex/config.toml、.gemini/...、.windsurf/...、 .cline/...、.github/copilot/... 或 .vscode/...。
• (可选,用于远程构建)Aegis 构建服务器地址 + MCP_AUTH_SECRET。

Install snippet (or alternative)

Oh My Pi 没有自己的 MCP-server 配置文件 —— 它从你的 IDE 配置继承。 最简单的方法是把 Claude Code 的片段粘进 .claude/settings.json (项目级或全局):

{
  "mcpServers": {
    "espctl": {
      "command": "/path/to/espctl",
      "args": ["mcp", "serve"],
      "cwd": "/path/to/your/esp-idf/project",
      "env": {
        "CONTROL_BASE_URL": "https://esphome.cloud",
        "MCP_AUTH_SECRET": "your-access-key"
      }
    }
  }
}

替换:

• /path/to/espctl —— 你电脑上 espctl 程序的完整路径。
• /path/to/your/esp-idf/project —— Oh My Pi 应该操作的项目完整路径。
• CONTROL_BASE_URL —— 你的 Aegis 构建服务器地址。
• MCP_AUTH_SECRET —— 构建服务器给你的访问密钥。

首次启动时,omp 会发现这个条目,把 espctl 注册为 MCP 服务。 不用动 omp 自己的配置。

已经接通了 Claude Code、Cursor 或其他 IDE?omp 会自动继承它们的 MCP 服务 —— 啥都不用做。

或者 —— 拿到预填好的代码片段:

读取 install://oh-my-pi 资源。

First-run verification

cd /path/to/your/esp-idf/project
omp --model deepseek/deepseek-v4-pro

在 omp 会话里问:

你有哪些 espctl 工具?

预期:列出约 40 个 espctl 工具。

Troubleshooting

• omp 看不到工具列表里的 espctl —— Oh My Pi 只在首次启动时 继承。如果你跑过 omp 之后才加了 .claude/settings.json 条目, 用 /reload-plugins 强制重新发现,或者删 ~/.omp/agent/plugins.json 让继承重跑。
• 继承的 IDE 配置不对 —— 如果你 .claude 和 .cursor 都有 且互相冲突,omp 的优先级顺序可能和你的意图不符。只配一个 MCP 源会更可预测。
• MCP_AUTH_SECRET 没传过去 —— Oh My Pi 是从 .claude/settings.json 整块继承 env。核对值是明文 token, 不是未展开的 $VAR。

Tested as-of 2026-05-19

Oh My Pi 特有注意事项

• 引用 Oh My Pi README:“首次启动时 omp 继承磁盘上已有的内容: 来自 .claude、.cursor、.windsurf、.gemini、.codex、 .cline、.github/copilot 和 .vscode 的规则、skills 和 MCP 服务。”
• OMP 自己的模型 provider 配置(不是 MCP 服务)在 ~/.omp/agent/models.yml;awesome-deepseek-agent 的指南讲的是 这一层的 DeepSeek-V4-Pro/Flash 配置。
• /reload-plugins 不重启 omp 也能重新扫描继承的配置。