开启
- 会话钩子:Claude Code(仓库的
.claude/settings.json)、Cursor(仓库的.cursor/hooks.json)和 Codex(~/.codex/config.toml,位于您的主目录)。--agents claude,cursor可限定安装哪些,--codex-config <path>可指向另一个 Codex 配置。 - 两个 git 钩子:
prepare-commit-msg会在每条提交信息中添加Kodus-Trace:trailer,把提交与其会话关联起来;pre-push会在后台启动提炼。 - 一项 fetch 设置,使普通的
git fetch也能拉取共享的决策。
kodus trace status 查看它做了什么:已捕获的会话和轮次、决策(本地和共享)、已安装的钩子,以及遇到的任何问题。用 kodus trace disable 移除钩子(加 --dry-run 预览)。禁用只会移除钩子:已捕获的会话仍保留在您的机器上,已发送到 Kodus 的事件也仍保留在那里。
捕获的内容
代理会话的每一轮:提示词和响应、代理所用每个工具的一行摘要、读取和修改的文件、执行的命令,以及 token 用量。记录保存在~/.kodus/sessions 下,位于仓库之外,90 天后删除。
CLI 会在保存或发送事件前遮蔽它识别出的密钥模式。捕获的内容仍可能含有敏感数据。请勿在捕获的会话中包含凭据。要停止捕获新会话,请运行 kodus trace disable。
捕获无需账户即可使用。
当您使用登录或团队密钥登录时,CLI 还会把每个会话遮蔽了可识别密钥的事件发送给 Kodus:提示词和响应、代理调用的工具及其输入和输出、读取和修改的文件、命令、token 用量、分支、git remote URL 和提交 id。Kodus 会为您的组织存储这些内容。会话结束时,模型会读取它们来提取决策:如果您的组织有 BYOK 模型,则使用该模型,否则使用 Kodus 托管的模型。这些事件计入团队每小时 1,000 次请求的限额。
决策如何生成
执行git push 时,后台任务会对您分支上不在默认分支中的每个提交生成摘要。随后它会请求您机器上的一个编码代理 CLI,把这些摘要和该分支已捕获的会话提炼成决策。它会使用找到的第一个 claude、codex、gemini 和 cursor-agent。该工具会收到提交信息、文件名以及会话中经过脱敏的提示词和响应,因此这些内容会像该工具的任何其他使用方式一样发送给其提供商。如果一个都没有安装,捕获仍然有效,但不会写入决策。
该任务不会延迟或使推送失败。它会把决策写入名为 kodus/trace/v1 的分支,并将该分支推送到同一个 remote,因此队友的克隆通过 git fetch 就能获取它们。每次推送都会替换该分支的记录。
读取决策
传入您即将修改的路径即可,不需要子命令。--remote <name> 用于选择读取哪个 remote 的决策分支。
每条决策会显示:
- Type:
architectural_decision、convention、tradeoff、implementation_detail、tooling或other。 - Origin: 如果是您要求的则为
human,代理自行选择的则为agent,双方共同敲定的则为collaborative。 - Confidence,0 到 1,为写入决策时的判断。
- Scope(适用的路径)和 source:
local(在本地记录)或branch(由他人共享)。 - 一个 id,即
forget和pin所用的标识。
status,请用 -- 分隔:kodus trace -- status。
修正记录
浏览会话
环境变量
相关内容
AI 代理
面向编码代理的技能和循环。
命令参考
所有
kodus trace 命令。