oh-my-pi 快速上手:从安装 AI 编程智能体到写出第一行修改
2026/9/8 19:44:22 网站建设 项目流程

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 交互:

  1. 工具卡片:每次 read / grep / edit 都渲染成卡片,过程透明
  2. 编辑预览:修改先以"提案"形式展示,确认后原子落盘,失败自动回滚
  3. 主动提问:需求含糊时,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),仅供参考

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询