antigravity-codex-patch

English | 한국어 | 中文

这是一个仅适用于 macOS 的 CLI，用于修补 Antigravity IDE，让 OpenAI Codex extension 能够稳定启动本地 Codex app server。

为什么需要它

在某些 Antigravity IDE 环境中，Codex extension 可能会一直停留在加载状态。常见原因有两个：

• Antigravity 的 argv.json 需要启用 OpenAI extension 使用的 proposed API：openai.chatgpt
• extension 可能需要指向一个可正常工作的系统 codex 可执行文件，而不是使用内置二进制文件

这个工具会安全地应用这两个修复，并提供备份和回滚。

快速开始

pnpm dlx antigravity-codex-patch doctor
pnpm dlx antigravity-codex-patch apply

运行 apply 后，请重启 Antigravity IDE。也可以让工具自动重启：

pnpm dlx antigravity-codex-patch apply --restart

命令

antigravity-codex-patch doctor [--json]
antigravity-codex-patch apply [--dry-run] [--restart] [--codex-path <path>] [--json]
antigravity-codex-patch rollback [--backup <dir>] [--json]

该包也提供较短的命令名：

pnpm dlx --package antigravity-codex-patch ag-codex-patch doctor

apply 会修改什么

apply 会确保 ~/.antigravity-ide/argv.json 包含以下配置：

{
  "enable-proposed-api": ["openai.chatgpt"]
}

它还会确保 ~/Library/Application Support/Antigravity IDE/User/settings.json 指向一个可工作的 Codex CLI：

{
  "chatgpt.cliExecutable": "/opt/homebrew/bin/codex"
}

Codex CLI 路径会从 PATH、/opt/homebrew/bin/codex、/usr/local/bin/codex 自动检测。你也可以手动指定：

pnpm dlx antigravity-codex-patch apply --codex-path /opt/homebrew/bin/codex

安全性

• apply 会在 ~/.antigravity-ide/backups/ 下创建带时间戳的备份
• rollback 默认恢复最新备份
• --dry-run 可以在不写入文件的情况下查看计划修改
• 写入前会解析 JSON/JSONC 文件
• 多次运行 apply 是安全的，不会添加重复项

本地开发

pnpm install
pnpm check
pnpm pack

许可证

MIT