快速开始
OpenAgere 是一个终端原生的 AI 编程代理。它可以检查项目、通过结构化补丁编辑文件、执行命令，并在权限明确的前提下协同完成工程任务。
安装
shell
npm i -g openagere
openagereHomebrew、直接下载和源码构建方式见安装 OpenAgere。
启动 TUI
在你希望 OpenAgere 理解的仓库目录中运行：
shell
cd path/to/your/project
openagere终端界面会打开一个聊天输入框。你可以用自然语言描述任务，OpenAgere 会收集上下文、提出操作、在允许时应用补丁，并总结变更。
第一次可以这样提问
text
解释这个仓库的结构。
找到创建用户的 API 路由，并说明校验流程。
给 CLI 增加 --verbose 参数，并更新文档。
修复 src/parser.rs 中失败的测试，并说明根因。好的提示词应包含清晰目标、已知模块或文件，以及你关心的约束。
工作循环
- 计划 — 对复杂请求拆解步骤。
- 检查 — 读取文件、搜索代码库、询问缺失上下文。
- 执行 — 通过结构化补丁编辑，并运行已批准的命令。
- 验证 — 在环境允许时运行定向测试或检查。
- 汇报 — 总结变更文件、验证结果和后续动作。
常用控制
| 按键或命令 | 作用 |
|---|---|
Enter | 提交提示词 |
Ctrl+C | 中断当前轮次 |
Ctrl+D | 正常退出 |
/model | 切换当前模型 |
/resume | 恢复历史会话 |
/compact | 压缩对话上下文 |
/init | 生成或更新仓库指令 |
/help | 查看帮助 |
一次性任务
脚本、CI 或快速分析可以使用 openagere exec：
shell
openagere exec "总结这个仓库并指出主要构建命令"
git diff HEAD~1 | openagere exec "为这个 diff 写一条简洁的提交信息"更多内容见无界面 Exec。
下一步
- 在配置中设置模型和默认项。
- 在安全模型中了解访问模式。
- 通过 MCP 集成连接外部工具。
- 用 Skills 与插件沉淀可复用工作流。