SageOx CLI
让不同编码智能体共享并延续团队上下文。
- 源仓库
- sageox/ox
- Star 数
- ★ 67
- 最近更新
- 今天
- License
- MIT
- 主语言
- Go
- FA 评分
- 71/100 · 存在缺口
30 秒速览
- 运行形态
- 可在哪里用
- 通用 · 跨平台Codex · Claude Code
- 费用
- 有免费版，另有付费云服务
- 上手难度
- 低 · 几分钟可跑通
- 开始前需要
- 典型场景
- 同时使用 Claude Code 和 Codex CLI 的开发团队，希望新会话能够直接继承另一智能体先前形成的决策与工作记录。
- 不适合
- 需要完全自托管或本地账本的团队，共享历史只能存放在 sageox.ai
- 禁止会话数据离开本机或上传到第三方云的组织
- 需要按会话精细控制可见范围、或要求缓存自动过期的团队
- 源码审查
- 71/100 · 存在缺口
这个 Agent 能做什么，适合哪些场景？
SageOx CLI（ox）是一款用 Go 构建的开源命令行工具，用于在不同编码智能体、机器和团队成员之间保存并复用项目上下文。它通过 .sageox/ 将代码仓库关联到团队，并由 ox agent prime 把约定、安全要求、架构决策和历史会话注入新的智能体会话。工具会记录提示、智能体回复、工具调用及其输出，先写入 ~/.cache/sageox/，再同步到由 sageox.ai 托管的团队共享 Git 历史，其中内容使用 LFS blob 存储。用户可以通过 ox query 检索历史，通过 ox murmur 发送协作信号，并用 ox plan enrich、ox plan render 和 ox code insights辅助实施规划。它支持多种编码智能体，但当前没有自托管或纯本地账本，因此采用时需要接受 sageox.ai 作为共享历史的部署边界。
ox init 在代码仓库中创建 .sageox/ 并将项目关联到团队；ox agent prime 在编码开始前载入团队约定、决策和历史会话。会话捕获会记录用户提示、智能体回复、执行的命令、读取或写入的文件以及工具输出；秘密信息会在本地扫描并替换为 [REDACTED_*] 标记。记录先进入 ~/.cache/sageox/，随后同步到 sageox.ai 上的团队共享历史；离线或上传失败时会保留缓存，并可由 ox doctor --fix 重试。用户可运行 ox query "..." 查询跨智能体和跨机器的历史，使用 ox murmur "..." 发出实时协作信息，或通过 ox plan enrich、ox plan render 和 ox code insights生成带有既有决策、代码热点和潜在冲突信息的规划材料。ox config 管理录制与发布策略，ox session start、ox session stop 和 ox session upload则提供手动控制。
- 同时使用 Claude Code 和 Codex CLI 的开发团队，希望新会话能够直接继承另一智能体先前形成的决策与工作记录。
- 分布在多台机器上的工程师，需要查询某项架构决策由谁提出、在什么会话中讨论以及已有何种实现背景。
- 多人并行修改同一代码库时，希望通过
ox murmur和规划增强功能发现文件冲突、既有方案及模块负责人。 - 准备实施计划的技术负责人，希望把近期团队讨论、历史会话和代码热点纳入
ox plan enrich的结果。 - 希望自动保存编码智能体对话，同时要求常见凭据在离开本机前被扫描和脱敏的团队。
- 需要审查录制边界的组织，可将捕获改为手动或禁用自动录制，并将会话发布设为手动。
如何安装或部署这个 Agent？
macOS 或 Linux 可运行 brew install sageox/tap/ox。macOS、Linux 或 FreeBSD 也可运行 curl -sSL https://raw.githubusercontent.com/sageox/ox/main/scripts/install.sh | bash。贡献者可执行 git clone https://github.com/sageox/ox.git && cd ox，再运行 make build && make install，但该方式构建的是测试较少且不会自动更新的最新源码。安装后用 ox version 验证。首次使用需要可访问 sageox.ai 的网络环境和 SageOx 账户。
如何使用这个 Agent？
进入目标 Git 仓库后依次运行：ox login 登录 sageox.ai；ox init 创建 .sageox/；git add .sageox/ && git commit -m "initialize SageOx" 提交项目配置；ox doctor 检查安装；ox status 查看认证、项目、同步和守护进程状态。编码智能体会话开始时运行 ox agent prime 载入团队上下文。初始化后的新会话默认自动录制，可用 ox query "查询内容" 检索历史或用 ox murmur "消息" 协调工作。运行 ox config 可交互选择 auto、manual 或 disabled 录制模式；若不希望停止会话后自动发布，可执行 ox config set session_publishing manual，之后通过 ox session upload 明确上传。
这个 Agent 有哪些优点和局限？
- 同一套共享上下文可用于 Claude Code、Codex CLI、Gemini CLI、Droid、OpenCode、Amp、Pi、Aider、Goose 等多种编码智能体，降低团队切换工具时的上下文割裂。
- 不仅保存总结，还记录提示、回复、工具调用、文件路径和差异，为后续查询提供较完整的实施过程。
- 上传前在本地扫描常见云密钥、服务令牌、私钥、连接字符串、认证头和 JWT，并使用脱敏标记替换。
- 支持离线缓存及失败后的
ox doctor --fix重试，也提供录制模式与发布模式两套独立控制。 - 除历史检索外，还提供
ox murmur、计划增强和代码热点或争用洞察，覆盖并行开发中的协调需求。
- 当前没有自托管或纯本地账本；共享历史必须托管在 sageox.ai，企业自托管也尚不可用。
- 自动录制默认开启，并会捕获智能体对话中的命令、文件访问和输出；团队需要在采用前评估数据治理要求。
- 会话捕获不遵循
.gitignore，非标准格式的秘密信息可能避开现有脱敏规则，因此不应让智能体读取不希望被记录的凭据文件。 - 已录制会话对有权访问共享历史的团队成员可见；除了完全关闭该会话的录制外，没有更细粒度的单会话隐私控制。
- 本地缓存没有 TTL 或自动清理机制，已同步的会话也不会因执行
ox uninstall而从服务器删除。 - 各智能体的成熟度并不一致：Claude Code 是主要且测试最充分的目标，而 Cursor、Windsurf、Cline、Copilot 和 Kiro 的会话录制仍标为计划中。
这个 Agent 与同类方案有什么区别？
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| SageOx CLI 当前 | 71 · 存在缺口 | 命令行工具免费版 + 付费版 | ★ 67 | 今天 | Go | Codex · Claude Code |
| Portable Handoff | 84 · 表现良好 | 命令行工具免费 | ★ 23 | 2 个月前 | Python | Codex · Claude Code |
| claude-replay | 76 · 表现良好 | 命令行工具免费 | ★ 854 | 6 天前 | JavaScript | Codex · Claude Code |
| LeanCTX 上下文智能层 | 75 · 表现良好 | 命令行工具免费 + 模型费 | ★ 3.9k | 1 天前 | Rust | Codex · Claude Code · OpenAI API · Claude API |
FollowAgents 如何评估这个 Agent？
查看各维度的扣分理由
README 详细披露了会捕获提示、回复、工具调用、文件路径、差异和输出，说明本地缓存、sageox.ai 托管账本、团队可见范围、默认自动录制以及发布设置，数据流透明度充分。用户级配置优先且可选择 manual 或 disabled，CI 权限也限制为 contents: read；但自动录制和默认自动发布并非逐次确认，disabled 仍允许手动启动。敏感信息在上传前进行本地模式匹配脱敏，但文档明确承认不遵循 .gitignore、非标准秘密可能漏检且缓存无 TTL。依赖版本明确，GitHub Actions 使用提交哈希固定，不过依赖面很大，材料未提供漏洞扫描、更新策略或 go.sum。远程上传等外部影响有清楚说明，但已同步会话不能通过卸载删除，回滚能力有限。MIT 版权主体和开源鸣谢路径提供了基本归属信息；发布者身份仍未获企业注册表验证，材料也未完整展示第三方归属清单。
README 声称 ci.yml 已禁用且仅文档和冒烟工作流活跃，但同时提供的 .github/workflows/ci.yml 是完整启用的构建、测试和 lint 工作流，形成明显的版本内矛盾，因此自洽性仅给薄弱分。依赖与构建入口清晰，并覆盖 Linux、macOS、FreeBSD 和部分 Windows 测试，但核心共享历史依赖 sageox.ai，且没有自托管或本地账本替代。README 描述离线缓存、重试、doctor/status 诊断，集成脚本也给出明确通过、失败和跳过消息；不过没有提供主要命令实现来全面审查错误传播。
材料明确面向人类与多种编码代理协作，列出查询、会话捕获、协调、规划和专家加载等场景，并逐项区分已发布与计划支持，受众与边界说明充分。配置优先级、用户覆盖仓库和团队设置、录制与发布的不同 manual 语义均有明确说明。不同代理的触发机制列得较清楚，coworker 测试也使用领域描述触发；但自主触发测试需要可选的真实 Claude 运行和额外强化系统提示，不能充分证明普通环境中的精确触发。多平台安装和多代理适配较广，但 Claude Code 被明确标为主要、测试最充分的目标，其他环境的等价成熟度证据不足。
README 信息架构清晰，包含安装、快速开始、数据捕获、配置、兼容性和贡献说明；安装路径、验证命令及源码构建风险均交代充分。命令和配置命名总体稳定，但 session_recording 与 session_publishing 都使用 manual，需要专门警告避免混淆。示例和常见问题式说明丰富，限制也坦率披露，包括无自托管、无缓存 TTL、无细粒度会话隐私和 .gitignore 不生效。完整 MIT 文本支持满分。版本方面仅见发布徽章和升级命令，未提供变更日志或兼容性政策。SageOx Inc.、项目 issue 路径和贡献流程表明维护入口，但未列具体维护者、响应承诺或治理机制。
CLI 命令、状态诊断、结构化测试产物和多代理入口使输出具备普通使用价值，但材料未展示真实查询结果、上下文质量控制或错误检索的处理方式，故未给满分。跨代理、跨机器共享持久上下文相较单次会话具有明确增量价值，并覆盖召回、协作和计划增强。成本与控制有所说明，包括本地缓存、自动上传和关闭选项；但持续记录完整会话、强制使用托管服务、无限期本地缓存以及团队范围可读带来隐私、存储和运营成本，材料未量化这些权衡。
关键产品主张多数能映射到具体命令、配置键、架构或参考文档路径；CI 文件和集成测试也为构建门禁及 coworker 加载提供交叉证据。README、工作流和测试脚本之间形成部分佐证，但此次材料缺少核心实现文件、脱敏模式文件、go.sum、测试结果及被链接文档，且 CI 启用状态存在矛盾。材料通常能区分已发布、计划中和当前限制，不过演示性价值主张与实际验证仍有混合，自主使用测试也依赖额外提示，因此事实与推断分离并不彻底。
- 默认会自动录制并发布完整代理对话；部署前应将 session_recording 和 session_publishing 明确设为符合团队政策的值。
- 脱敏仅依赖模式匹配且不遵循 .gitignore；不要让代理读取不希望上传的 .env、凭据文件或非标准秘密。
- 已同步会话不能通过 ox uninstall 删除，团队又缺少细粒度的单会话访问控制；采用前应确认服务器端保留、删除和成员访问政策。
- 共享账本必须托管在 sageox.ai，当前没有自托管或纯本地方案；应评估服务中断、供应商依赖和数据驻留要求。
- README 与所提供工作流对 CI 是否启用存在冲突；在依赖发布质量信号前应核实该修订的实际工作流状态。
最近版本
来自该项目 GitHub Releases 的最新发布记录，说明为上游原文摘录，未经本站改写或测试。
-
发布说明摘录
[0.25.0] - 2026-10-27 See how team context shaped each session in your status line and the new ox brief, meet Oxy in Codex and the Claude desktop app, and get sessions from worktrees, resumed conversations and commits into your Ledger again. New - See how team context shaped your session, in the status line — Claude Code's status line now shows ● ox 3 discussions · 1 plan · 2 used: the team context your AI coworker was given, how much of it changed the work, and ● rec while the session records. In the Claude desktop app the same line appears above the prompt. ox doctor a …在 GitHub 查看 ↗ -
发布说明摘录
[0.24.2] - 2026-10-21 Amp orb sessions now reach your team whole and on their own, Oxy can join you in Claude Code, and plan reviews, approvals and saves reliably reach your team. New - Amp orb sessions reach your team on their own — in an Amp orb, ox records each thread and uploads it on its own, credited to the owner of SAGEOX_TOKEN. Every Amp session now starts with the prompt that opened its thread, and a reply sent after the orb went idle is recorded as a continued session. …在 GitHub 查看 ↗ -
发布说明摘录
[0.23.0] - 2026-10-12 Bring past AI coworker sessions into your Ledger, find recorded conversations, and give your AI coworker a screen walkthrough it can read. New - Import past Claude Code and Codex sessions — ox session import lets you preview sessions in the terminal or a local browser, choose what to share, and upload them to your team's Ledger. Sessions already imported or recorded by ox are skipped. - Find recorded conversations by keyword, person, and date — ox conversation search returns matching passages you can open in context. …在 GitHub 查看 ↗
常见问题
是否可以完全在本地或自有服务器运行共享历史？
默认会记录哪些内容？
秘密信息会如何处理？
.gitignore，非标准秘密格式仍可能漏检。断网或上传失败会丢失会话吗？
~/.cache/sageox/，ox doctor --fix 可在之后重试上传；缓存没有自动过期或清理机制。可以录制但暂不共享给团队吗？
ox config set session_publishing manual 后，停止的会话不会自动发布，直到明确运行 ox session upload。