oh-my-pi 终端 AI 编程智能体入门教程：安装到跑通首次审查
【免费下载链接】oh-my-pi⌥ Coding agent with the IDE wired in. Built by Stencil Labs.项目地址: https://gitcode.com/GitHub_Trending/oh/oh-my-pi
oh-my-pi（命令名omp）是一个把 LSP、真实调试器等 IDE 级能力直接编进进程里的终端 AI 编程智能体。本文带你完成安装、认证，并走完一次真实改码加审查的完整流程，结束后你就能拿它处理自己的项目。
安装与验证
macOS、Linux、Windows 都支持，执行一行即可完成安装：
curl -fsSL https://omp.sh/install | sh也可以用包管理器：brew install can1357/tap/omp，或bun install -g @oh-my-pi/pi-coding-agent。装好后用一行确认环境可用：
omp --version💡 Alpine / musl 先
apk add libstdc++ libgcc；Windows 的 PowerShell 可直接跑irm https://omp.sh/install.ps1 | iex。执行omp completions zsh（bash、fish 同理）可生成补全，子命令与模型名都能补。
首次配置
在项目根目录直接运行omp，首次启动会拉起初始化流程：选供应商、登录或填 API Key、指定默认模型。Key 分三种：账号登录（oauth）、订阅计划（plan，面向 Cursor、GitHub Copilot）、本地推理（local，接 Ollama、LM Studio，无需 Key）。
如果你之前用过其他 AI 编程工具，无需迁移：.claude、.cursor、.codex、.github/copilot等八种已有配置会被自动识别并继承。
会话中途想换模型，输入/model；按Ctrl+P可直接跳到下一个已配置模型。
完成一次真实修改
进入项目目录，用自然语言下指令：
omp "把 src/utils.ts 里的 formatDate 函数加上时区参数，并保持向后兼容"模型每次读取、搜索、编辑都会以独立动作块呈现在屏幕上，思路可逐步追踪；需求含糊时，ask工具会弹出结构化选项让你点选。
改动先以(proposed)状态挂起，你确认后才原子落盘，中途失败会自动回滚。提示词里加上ultrathink，可以触发最高级别的深度推理。
改完输入/review，专门的评审子代理并行扫描未提交改动，发现项按 P0–P3 分级，结论直接告诉你能不能上线。
和普通终端 AI 工具的不同在哪
- LSP 参与写入链路：一次重命名会发出
workspace/willRenameFiles，关联的 re-export、桶文件、别名导入同步更新，LSP 操作共 14 个。 - 能驱动真实调试器：28 个 DAP 操作，lldb、dlv、debugpy 可直接挂断点单步，不再靠 print 猜。
- 代码执行状态常驻：
eval起持久 Python 与 Bun worker 内核，两者都能通过回环桥反向调用 Agent 自己的 read、search 工具。 - 搜索发生在进程内：ripgrep、glob、find 直接编进二进制，ls、sed、sort、jq 等 58 个命令行工具零 fork/exec 执行。
- 60+ 供应商、上千模型、9 个角色按意图派发，
/model随时可换。
高频命令速查
| 命令 / 快捷键 | 用途 |
|---|---|
/model | 为当前会话更换模型 |
Ctrl+P | 跳到下一个已配置模型 |
/review | 并行评审未提交改动，P0–P3 分级 |
Alt+A | 进入 Agent Hub 实时查看各子代理状态 |
/hotkeys | 列出当前构建的全部快捷键 |
omp --continue "接着改" | 继续上一个会话接着干 |
进阶技巧
会话续接：会话自动保存，omp --continue直接接着上次干；omp --resume弹出选择器，输入 ID 前缀即可恢复任意历史会话；加--fork能从指定旧会话派生新会话，两边互不干扰。
项目记忆：retain记录项目级事实，learn存放可跨会话复用的经验，recall按需取回。记忆默认按项目隔离，每次会话结束会压缩成摘要，在下次第一轮加载，Agent 立刻知道这个仓库长什么样。
下一步
核心 CLI 与 SDK 实现在 packages/coding-agent/。相关文档：
- docs/cli-reference.md：完整 CLI 参数与子命令参考
- docs/tools/：edit、lsp、task、web_search 等每个内置工具的独立说明
- docs/memory.md：记忆后端的配置与选型
- packages/coding-agent/：核心 CLI 与 SDK 源码
装好之后最值得试的一件事：挑一个稍大的重构任务，提示词带上ultrathink跑一遍，感受子代理并行与 LSP 重命名的完整体验。
【免费下载链接】oh-my-pi⌥ Coding agent with the IDE wired in. Built by Stencil Labs.项目地址: https://gitcode.com/GitHub_Trending/oh/oh-my-pi
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
