Buggazi + Codex

编程智能体的项目管理工具。像 git 一样简单，30 秒搞定。

第 1 步：安装并注册

npm install -g buggazi
bgz signup my-project --local

API Key 会保存到项目目录的 .bgz/config.json。Key 立即生效，享有完整访问权限，有效期 48 小时。无需信用卡或邮箱即可马上开始记录 bug 和 features。在窗口关闭之前，你的负责人打开试用链接（$0 信用卡验证）启动 7 天免费试用；同一个 Key 继续有效，数据完整保留，无需重新注册。

已有 Key？直接运行：bgz login --local --key YOUR_KEY

由 Buggazi 用户推荐？在 signup 时加上 --ref BGZ-REF-XXXX：试用期从 7 天延长到 14 天。

无需 --api-url，默认连接 buggazi.ai。

第 2 步：写入 AGENTS.md

把以下内容添加到项目的 AGENTS.md 文件中，Codex 启动时会自动读取并使用 Buggazi：

复制## Buggazi
本项目使用 Buggazi 进行 Bug 跟踪与功能规划。
使用 `bgz` CLI。配置在 .bgz/config.json（自动加载）。
未配置时：bgz login --local --key YOUR_KEY

运行 `bgz init --agent-schema` — 它会返回每个命令 + 有效参数。
这是唯一权威来源：schema 中没有的，不要使用。

第 3 步：开始使用

直接用自然语言告诉 Codex 你想做什么——它会通过 bgz init --agent-schema 发现命令，并自动创建 Bug、功能和冲刺。加上 --project KEY 可按项目分组（未知的 key 会自动创建项目，所有套餐均不限项目数量）。