Codex Auto 依赖 Bun、Codex CLI、CodeGraph 和 Matt Pocock skills。请按顺序安装;CLI 安装、Codex 接线和仓库初始化是不同步骤。
以下命令适用于 macOS 和 Linux。
curl -fsSL https://bun.com/install | bash
bun --version如果当前终端仍找不到 bun,请新开终端或按安装器提示更新 PATH。
curl -fsSL https://chatgpt.com/codex/install.sh | sh
codex --version在目标仓库运行 codex,然后选择 ChatGPT 登录或其他可用的认证方式。
先安装 CLI,再把 MCP 接到全局 Codex 配置:
curl -fsSL https://raw.githubusercontent.com/colbymchenry/codegraph/main/install.sh | sh
codegraph install --target codex --location global --yes
codegraph --version完成 MCP 配置后重启 Codex。codegraph install 只负责连接 Codex,不会为仓库建立索引。
使用 Bun 的 package runner 把 skills 安装到 Codex:
bunx skills@latest add mattpocock/skills --skill '*' --agent codex --global --yes
bunx skills@latest list --global --agent codex --json这一步只安装 skills。setup-matt-pocock-skills 是仓库级配置流程,不是 shell 安装命令。
cd /path/to/target-repository
codegraph init
codex-auto doctor然后在该仓库的 Codex 对话中调用 $setup-matt-pocock-skills。它会配置 issue tracker、triage labels 和 domain docs;只需在首次使用 Matt engineering skills 前运行,或在这些选择发生变化时重新运行。
当前里程碑从源码安装:
git clone <codex-auto-repository-url>
cd codex-auto
bun install
bun link
bunx skills@latest add . --skill auto --agent codex --global --yes回到目标仓库执行 codex-auto doctor,所有必需项应为 ok。
# Bun;Homebrew 或 Scoop 安装者请使用对应包管理器
bun upgrade
# Codex 官方安装器也负责更新现有安装
curl -fsSL https://chatgpt.com/codex/install.sh | sh
# 用官方安装器覆盖为最新稳定版
curl -fsSL https://raw.githubusercontent.com/colbymchenry/codegraph/main/install.sh | sh
# 更新全局 skills
bunx skills@latest update --global --yes升级 CodeGraph 后通常不必重新初始化仓库。如果 Codex 不再显示 CodeGraph MCP,重新执行 codegraph install --target codex --location global --yes 并重启 Codex。Matt skills 的日常升级不需要重新运行 $setup-matt-pocock-skills。
升级 Codex Auto 源码安装:
cd /path/to/codex-auto
git pull --ff-only
bun install
bun link
bunx skills@latest add . --skill auto --agent codex --global --yes最后验证:
bun --version
codex --version
codegraph --version
bunx skills@latest list --global --agent codex --json
codex-auto doctor