oh-my-pi 快速上手:从安装 AI 编程智能体到写出第一行修改
【免费下载链接】oh-my-pi⌥ Coding agent with the IDE wired in项目地址: https://gitcode.com/GitHub_Trending/oh/oh-my-pi
oh-my-pi(命令行名omp)是一个终端原生的开源 AI 编程智能体,最大亮点是把 IDE 能力直接接进 Agent:LSP 诊断、真实调试器、子代理并行、31 个内置工具开箱即用。这篇快速上手教程带你 5 分钟完成安装,并让它在你的项目里写出第一行修改。
它凭什么"开箱即用"?
一句话概括:别的 Agent 只会读写文件,oh-my-pi 还懂你的 IDE 会什么。
- 🔧LSP 全程参与:重命名走
willRenameFiles,re-export、桶文件、别名导入自动同步更新 - 🐞驱动真实调试器:lldb、dlv、debugpy 直接挂上去断点单步
- 🐍持久化 Python/JS 执行:代码跑完不退出,还能回调 Agent 自己的工具
- ⚡搜索全部在进程内:ripgrep、glob、find 直接编译进二进制,无需 fork/exec
一键安装步骤:三种方式任选
打开终端,三选一即可(macOS / Linux / Windows 均支持):
# 方式一:官方脚本(macOS / Linux) curl -fsSL https://omp.sh/install | sh # 方式二:Bun 全局安装(推荐) bun install -g @oh-my-pi/pi-coding-agent # 方式三:Homebrew brew install can1357/tap/omp装完验证一下:
omp --version💡 Alpine 用户请先
apk add libstdc++ libgcc;Windows 用 PowerShell 执行irm https://omp.sh/install.ps1 | iex。 也可以omp completions zsh(或 bash/fish)生成 shell 补全,子命令和模型名都能补全。
首次启动:2 分钟完成认证与模型选择
在项目根目录直接运行:
omp首次启动会引导你完成omp setup式的初始化:选择模型供应商、登录或填 API Key、指定默认模型。oh-my-pi 内置60+ 供应商、上千个模型(Anthropic、OpenAI、Gemini、DeepSeek、Ollama 本地模型等),支持三种认证方式:oauth(账号登录)、plan(订阅计划)、local(本地推理,免 Key)。
常用的小技巧:
| 操作 | 说明 |
|---|---|
/model | 会话中随时切换当前模型 |
Ctrl+P | 在已配置模型间循环切换 |
--smol/--slow | 分别指定轻量快模型与深度推理模型 |
会话中它还会自动继承你已有的 Cursor、Claude Code、Copilot 等配置文件,无需迁移脚本。
5 分钟写出第一行修改
现在正式干活。进入你的项目目录,直接用自然语言下指令:
omp "把 src/utils.ts 里的 formatDate 函数加上时区参数,并保持向后兼容"接下来你会看到几个典型的 TUI 交互:
- 工具卡片:每次 read / grep / edit 都渲染成卡片,过程透明
- 编辑预览:修改先以"提案"形式展示,确认后原子落盘,失败自动回滚
- 主动提问:需求含糊时,Agent 用
ask工具弹出结构化选项让你点选,而不是瞎猜
想让它更仔细?在提示词里加一个词ultrathink,就会触发最高级别的深度推理。
改完之后,一行命令让第二个模型来帮你把关:
/review它会并行派出专门的评审子代理,扫描未提交改动,问题按 P0–P3 分级并给出"能否上线"的明确结论。
高频斜杠命令清单
| 命令 | 用途 |
|---|---|
/model | 切换模型 |
/login | 登录供应商账号 |
/review | 发起代码审查 |
/reload-plugins | 加载新写的扩展 |
? | 查看键盘快捷键 |
! | 直接执行 bash 命令 |
第二天继续开发:会话续接与记忆
oh-my-pi 的会话会自动保存,跨天开发不丢上下文:
omp --continue "接着昨天的改动继续" # 继续上一个会话 omp --resume # 打开会话选择器,按 ID 前缀恢复配合内置的记忆工具(retain/recall/learn),Agent 会把项目级事实写进记忆库,下次会话第一轮就能"认出"你的代码库。
去哪里看更多资料
- 📖 项目总览与全部功能演示:README.md
- 📖 完整 CLI 参数参考:docs/cli-reference.md
- 📖 各内置工具说明:docs/tools/edit.md
- 📦 核心 CLI 与 SDK 源码:packages/coding-agent/
- 📖 从源码运行开发版本:
bun setup && bun dev(流程见 README.md 的 Development 章节)
小结
到这里,你已经走完了 oh-my-pi 的核心闭环:安装 → 选模型 → 下指令 → 预览修改 → 审查 → 续接会话。它的设计哲学是"终端优先、功能全内置"——不需要的可以不碰,需要的都在箱子里。下一步建议用ultrathink跑一个稍大的重构任务,感受子代理并行和 LSP 重命名的完整体验。
【免费下载链接】oh-my-pi⌥ Coding agent with the IDE wired in项目地址: https://gitcode.com/GitHub_Trending/oh/oh-my-pi
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考