SageOx CLI
让不同编码智能体共享并延续团队上下文。
按维度查看评分与理由
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 是否启用存在冲突；在依赖发布质量信号前应核实该修订的实际工作流状态。
这个 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 有哪些优点和局限？
- 同一套共享上下文可用于 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？
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 明确上传。
常见问题
是否可以完全在本地或自有服务器运行共享历史？
默认会记录哪些内容？
秘密信息会如何处理？
.gitignore，非标准秘密格式仍可能漏检。断网或上传失败会丢失会话吗？
~/.cache/sageox/，ox doctor --fix 可在之后重试上传；缓存没有自动过期或清理机制。可以录制但暂不共享给团队吗？
ox config set session_publishing manual 后，停止的会话不会自动发布，直到明确运行 ox session upload。