用途:为 Codex CLI 提供配置优化规则与追踪,适用于编辑 agents.md 或 agents/ 目录、咨询 Codex CLI 配置最佳实践,以及按本地版本整理更新日志。
主要能力:管理 config.toml、AGENTS.md、rules/、hooks.json、scripts/、skills/ 与 MCP 服务器等配置;按模型、行为、显示、Shell、Hooks、历史、功能、分析等类别整理设置;提供 hooks 使用规范与 AGENTS.md 设计准则;给出优化检查清单与已应用/待评估/不采用的优化记录;按本地版本抓取并分类 GitHub releases 变更。
使用方式:配置通过 Nix(programs.codex home-manager 模块)声明式管理,源文件位于 nix/home-manager/agents/codex-cli.nix 等,目标文件由激活脚本生成到 ~/.codex/。更新设置需编辑 codex-cli.nix 后重建。检测本地版本用 codex --version;抓取发布说明用 gh api repos/openai/codex/releases --jq '.[0:10]',再用 jq 按 rust-v<本地版本> 过滤。
限制:所有发布分析必须限定在本地已安装版本及以下,不得报告更新版本的功能。hooks 需先设 features.codex_hooks = true;当前 Codex 的 PreToolUse/PostToolUse 仅支持 Bash,PostToolUse 仅作反馈;不支持 permissionDecision 的 ask/allow、updatedInput、additionalContext 等字段。官方文档称 hooks 仍为实验性。AGENTS.md 只写人设与核心准则,避免工具专属语法。具体收费、平台与效果资料暂未提供。