SpineCodex

基于 Spine 子任务树上下文编译的 Codex 发行版,面向长程编码,成本降低 32%–74%。

Star 数
★ 151
最近更新
3 天前
License
Apache-2.0
主语言
Rust

30 秒速览

运行形态
命令行工具
可在哪里用
平台专用Codex · OpenAI API
费用
软件免费,模型调用费用自付
上手难度
低 · 几分钟可跑通
开始前需要
Node.js(npm 全局安装)位于 ~/.codex 的 OpenAI Codex 配置(~/.codex 凭据)Shell / 命令行网络访问本地文件系统
典型场景
需要跨多个里程碑完成大型重构、担心上下文被压平丢失子任务边界的工程师
不适合
  • 不想复用已有 ~/.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/ 目录。

  1. 需要跨多个里程碑完成大型重构、担心上下文被压平丢失子任务边界的工程师
  2. 在 SWE-Milestone、ProgramBench 一类长程基准上评估编码 Agent 成本效益的研究者
  3. 希望在不改代码、只替换启动命令的前提下试用 Codex 增强版的现有 Codex CLI 用户
  4. 需要在同一任务中并行探索若干独立方案、并统一回收结果的开发者
  5. 关注单请求输入 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?

FollowAgents 源码审查 · FARS-2.1
缺口较多
37/ 100 五分制 1.9 / 5
信任安全 10/29
可靠稳定 5/14
适用触发 8/18
规范维护 7/18
有效结果 4/13
证据核验 3/8
查看各维度的扣分理由
信任安全10 / 29 · 1.7/5

证据显示这是 Codex 的衍生发行版,README 声称继承 ~/.codex 的凭据与配置,但未说明权限最小化、审批流程或数据流向;docs/sandbox.md 仅外链官方文档,未在本仓库内给出具体边界。imagegen 技能对 CLI 回退要求用户确认、不覆盖已有资产,属于局部亮点,但整体权限与确认机制依赖上游且未在本仓库说明,故仅给 1。回滚机制在样本中完全缺失(0)。来源归属较好:LICENSE 为 Apache-2.0,README 明确上游 OpenAI Codex 与 NOTICE 归属,给 2。

可靠稳定5 / 14 · 1.8/5

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。

适用触发8 / 18 · 2.2/5

README 对长周期编码场景与基准有较清晰描述,受众与场景可辨识(2)。但能力边界主要靠论文与外部链接支撑,仓库内未给出 Spine 原语的具体约束或禁用条件(1)。触发精度方面技能描述较精确(如 imagegen、review-agent 的适用/不适用),但主产品触发条件未说明(1)。环境适配仅列出 macOS/Ubuntu/WSL2 与内存要求,未覆盖 Windows 原生或容器场景(1)。

规范维护7 / 18 · 1.9/5

信息架构有 README、docs、skills 分层,但 docs 多为外链占位,结构偏薄(1)。安装说明存在且给出系统要求,但克隆地址错误削弱可信度(1)。命名稳定性方面包名与版本号基本一致,但 README 版本叙述混杂(1)。示例与 FAQ 仅有基准表格与少量命令,缺少常见问题(1)。已知局限完全缺失(0)。许可证完整且为 Apache-2.0(2)。版本与变更日志有 Recent Releases 与发布说明链接(2)。维护责任列出两位维护者与 Issues 渠道,但发布者身份未经验证(1)。

有效结果4 / 13 · 1.5/5

输出可用性方面 README 给出安装命令与 TUI 演示,但缺少具体使用示例与输出样例(1)。边际价值依赖论文基准,仓库内未提供可复现的对比脚本或数据(1)。成本收益仅有 README 声称的 32%-74% 降本与基准表,缺少本地可验证的成本核算(1)。

证据核验3 / 8 · 1.9/5

声明可追溯性方面 README 引用 arXiv 编号与基准名称,但仓库内无对应数据文件(1)。交叉佐证方面技能与源码样本可部分印证产品形态,但基准与成本声明无仓库内佐证(1)。事实与推断分离方面 README 将论文结论与产品声明混排,未标注哪些为实测、哪些为引用(1)。

风险与缓解建议
  • 源码中未见:回滚或恢复路径运行前先备份,或在 git 分支、快照上操作,确保改动可以撤销。
  • README 声称继承 ~/.codex 的凭据与配置,但仓库内未说明权限范围、审批策略与数据流向,使用前应自行审查沙箱与网络配置。
  • docs/install.md 的克隆地址指向 openai/codex 而非本仓库,按此文档构建可能得到上游而非本发行版。
  • 基准与降本数据(32%-74%)仅来自论文引用,仓库内无可复现脚本或数据,不应直接作为选型依据。
  • 发布者身份未经验证,维护责任与更新路径需自行核实。
  • 样本中未见回滚或恢复机制说明,涉及外部副作用的操作需谨慎。
证据充分度:低 评估于 2026年11月20日 审查版本 d90a466a10c7
查看完整评分方法 →
你是这个项目的维护者?把 FARS 徽章加到 README

徽章显示当前的评审分数和结论,点击回到本页。重新评审后约一小时内更新。

FARS

[![FARS 评测](https://followagents.com/badge/spinecodex.svg?lang=zh)](https://followagents.com/zh/agents/spinecodex)
<a href="https://followagents.com/zh/agents/spinecodex"><img src="https://followagents.com/badge/spinecodex.svg?lang=zh" alt="FARS 评测"></a>

最近版本

来自该项目 GitHub Releases 的最新发布记录,说明为上游原文摘录,未经本站改写或测试。

  1. 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 查看 ↗
  2. 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 查看 ↗
  3. 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 吗?
通常不需要。SpineCodex 会继承你现有的 ~/.codex 配置、凭据与技能,只要该配置本身可用即可启动。
Spine 与“给每个子任务开一个子 Agent”有什么实质差别?
顺序子任务通过 Open / Close / Next 在当前会话内就地完成,只有相互独立的分支才用 Spawn 并行派生;README 称相比递归子 Agent 委派总成本降低 73.7%。
成本数据在什么条件下测得?
来自 arXiv:2610.37224,覆盖 SWE-Milestone(GPT-5.6 Sol 与 Grok 4.6)、ProgramBench(50 个任务)和 FrontierSWE(10 个开放式任务,每个 5 次试验);实际节省取决于任务结构与模型。
spinetree 记忆投影会改动我的仓库吗?
该功能默认关闭,需要在 TUI 执行 /experimental 后才启用,导出文件写在 .codex/spinetree/ 下,供检查使用。
升级上游 Codex 会影响我的使用吗?
SpineCodex 以跟踪上游基线的方式发布(v0.6.0 对应 Codex 0.170.0),升级时建议查看对应版本的 release notes 再切换。
SpineCodex 官网是什么?
SpineCodex 的 GitHub 仓库填写的官网是 https://arxiv.org/abs/2610.37224。这个链接由仓库作者设置;源码在 GitHub(GhabiX/SpineCodex)。
SpineCodex 免费吗?
软件本身免费,但 SpineCodex 要调用 AI 模型,模型的调用费用由你向模型服务商支付(也可以接本地模型)。
SpineCodex 开源吗?
开源。源码在 GitHub(GhabiX/SpineCodex),许可证是 Apache-2.0。
SpineCodex 安全吗?
FollowAgents 的 FARS 评审(2026年11月20日)给 SpineCodex 的“信任与安全”打了 10/29 分。评审没有在源码和文档里找到这些安全措施:回滚或恢复路径。接入真实账号或数据前:运行前先备份,或在 git 分支、快照上操作,确保改动可以撤销。
SpineCodex 还在维护吗?
在维护。GitHub 上最近一次提交是 2026-11-18,在最近 30 天内。最新版本是 v0.6.0(2026-11-19)。
SpineCodex 是谁开发的?
SpineCodex 由 GitHub 账号 GhabiX 发布。FollowAgents 没有核实这个账号背后是哪个人或公司。
这页内容对你有帮助吗?
在 GitHub 查看 ↗ 安装 ↓

所属宿主生态

对比同类 Agent

用同一套 FARS 评审,横向比较这个 Agent 所属的短名单。

相关核心概念