Actívalo
- Hooks de sesión para Claude Code (el
.claude/settings.jsondel repositorio), Cursor (el.cursor/hooks.jsondel repositorio) y Codex (~/.codex/config.toml, en tu carpeta personal).--agents claude,cursorlimita cuáles, y--codex-config <path>apunta a otra configuración de Codex. - Dos hooks de git.
prepare-commit-msgañade un trailerKodus-Trace:a cada mensaje de commit, que vincula el commit con su sesión.pre-pushinicia la destilación en segundo plano. - Un ajuste de fetch para que un simple
git fetchtambién descargue las decisiones compartidas.
kodus trace status: sesiones y turnos capturados, decisiones (locales y compartidas), hooks instalados y cualquier problema que haya encontrado. Elimina los hooks con kodus trace disable (añade --dry-run para previsualizar). Desactivar elimina solo los hooks: las sesiones capturadas se quedan en tu máquina, y los eventos ya enviados a Kodus se quedan allí.
Qué se captura
Cada turno de una sesión de agente: el prompt y la respuesta, un resumen de una línea de cada herramienta que usó el agente, los archivos que leyó y modificó, sus comandos y el uso de tokens. Los registros viven en~/.kodus/sessions, fuera del repositorio, y se eliminan a los 90 días.
Antes de guardar o enviar eventos, el CLI enmascara los patrones de secretos que reconoce. El contenido capturado aún puede contener datos confidenciales. Mantén las credenciales fuera de las sesiones que capturas. Para dejar de capturar sesiones nuevas, ejecuta kodus trace disable.
La captura funciona sin cuenta.
Cuando has iniciado sesión con un login o una clave de equipo, el CLI también envía a Kodus los eventos con los secretos reconocidos enmascarados de cada sesión: los prompts y las respuestas, las herramientas que el agente llamó con sus entradas y salidas, los archivos leídos y modificados, los comandos, el uso de tokens, la rama, la URL del remoto de git y los ids de commit. Kodus los almacena para tu organización. Cuando una sesión termina, un modelo los lee para extraer decisiones, con el modelo BYOK de tu organización si lo tiene y con un modelo gestionado por Kodus en caso contrario. Estos eventos cuentan para las 1000 solicitudes por hora del equipo.
Cómo se generan las decisiones
Engit push, un job en segundo plano resume cada commit de tu rama que no está en la rama predeterminada. Luego le pide a un CLI de agente de programación de tu máquina que convierta esos resúmenes y las sesiones capturadas de la rama en decisiones. Usa el primero de claude, codex, gemini y cursor-agent que encuentre. Esa herramienta recibe los mensajes de commit, los nombres de archivo y los prompts y respuestas redactados de las sesiones, por lo que llegan a su proveedor como en cualquier otro uso de ella. Si no hay ninguna instalada, la captura sigue funcionando y no se escriben decisiones.
El job nunca retrasa ni hace fallar un envío. Escribe las decisiones en una rama llamada kodus/trace/v1 y envía esa rama al mismo remoto, de modo que el clon de un compañero las obtiene con git fetch. Cada envío reemplaza el registro de esa rama.
Lee las decisiones
Pasa las rutas que estás a punto de modificar. No hace falta ningún subcomando.--remote <name> elige el remoto cuya rama de decisiones se lee.
Cada decisión muestra:
- Tipo:
architectural_decision,convention,tradeoff,implementation_detail,toolinguother. - Origen:
humansi lo pediste tú,agentsi el agente lo eligió por iniciativa propia,collaborativesi lo resolvieron juntos. - Confianza, de 0 a 1, según se juzgó cuando se escribió la decisión.
- Alcance, las rutas a las que se aplica, y la fuente:
local(registrada aquí) obranch(compartida por otra persona). - Un id, el identificador para
forgetypin.
status, sepárala con --: kodus trace -- status.
Corrige el registro
Explora las sesiones
Variables de entorno
Relacionado
Agentes de IA
Skills y bucles para agentes de programación.
Referencia de Comandos
Todos los comandos de
kodus trace.