SpineCodex
基于 Spine 子任务树上下文编译的 Codex 发行版,面向长程编码,成本降低 32%–74%。
- Star 数
- ★ 151
- 最近更新
- 3 天前
- License
- Apache-2.0
- 主语言
- Rust
- FA 评分
- 37/100 · 缺口较多
30 秒速览
- 运行形态
- 可在哪里用
- 平台专用Codex · OpenAI API
- 费用
- 软件免费,模型调用费用自付
- 上手难度
- 低 · 几分钟可跑通
- 开始前需要
- 典型场景
- 需要跨多个里程碑完成大型重构、担心上下文被压平丢失子任务边界的工程师
- 不适合
- 不想复用已有 ~/.codex 配置、希望另建独立账号体系的团队
- 只需要短会话简单改代码、不关心上下文成本的用户
- 要求完全不产生任何模型调用费用的场景
- 官网
- arxiv.org/abs/2610.37224 ↗ 来自 GitHub 仓库设置
- 维护状态
- 近 30 天有提交最近提交 2026-11-18最新版本 v0.6.0(2026-11-19)
这个 Agent 能做什么,适合哪些场景?
SpineCodex 是 OpenAI Codex CLI 的开源独立发行版,把长程编码任务放进一棵持久工作树 SpineTree 中执行。Agent 在推理过程中用 Open、Close、Next、Spawn 四个轻量原语声明子任务边界:顺序子任务在当前会话内就地开闭,独立分支通过 Spawn 并行展开并回填到同一棵树。每次模型调用前,Spine 运行时把 SpineTree 编译成最小有效上下文——已完成的子任务折叠为返回结果,未完成的父级上下文逐字节保持不变,从而持续命中前缀缓存。它通过 npm 包 @spinejit/spine-codex 安装为全局命令行工具,直接复用已有的 ~/.codex 配置、凭据与技能;v0.6.0 跟踪上游 Codex 0.170.0。可选项 /experimental 可开启 Spinetree memory projection,把已关闭节点的记忆导出到 .codex/spinetree/ 以便检查。
SpineCodex 以终端 CLI 形式读取用户任务与本地代码库,驱动模型持续推理与执行工具调用。运行时维护 SpineTree:Agent 用 Open 与 Close 标记子任务进入与结束,用 Next 推进顺序步骤,用 Spawn 并行派生独立分支并把结果返回到同一棵树中。在每次模型请求之前,编译前端按“最内层子任务先完成”的顺序,把已关闭分支折叠为简洁的返回结果,而保持其之前的父级上下文完全不变,以复用 prompt 缓存。TUI 中内置斜杠命令(如 /experimental),启用后可将 closed-node memory 投影导出到 .codex/spinetree/ 目录。
- 需要跨多个里程碑完成大型重构、担心上下文被压平丢失子任务边界的工程师
- 在 SWE-Milestone、ProgramBench 一类长程基准上评估编码 Agent 成本效益的研究者
- 希望在不改代码、只替换启动命令的前提下试用 Codex 增强版的现有 Codex CLI 用户
- 需要在同一任务中并行探索若干独立方案、并统一回收结果的开发者
- 关注单请求输入 token 与总花费、想量化对比历史压缩或递归子 Agent 方案的团队
安装与配置要点
摘自下方的安装和使用说明,以项目 README 的最新说明为准。
- 安装 / 启动命令
npm install -g @spinejit/spine-codex@latest
- 配置文件
~/.codex
如何安装或部署这个 Agent?
需要 Node.js 与 npm 环境,并准备好可用的 ~/.codex 配置与凭据(SpineCodex 直接继承)。
npm install -g @spinejit/spine-codex@latest安装完成后即可在终端运行 spine-codex。
如何使用这个 Agent?
在项目目录中直接启动,首次使用前确认 ~/.codex 中已有可用的凭据与技能配置。
spine-codex进入 TUI 后像使用 Codex 一样描述任务;Agent 会在推理中自行声明 Open / Close / Next / Spawn 子任务边界。若想检查已关闭节点的记忆投影,可在 TUI 内执行:
/experimental启用后导出文件位于 .codex/spinetree/ 目录。
这个 Agent 有哪些优点和局限?
- 以子任务树而非线性历史做上下文编译,README 称总成本相对原生 Codex 降低 32.4%(GPT-5.6 Sol)与 37.9%(Grok 4.6)
- 顺序子任务在当前会话内就地开闭,只有独立分支才用 Spawn,避免了为每个子任务起子 Agent 的交接与等待开销
- 父级上下文逐字节保留以复用 prefix cache,同时把已完成分支折叠,兼顾缓存命中与上下文精简
- 直接继承现有 ~/.codex 配置、凭据和技能,一条 npm 全局安装命令即可运行
- 跟踪上游 OpenAI Codex 版本(v0.6.0 对应 0.170.0),并以 Apache-2.0 开源,附有 arXiv 论文与消融实验
- 核心运行依赖 OpenAI Codex 生态与 ~/.codex 配置,本质上是特定上游发行版而非通用 Agent 框架
- 成本与通过率数据来自论文自述的三套基准(SWE-Milestone、ProgramBench、FrontierSWE),尚无第三方独立复现
- 版本号仍处于 0.x,发布节奏紧跟上游 Codex,升级可能带来行为变化
- 关键机制(Open/Close/Next/Spawn 的编译规则)需要理解论文与运行时语义才能调优,存在学习成本
- 需要网络访问模型 API,本地离线无法使用
这个 Agent 与同类方案有什么区别?
README 明确对比了三类替代方案:原生 OpenAI Codex(在 SWE-Milestone 上平均输入 token/请求 -45%、总成本 -32.4%);递归子 Agent 委派方案(总成本 -73.7%,且 19 对 17 个里程碑解决);以及历史压缩/折叠类上下文管理方案(分数提升 14.8%–16.7%,成本降低 22.7%–58.1%)。同作者还提供面向 Pi 与 DeepSeek Harness 的 Spine 插件,可作为非 Codex 运行时的替代路径。
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| SpineCodex 当前 | 37 · 缺口较多 | 命令行工具免费 + 模型费 | ★ 151 | 3 天前 | Rust | Codex · OpenAI API |
| Crewplane | 76 · 存在缺口 | 命令行工具免费 + 模型费 | ★ 56 | 4 天前 | Python | Codex · Claude Code |
| GraphCode | 53 · 缺口较多 | 桌面应用免费 + 模型费 | ★ 159 | 2 天前 | Swift | ChatGPT · Codex · Claude Code |
| mu 编程助手 | 72 · 存在缺口 | 桌面应用免费 + 模型费 | ★ 614 | 2 天前 | TypeScript | — |
FollowAgents 如何评估这个 Agent?
查看各维度的扣分理由
证据显示这是 Codex 的衍生发行版,README 声称继承 ~/.codex 的凭据与配置,但未说明权限最小化、审批流程或数据流向;docs/sandbox.md 仅外链官方文档,未在本仓库内给出具体边界。imagegen 技能对 CLI 回退要求用户确认、不覆盖已有资产,属于局部亮点,但整体权限与确认机制依赖上游且未在本仓库说明,故仅给 1。回滚机制在样本中完全缺失(0)。来源归属较好:LICENSE 为 Apache-2.0,README 明确上游 OpenAI Codex 与 NOTICE 归属,给 2。
README 与 docs/install.md 存在明显不一致:安装文档仍指向 openai/codex 仓库克隆,而非本仓库;版本号在 README 中同时出现 v0.5.1 演示与 v0.6.0 说明,自洽性偏弱(1)。依赖可用性方面 package.json 固定了 pnpm/node 版本与 resolutions,但未说明 npm 包与 Rust 构建的对应关系,仅给 1。失败信息在 bwrap 与 app-server 中有部分明确报错,但整体未系统化,给 1。
README 对长周期编码场景与基准有较清晰描述,受众与场景可辨识(2)。但能力边界主要靠论文与外部链接支撑,仓库内未给出 Spine 原语的具体约束或禁用条件(1)。触发精度方面技能描述较精确(如 imagegen、review-agent 的适用/不适用),但主产品触发条件未说明(1)。环境适配仅列出 macOS/Ubuntu/WSL2 与内存要求,未覆盖 Windows 原生或容器场景(1)。
信息架构有 README、docs、skills 分层,但 docs 多为外链占位,结构偏薄(1)。安装说明存在且给出系统要求,但克隆地址错误削弱可信度(1)。命名稳定性方面包名与版本号基本一致,但 README 版本叙述混杂(1)。示例与 FAQ 仅有基准表格与少量命令,缺少常见问题(1)。已知局限完全缺失(0)。许可证完整且为 Apache-2.0(2)。版本与变更日志有 Recent Releases 与发布说明链接(2)。维护责任列出两位维护者与 Issues 渠道,但发布者身份未经验证(1)。
输出可用性方面 README 给出安装命令与 TUI 演示,但缺少具体使用示例与输出样例(1)。边际价值依赖论文基准,仓库内未提供可复现的对比脚本或数据(1)。成本收益仅有 README 声称的 32%-74% 降本与基准表,缺少本地可验证的成本核算(1)。
声明可追溯性方面 README 引用 arXiv 编号与基准名称,但仓库内无对应数据文件(1)。交叉佐证方面技能与源码样本可部分印证产品形态,但基准与成本声明无仓库内佐证(1)。事实与推断分离方面 README 将论文结论与产品声明混排,未标注哪些为实测、哪些为引用(1)。
- 源码中未见:回滚或恢复路径运行前先备份,或在 git 分支、快照上操作,确保改动可以撤销。
- README 声称继承 ~/.codex 的凭据与配置,但仓库内未说明权限范围、审批策略与数据流向,使用前应自行审查沙箱与网络配置。
- docs/install.md 的克隆地址指向 openai/codex 而非本仓库,按此文档构建可能得到上游而非本发行版。
- 基准与降本数据(32%-74%)仅来自论文引用,仓库内无可复现脚本或数据,不应直接作为选型依据。
- 发布者身份未经验证,维护责任与更新路径需自行核实。
- 样本中未见回滚或恢复机制说明,涉及外部副作用的操作需谨慎。
最近版本
来自该项目 GitHub Releases 的最新发布记录,说明为上游原文摘录,未经本站改写或测试。
-
v0.6.0 0.6.0
发布说明摘录
Allow the native Intel Mac release build six hours on Codex 0.170 On rehearsal 44296720357 five native builds passed. The Intel runner canceled its still-running rustc at the four-hour deadline. Give that matrix entry the hosted six-hour budget, preserving compiler flags, artifact content and package verification. --- Upstream Codex compatibility: 0.170.0 Upstream Codex baseline: rust-v0.170.0 Upstream Codex commit: 29eb79e9866b3262a777fdf8195c1b9e63684c91 --- SpineCodex 0.6.0 SpineCodex now tracks OpenAI Codex rust-v0.170.0 at commit …在 GitHub 查看 ↗ -
v0.5.1 0.5.1
发布说明摘录
chore(release): prepare SpineCodex 0.5.1 --- Upstream Codex compatibility: 0.164.0 Upstream Codex baseline: rust-v0.164.0 Upstream Codex commit: 6aaac694803004a63c6f393d153c96d22521a6b9 --- SpineCodex 0.5.1 This patch restores the local startup policy used before automatic managed-daemon startup was introduced. - Local new, resume and fork sessions passively discover a compatible Spine app-server. When none is available, they start the embedded app-server from the current CLI. - Invocation overrides, including --profile, keep their configuration in the embedded app-server. …在 GitHub 查看 ↗ -
v0.5.0 0.5.0
发布说明摘录
Fix Spine task pressure to follow committed sampling checkpoints --- Upstream Codex compatibility: 0.164.0 Upstream Codex baseline: rust-v0.164.0 Upstream Codex commit: 6aaac694803004a63c6f393d153c96d22521a6b9 --- SpineCodex 0.5.0 Updates the upstream Codex baseline to 0.164.0 (rust-v0.164.0, commit 6aaac694803004a63c6f393d153c96d22521a6b9). - Adapt Spine sampling, recursive spawn, history persistence and TUI integration to the new upstream APIs, including compressed rollout readers and typed context metadata. …在 GitHub 查看 ↗
常见问题
我需要单独配置 API Key 吗?
Spine 与“给每个子任务开一个子 Agent”有什么实质差别?
成本数据在什么条件下测得?
spinetree 记忆投影会改动我的仓库吗?
.codex/spinetree/ 下,供检查使用。升级上游 Codex 会影响我的使用吗?
SpineCodex 官网是什么?
SpineCodex 免费吗?
SpineCodex 开源吗?
SpineCodex 安全吗?
SpineCodex 还在维护吗?
SpineCodex 是谁开发的?
谢谢反馈,我们会据此改进页面。