用途 cli-review 用于从本地代码检出运行 Greptile 代码审查,并把审查发现整理成简洁、可执行的摘要反馈给用户。它适合在开发过程中对当前本地分支做一轮自动化审查。
主要能力
- 仓库上下文确认:通过 git rev-parse --show-toplevel 定位仓库根目录;若失败,会提示必须从 Git 仓库运行审查。
- CLI 存在性检查:使用 command -v greptile 判断是否已安装;缺失时不自动安装,先请求用户许可,再给出 npm i -g greptile,若 npm 不可用则提供 curl -fsSL "https://greptile.com/cli/install" | sh 作为备选安装方式,安装后重新检查。
- 登录认证:通过 greptile whoami 检查账号;未认证时运行 greptile login,并等待用户完成登录流程再继续。
- 执行审查:优先运行 greptile review --json;当 JSON 输出不受支持或出现用法错误时,回退到 greptile review --agent。若两条命令均失败,不会隐藏原始错误,而是汇总失败命令和用户需采取的下一步操作。
- 结果汇总:解析 JSON 输出,报告审查状态、发现数量、按严重程度排序的问题(最高优先)、需要修改的文件以及建议的下一步命令或修复路径;纯文本输出时尽量保持相同结构,摘要保持简明,聚焦可操作项。
使用方式 从当前仓库根目录开始,依次执行上述检查、认证与审查命令;安装和登录环节需要用户确认或参与。
适用场景 适用于已使用 Git 管理代码、并希望借助 Greptile CLI 在本地获得代码审查结果的开发场景,尤其是需要在合并前快速查看高严重度问题和待修改文件时。
限制 需要本地存在 Git 仓库;需要安装 greptile CLI 并完成登录;安装需用户授权,不会自动执行;JSON 输出不可用时依赖 agent 模式;资料未提供审查语言支持范围、审查规则细节或运行时长等信息。