Cómo saber qué está haciendo tu agente de IA mientras programa
Lo que hace un agente de IA mientras programa se ve en el plan que escribe antes de tocar nada, en la transcripción mientras trabaja y en git cuando acaba, que es lo único que no se apoya en lo que el agente cuente de sí mismo. En un repositorio que no conozco empiezo en modo plan, le doy una rama por encargo y miro el git diff antes de aceptar. Para varias sesiones a la vez está agenttrail, que lo enseña en el navegador, aunque todavía es una alfa.
Modo plan y permisos en Claude Code
En modo plan, Claude Code lee ficheros, lanza comandos para explorar y escribe un plan, pero no edita tu código hasta que lo apruebas. Entras con Mayús+Tab, poniendo /plan delante de una petición o arrancando con claude --permission-mode plan. Para que un proyecto arranque siempre así, pon permissions.defaultMode en "plan" dentro de su .claude/settings.json. Cuando el plan está listo te pregunta si sigue en automático, si apruebas cada edición a mano o si sigue planificando. Antes de contestar puedes abrirlo en tu editor con Ctrl+G y corregirlo.
El plan es uno de los modos de permisos, que deciden qué hace Claude sin preguntarte:
| Modo | Qué hace sin preguntarte |
|---|---|
Manual (default) |
Solo leer |
acceptEdits |
Leer, editar ficheros y comandos de ficheros habituales como mkdir, mv o cp |
plan |
Leer, y los comandos que apruebe el clasificador cuando el modo automático está disponible |
auto |
Todo, con un segundo modelo revisando las acciones en segundo plano |
bypassPermissions |
Todo, y está pensado solo para contenedores y máquinas virtuales aisladas |
Desde la versión 2.1.283 (la de hoy, 3 de noviembre, es la 2.1.317), las sesiones de terminal y de VS Code arrancan en automático, con ese segundo modelo, el clasificador, revisando las acciones en tu lugar. Quien quiera ver cada paso tiene que arrancar con claude --permission-mode default o fijar permissions.defaultMode en su ~/.claude/settings.json.
Cuando además el repositorio ajeno es público, Code Wiki de Google genera su documentación por secciones, que viene muy bien para entender el código antes de soltarle un agente encima.
Ctrl+O, /diff y /rewind con el agente trabajando
Ctrl+O abre el visor de la transcripción, con el detalle de cada herramienta que usa el agente y la hora y el modelo de cada mensaje (está en la referencia del modo interactivo). Es lo más parecido a mirar por encima del hombro. Si ves que se va por donde no es, Esc lo para a mitad de turno sin perder lo que ya hizo.
/diff enseña los cambios del árbol de trabajo sin salir de Claude Code, con cada fichero tocado y sus líneas añadidas y quitadas. Su vista por turno solo recoge lo que Claude edita con sus herramientas. Un cambio hecho con un comando de shell aparece únicamente en la del árbol completo.
/rewind, o Esc dos veces con la entrada vacía, vuelve a un punto anterior de la sesión. Deshace los cambios en los ficheros que Claude ya había editado, también los que luego les hizo un comando de shell, pero un fichero que solo tocó la shell no se rastrea y se queda como está. Tampoco recoge las ediciones de otras sesiones abiertas a la vez ni, salvo un caso, las de los subagentes. Los checkpoints sirven para recuperar algo rápido dentro de la sesión, mientras que el historial sigue siendo cosa de git.
Sandbox y aprobaciones en Codex
Codex separa el sandbox, que fija dónde puede escribir y si tiene red, de la política de aprobación, que fija cuándo te pregunta (lo detalla su página de aprobaciones y seguridad). En la CLI y en la extensión del editor arranca sin red y escribiendo solo dentro de la carpeta de trabajo. Al abrir una carpeta con control de versiones propone el preajuste Auto (--sandbox workspace-write --ask-for-approval on-request), y en una que no lo tiene, solo lectura. Incluso en Auto, la carpeta .git queda en solo lectura.
Durante la sesión tienes /permissions para pasar de Auto a solo lectura y al revés, /plan para que proponga un plan antes de ponerse, /diff para ver el diff de git con los ficheros que git todavía no sigue, /review para que revise el árbol de trabajo y /status para ver el modelo, la política de aprobación y las carpetas en las que puede escribir. Todos están en su lista de comandos.
Una rama por encargo y el diff antes de aceptar
Git enseña lo que cambió en el disco, lo cuente o no el agente. Con una rama por encargo, su trabajo queda aparte del resto y descartarlo es borrar esa rama:
git switch -c agente/nombre-del-encargo
# ... el agente trabaja ...
git status
git diff --stat
git diff
git diff --staged
git log -p
git switch -c crea la rama y se cambia a ella. git status enseña también los ficheros nuevos, que es donde salen los que el agente creó sin avisar. git diff --stat resume qué ficheros cambian y cuántas líneas, y si esperabas dos ficheros y salen catorce, ya sabes por dónde empezar. Luego git diff da el detalle de lo que no está preparado para el commit y git diff --staged el de lo que sí. Cuando el agente hace commits por su cuenta, git log -p enseña cada uno con su parche. Todo está en la documentación de git diff, git log y git switch.
OpenAI dice que Codex trabaja mejor así, en una rama y con git status limpio antes de delegar, porque sus parches se aíslan y se deshacen más fácil. Los tests conviene lanzarlos tú, en esa rama y en tu máquina, aunque el agente diga que ya pasan.
Verlo en vivo con agenttrail
Agenttrail lee la actividad que los agentes de programación dejan en tu máquina y la enseña en el navegador, sin lanzarlos, aprobar acciones ni decidir cuándo algo está terminado. Lo de este apartado sale de su README y de su documentación, sin haberlo instalado para esta entrada.
Tiene dos vistas que se instalan por separado. Agenttrail Map enseña la estructura del proyecto, qué componentes están cambiando y las sesiones, y arranca con npx agenttrail dentro del repositorio. Para el mapa completo de componentes necesita un PLAN.md con una convención suya, que prepara npx agenttrail init. Ese paso sí escribe en tu repositorio: toca CLAUDE.md y AGENTS.md, crea el plan, ofrece hooks de Claude Code y añade .agenttrail/ al .gitignore. En modo no interactivo lo da todo por bueno, por lo que init es mejor dejarlo para cuando sepas qué ficheros va a tocar.
Agenttrail Kitchen es la vista experimental en 3D, una cocina con un cocinero por cada responsabilidad del proyecto, un plato por cada tarea que el agente se apunta y una cinta por la que sale la tarea dada por terminada. Va en la línea de las oficinas virtuales de agentes, con muñecos encima de sesiones que ya tienes. Arranca con npx agenttrail-kitchen ., pide Node.js 20 o superior y un navegador con WebGL, y se abre en localhost:4780. Con --example al final carga un ejemplo guionizado que no necesita ningún agente. Seis cocineros pueden ser una sola sesión, y un plato entregado solo indica que el agente marcó la tarea como hecha. Que esté publicada hay que comprobarlo aparte.
Esto es lo que dice el README sobre cada agente en Kitchen:
| Herramienta | Cómo se conecta | Estado según el README |
|---|---|---|
| Codex (CLI y escritorio en local) | Lee los registros de sesión locales | Probado con sesiones reales |
| Claude Code | Lee los registros locales y admite hooks opcionales | Probado con sesiones reales |
| Cursor | Hooks que instalas desde «Connect agents» | Pasan los tests del adaptador, falta validarlo en vivo |
| VS Code | Se lanza en su terminal integrada, sin extensión | Acompañante en el navegador |
| Otras | Solo cambios de ficheros | Solo observación de ficheros |
Por defecto busca los registros en ~/.codex/sessions y ~/.claude/projects, de modo que una sesión en la nube sin registros en tu máquina no aparece. Los dos servicios escuchan solo en 127.0.0.1, sin cuenta, telemetría ni llamadas a modelos. Map sí puede enseñar trozos de comandos y guarda actividad en ~/.agenttrail, así que antes de compartir una captura mira qué sale en ella.
La licencia es MIT: puedes usarlo, modificarlo y meterlo en un proyecto comercial conservando el aviso de copyright (las de otros repositorios de IA de código abierto están en otra entrada). Kitchen sigue en la 0.1.0-alpha.3, publicada en npm el 9 de septiembre, y el repositorio no ha vuelto a cambiar desde ese día. Windows no está validado y Map todavía no entiende las listas de tareas nuevas de Claude (TaskCreate y TaskUpdate). Con las dos vistas abiertas a la vez hay además dos fallos reconocidos en la página de cómo observa: la actividad de Map puede pisar la lista de tareas de Kitchen, y al configurar sus hooks Map puede tomar por suyo uno de Kitchen. Para fiarte de esa lista, Kitchen va mejor sola.
Con un agente y un encargo pequeño, el plan, la rama y el diff ya enseñan todo lo que cambia. Una vista como esta aporta bastante más con dos o tres sesiones en el mismo repositorio, porque te ahorra ir de terminal en terminal para saber cuál toca qué. Aceptar o no un cambio se sigue decidiendo sobre el diff.
Deja un comentario