codex-executor
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
Antigravity Codex Bridge
让 Antigravity 理解需求、提出方案并验收,由本机 Codex CLI 独立审核,通过后执行任务。
接入桥接的业务项目中,执行和子 agent 都属于 Codex:Antigravity 不用自己的原生子 agent、命令或写文件工具代做。需要细分时,由 Codex 会话调用自己的原生 spawn_agent 并汇总结果。桥接启动时显式启用 features.multi_agent=true,不覆盖用户的原生子线程数量配置;这与多个独立顶层 Codex 任务是两件事。维护本桥接仓库自身时,Antigravity 可以直接修改、测试和上传代码,无需经 MCP 派发;见 仓库约定。
这是一个 Windows 优先的本地 stdio MCP 服务,不需要 npm 运行依赖,也不复制 Codex 登录凭证。默认启用完整文件系统/命令网络访问和实时联网搜索,适用于你信任的本机项目;不要接到不可信工作区或远程公开端口。
能解决什么
后台提交后立即返回,Antigravity 可以继续正常对话,不用反复调用模型查询进度。
新任务默认不限累计执行时长;
timeout_seconds设为0同样不限时,设为不小于 30 的整数可指定秒数。宿主的 MCP 请求超时与后台执行时限分开配置。一个事项对应一个 Codex 会话;保留 job、topic、session 身份,重启后找回并继续,不从头重派。
开始执行、原生会话建立、文件变更、测试/构建/提交阶段、容量等待和结束时,通过可选的原生 Sidecar 向原聊天推送关键变化;不是逐行刷日志。
后台进程观测暂不可用或文件监听失效时,继续托管已启动命令,不因状态查询失败重启任务。长时间托管和观测退化给出有限状态提示;进程存活不代表业务有进展,宿主接受通知也不代表用户已看到。
返回 Codex 原生聊天链接,可查看已保存的任务、工具过程和最终回复;标题使用具体执行任务。
默认在宿主机当前用户环境完整访问并启用
web_search="live",普通派发不提供沙箱选择;用户明确要求隔离时须先在本地配置启用。支持多个项目独立注册、同工作树独立事项不限数量并行、同会话防重复执行和受控容量续跑。模型默认继承你的 Codex 配置,也可以指定账号可用的模型 ID 或本机别名;不自动换模型。
规划方案是可调整的技术建议;Codex 在用户授权与审核边界内自行纠正、实现和验证,关键证据无法取得或需改变用户边界时才交回讨论。
可配置执行难度档位 simple/standard/complex/expert(极难),并独立配置日常/量化审核角色;越界或不可用模型明确报配置错误,不计业务失败、不自动换型号。
所有模型统一普通模式,启动层关闭 Fast;可配置仅审核模型名单,在审核时强制只读沙箱,并禁止进入执行阶段。
日常与量化方案可分别配置审核模型,执行模型单独保留。只要求方案审核时使用
review_only=true,通过后返回意见,不自动实施。同一未完成事项自上次可核验进展后失败 3 轮或连续 3 轮无可核验进展时交人工;取得有证据的进展或完成验收时清零,审核通过或换方案不清零。
Related MCP server: codex-antigravity-mcp
环境
Windows、Node.js 22+、PowerShell 7。
已安装并登录的 Codex CLI。开发验收使用 Codex 0.164.0;其它版本需要自行验证兼容性。
Antigravity 支持本地 MCP。自动回执另外依赖该产品版本提供 Sidecars 和
agentapi。Codex VS Code 扩展与 CLI 使用同一本机历史目录。SSH/WSL 中另一套历史不能用本机链接代替。
快速配置
先克隆仓库,并指定你的真实源码目录、外部运行目录和 Codex 程序路径。下面是占位示例,必须替换路径:
git clone https://github.com/XX-Trader/antigravity-codex-bridge.git
cd antigravity-codex-bridge
pwsh -NoProfile -File scripts/Setup.ps1 --project 'C:/work/my-project' --data 'C:/codex-runtime/my-project' --codex 'C:/tools/codex.exe' --pwsh 'C:/Program Files/PowerShell/7/pwsh.exe'默认只预览,不写配置。确认你接受该项目的完整执行权限后,再加:
pwsh -NoProfile -File scripts/Setup.ps1 --project 'C:/work/my-project' --data 'C:/codex-runtime/my-project' --codex 'C:/tools/codex.exe' --pwsh 'C:/Program Files/PowerShell/7/pwsh.exe' --apply --trust-full-access脚本合并本服务的 MCP 条目、定向工具 hook 和项目规则引用,保留其它服务及项目说明。运行数据放在你指定的外部目录,不要求特定盘符。已有项目的数据目录不允许悄悄换掉;迁移应先保留完整运行单元。
需要自动完成通知时,再提供已安装 Antigravity 的原生语言服务路径:
pwsh -NoProfile -File scripts/Setup.ps1 --project 'C:/work/my-project' --data 'C:/codex-runtime/my-project' --codex 'C:/tools/codex.exe' --pwsh 'C:/Program Files/PowerShell/7/pwsh.exe' --agentapi 'C:/path/to/Antigravity/resources/bin/language_server.exe' --apply --trust-full-access安装后在 Antigravity 刷新 codex-executor,并重新载入项目规则。脚本不会重启应用、取消后台任务或修改 Codex 全局配置。旧进程仍使用启动时的代码,不能把文件更新当成已热加载。
完整参数、手动配置和回滚见 配置说明。项目编排规则正文只有一份:Antigravity 项目说明。
常用工具
新事项同时提供用户原文 user_request 和规划建议 prompt,后续用户说明用 user_followup 逐字追加。首轮由 Codex 独立只读核查真实代码、日志和工具结果,返回审核依据与允许实施的范围;桥接核对输入版本后在同一原生会话自动执行。后续方案续接原 topic/session,由 Codex 结合上下文自行核查,不再每次额外启动独立审核轮次。回执以 context_review 引用历史审核,plan_review.status=context 表示复用上下文,不表示新方案已经通过。
审核结果缺失、版本不符、没有成功核查记录、原文缺失或没有明确范围时,任务停在 review_needs_evidence;技术方案需修订时为 review_revise。规划端在原事项提供修订后的 prompt,有真实审核上下文时可直接续接,也可用 review_followup={review_job_id, response} 逐项回应。仅审核模式或缺少可复用上下文时仍须独立审核。若涉及用户目标、明确约束、验收或授权变化,仍须真实用户决定,通过既有 plan_decision 续接。执行中新证据推翻假设时暂停受影响操作,修订后续接原会话自行核查,保留已完成部分。
plan_review 记录输入 SHA-256、执行者的依据、allowed_scope 和状态;它是协议门禁和执行者判断,不是操作系统沙箱,也不能证明依据内容一定正确。完整访问下的只读核查仍由 Codex 遵守;桥接发现审核中的文件变更事件会暂停,但不能识别所有 shell 命令的副作用。审核通过不代替测试、运行回读或业务验收。
工具 | 用途 |
| 提交一个具体事项;默认后台返回, |
| 重启后按项目找回最近任务 |
| 查看当前项目的原生会话摘要和聊天链接 |
| 领取原回执,或查看最后已落盘进度; |
| 一次等待既有任务完成,不重新提交 |
| 只取消该任务拥有的子进程,不回滚源码改动 |
topic 应是“修复播放器切集失败”这样的实际任务,而不是“Codex 执行者”。首次新事项的会话建立事件带有原生聊天链接,不必等到最终回执;常规进度、同事项续接和通知恢复只留本地,不反复唤醒模型或刷聊天。通知正文保留本地时间、项目/短事项、具体结果或所需操作和一个详情链接,默认最多三行;用户选择完整展示。把 chat.vscode_uri 展示给用户;chat=null 不代表失败,也不是重复提交的理由。
通知有持久化事件编号和独立投递状态。accepted 仅表示宿主 API 接受,不能冒充用户已看到;发送前已知失败为 not_sent,可有限退避和重启补送;结果不明为 uncertain,先核对原生收件记录,不盲目重发。codex_list / codex_result 的 notification 显示待投递、未知结果及通知进程状态。
同一工作树不设固定任务数上限,也不为独立任务排队。同一 topic_id / Codex 会话仍禁止同时启动两轮,避免同一事项被重复执行。强关联、重叠改动或前置依赖先问用户选择独立 worktree 还是等待;切分支本身不是共享目录的隔离。Git 暂存、提交和集成由协调者串行安排,文件归属靠派发范围和差异回读,不宣称操作系统级隔离。机器资源和上游服务限额仍客观存在。
codex_list(active_only=true, cwd=当前项目) 可列出全部活动任务;默认最近20项只是历史展示长度,不限制同时运行的数量。
扩展可能不在历史侧栏列出 exec 来源的会话,本项目提供准确会话 ID 的打开入口,不伪造来源或编辑 Codex 数据库。链接路由依赖扩展版本;聊天内容是 Codex 已保存、允许展示的历史,不包含未公开的内部推理。progress 是最后落盘事件,不是实时心跳。
验证
纯协议/安装器测试不调用模型,不需要 Codex 登录,也不连接业务数据库:
pwsh -NoProfile -Command 'npm test'测试使用外部临时目录。需要指定存储位置时,先设置 CODEX_EXECUTOR_TEST_ROOT 和 CODEX_EXECUTOR_PWSH。开发者自己的存储规范优先,测试不固定写入某个盘符。
注册检查不发起模型任务:
pwsh -NoProfile -Command 'node scripts/verify.cjs --config C:/path/to/mcp_config.json'显式加 --smoke 或 --write-smoke 才会调用真实 Codex,可能消耗账号额度;不要在同一项目已有任务运行时启动测试。单元测试、原生协议验证、Antigravity 的真实通知/界面验收是不同层级,不能互相替代。
可对已有任务做一次本地通知策略检查,不重新执行 Codex,也不在聊天中产生测试回执:
pwsh -NoProfile -Command 'node scripts/verify.cjs --config C:/path/to/mcp_config.json --notification-check --receipt JOB_ID'回读该事件的本地投递记录,预期为 suppressed。它不唤醒聊天或模型,不展示内部编号,不代表真实聊天收发验收已通过。正常结果通知应说明具体完成内容、剩余事项或需要用户作出的选择,不能用状态、代号或“通知已收到”代替。
要在原 Antigravity 聊天中实际验收多个 Codex 并行,可把 --notification-check 换成 --parallel-check。它明确请求 Antigravity 连续提交三个独立只读项目核查;每个任务读取文件并短暂等待20秒,以观察执行区间重叠。三是本次验收样本数,不是运行上限。该模式会调用真实 Codex 和 Antigravity、消耗额度,不修改业务文件或提交代码。应先确认当前 MCP 已加载新版,再执行一次,保留事件和任务编号,不重复派发。
--subagent-check 则派发一次原生子 agent 验收:父 Codex 必须真正启动并等待子 agent 读取项目说明,返回原生子 agent ID;应核对实际 spawn/wait 事件,不只相信最终文字。注册名不同时可用 --server NAME 指定已有 MCP 服务。
边界
完整访问仍受当前系统账号、网络和上游服务权限约束;项目注册和串行锁不是安全沙箱。
completed只表示 CLI 正常结束,仍需核对命令、输出、测试和用户验收条件。方案拒绝与执行策略受阻分开报告:
execution_blocked保留已确认方案,不表示方案失败,也不因后续诊断完成而解除。拒绝后不自动重试或换入口规避;同事项续接区分只读诊断、不受阻工作和正常授权/策略修复后的恢复,见执行策略受阻。完整访问不取消内核命令检查,未知拒绝原因不能凭报错猜测。精确的模型容量错误才会同模型、同会话续跑;脚本等待,不用模型轮询,不从头重放未知副作用。
运行记录不自动按年龄删除。未知文件、仍需续接的任务和唯一证据不能当缓存清理。
不上传凭证、私人工作区路径、任务日志、回执或安装回滚状态。见 安全说明。
依据:Antigravity MCP、Hooks、Sidecars、Rules、Codex App Server、Codex 联网搜索。
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Sync coding-agent sessions and resume them in any other agent: Claude Code, Codex, Cursor, more.
Shared long-term memory & Stop-hook task handoff across Claude Code, Codex, Cursor, and mobile.
Your AI apps as one team: hand work to Codex or Claude Code on your Mac, with a shared logbook.
Use your Mac, Windows or Linux computer from ChatGPT, Claude or Codex: files, commands, documents.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceLets Codex delegate coding and repository work to an installed Claude Code CLI with permission-aware inspect/write access, model and effort selection, resumable and cloud-attached sessions, and durable synchronous or asynchronous jobs.MIT
- AlicenseNot gradedqualityBmaintenanceEnables Codex users to delegate engineering, refactoring, auditing, and test execution tasks to Google Antigravity CLI as a persistent autonomous subagent, with tools for managing sessions and running prompts.1MIT
- AlicenseBqualityCmaintenanceEnables a local Codex chat to ask a second opinion, review staged, unstaged, or revision-based diffs, and delegate coding tasks to the Antigravity CLI running in isolated or disposable workspaces. Supports starting, polling, retrieving, and cancelling tasks with returned answers, diffs, changed-file lists, exit codes, and time/output limits, while never auto-applying returned patches.81MIT
- AlicenseNot gradedqualityBmaintenanceEnables Codex and Claude Code to connect over an authenticated local HTTP endpoint to a logged-in Antigravity CLI, allowing shared workspace-authorized task execution and result handling without opening the Antigravity IDE.777 npm7MIT