baz-cli

Baz CLI 是一个面向 AI 辅助人工代码审查的命令行工具，托管于 GitHub 仓库 baz-scm/baz-cli，并发布为 NPM 包 @baz-scm/cli。

用途该工具的目标是缓解代码审查成为开发瓶颈的问题。随着 AI 辅助编码加快开发速度，人工审查者仍需要审查每一项变更、理解上下文、捕捉边缘情况并保证质量，导致审查耗时较长。Baz CLI 通过 AI 引导，帮助审查者聚焦重要内容，快速略过次要部分。

主要能力根据官方资料，Baz CLI 的核心功能包括：

AI 引导的 PR 走查：由 AI 提供智能、上下文感知的导航，引导完成拉取请求审查。
阅读摘要、差异和公开评论：在一个界面中查看 PR 摘要、检查代码差异并查看所有已有评论。
创建评论、批准和合并：直接在 CLI 中执行操作，包括添加评论、批准 PR，以及准备就绪时进行合并。
集成模式专属能力：与工单系统（如 Jira、Linear、YouTrack）集成，查看相关工单以理解 PR 的完整上下文；提供规格评审，通过 AI 验证实现是否符合工单规格。

使用方式 Baz CLI 提供两种模式：

独立模式（自带密钥）：使用自己的 GitHub Personal Access Token（PAT）和 Anthropic token 直接审查任何拉取请求。此模式下无需 Baz 服务集成，数据保留在用户自己手中。
集成模式（Baz 体验）：连接 Baz 以获取完整功能，包括 AI 助手、规格评审、更好的上下文和全面代码审查。官方提到新用户可注册 14 天免费试用，无需信用卡。

环境要求与配置：

需要 Node.js 22 或更高版本。
独立模式需要 GitHub PAT 和 Anthropic token。GitHub 令牌的权限范围：Contents 需读写（用于合并 PR 和解决评论；若仅审查和批准，只读即可），Pull Requests 需读写（用于创建评论和批准 PR；若仅阅读 PR 内容，只读即可）。
集成模式需要 Baz 账户；可选集成 Jira、Linear、YouTrack 等以获取工单上下文。
模式检测逻辑：同时设置 GH_TOKEN 和 ANTHROPIC_TOKEN 时启用独立模式；两者均未设置时启用集成模式（需要 Baz 用户）；仅设置其中一个令牌时出错（独立模式要求两个令牌）。
环境变量在运行时读取，无需重新构建 CLI。
其他环境变量包括：BAZ_LOG_LEVEL（日志级别：fatal、error、warn、info、debug）、NODE_ENV（development、production）。

审查界面特性：

审查屏幕（评论、需求、聊天）会适配终端窗口。当评论、差异和对话无法同时显示时，内容区域滚动，输入框和提示保持在屏幕上。内容下方状态行显示可见范围，例如 ↑↓ lines 12-30 of 84。视图跟随新聊天输出，除非用户已向上滚动。
当有内容可滚动时，CLI 会请求终端鼠标支持以响应滚轮；此时终端自身的点击选择暂停，多数终端在按住 Option（macOS）或 Shift 时恢复。
颜色适配终端背景，检测使用 COLORFGBG，否则假定深色背景。
主题相关变量：BAZ_THEME（auto 默认、dark、light、none 禁用颜色）、BAZ_TERMINAL_BACKGROUND（dark/light 覆盖自动检测）、NO_COLOR（任意非空值禁用颜色）。
单个颜色可通过 BAZ_COLOR_* 变量覆盖，使用十六进制值或 none 保持未样式化。
主题文件按顺序检查：$BAZ_THEME_FILE、./.baz/theme.json、~/.baz/theme.json、~/.config/baz/theme.json。可用键包括 main、accent、text、success、warning、error、info、fileHeaderBg、fileHeaderFg、diffAddedBg、diffAddedFg、diffDeletedBg、diffDeletedFg、diffSelectedBg、diffSelectedFg、diffContextFg、lineNumberFg。环境变量优先于文件，文件中的非字符串值忽略，背景色不会在没有可读前景色的情况下使用。禁用颜色时，评论指向的行以粗体显示。

开发者相关：

克隆仓库并安装依赖。
可用脚本及开发工作流：创建 .env 文件进行本地配置；运行 npm run dev 进入监视模式；TypeScript 自动编译；变更后使用 npm run dev 测试；提交前运行 npm run lint:fix 和 npm run format:fix。
欢迎贡献，流程包括：从 main 分支创建分支、遵循代码风格、充分测试、提交附带清晰描述的 PR。
问题反馈：可在 GitHub 仓库打开 issue。

适用场景

限制

工具介绍