Detección de agentes

Cuando ejecutas varios agentes a la vez, no puedes vigilar cada terminal: cada nodo debe avisarte cuándo te necesita y dónde está trabajando, para que puedas actuar en lugar de supervisarlo constantemente. TermTree lo hace reconociendo las CLI de agentes que se ejecutan en una terminal: actualmente funciona con Claude Code y también detecta Codex, aunque la terminal de un nodo no tiene por qué ejecutar ningún agente; es simplemente un shell normal que TermTree también puede reconocer cuando ejecuta uno.

Indicador de worktree

Un agente que entra en un git worktree cambia allí su propio directorio de trabajo y, a partir de ese momento, comunica las rutas —en su salida, en un seguimiento de pila, en git status— relativas a la raíz de ese worktree, no al directorio del shell del panel. Si pierdes de vista en qué worktree se encuentra un agente, puedes acabar revisando la copia equivocada de un archivo, por lo que TermTree lo muestra automáticamente.

Cuando TermTree detecta que el agente en primer plano de una terminal está trabajando dentro de un git worktree, muestra un icono de worktree en ese nodo y en la barra de título de la terminal. Pasa el cursor sobre el icono para ver el nombre de la rama del worktree.

El indicador se conserva después de reiniciar: si vuelves a abrir TermTree, un nodo cuyo agente estaba en un worktree seguirá mostrándolo.

No disponible en Windows nativo. La detección de worktrees depende de la resolución de rutas de estilo POSIX, por lo que no funciona en un shell nativo de Windows. Tampoco está disponible a través de los límites de WSL, que ocultan al host el directorio de trabajo del agente; en ese caso, TermTree utiliza como alternativa el directorio indicado por el shell.

Reanudar una sesión de Claude

Pulsa Cmd+Shift+R / Ctrl+Shift+R con un nodo seleccionado para reanudar su sesión de Claude Code (claude --resume); resulta útil si la terminal se cerró o si quieres volver a una conversación sin escribir de nuevo el comando para reanudarla. Consulta Persistencia de sesiones para saber cómo esto también ocurre automáticamente al reiniciar la aplicación.

Cómo sabe TermTree que un agente te está esperando

El estado INPUT (punto naranja) significa que un agente está bloqueado, esperando tu respuesta. TermTree lo detecta de dos maneras:

  • Claude Code — detección definitiva. TermTree registra un hook de Notification en ~/.claude/settings.json e inyecta un TERMTREE_NODE_ID en el entorno de cada terminal. Cuando Claude emite una notificación (por ejemplo, para solicitar permiso para una llamada a una herramienta), TermTree sabe con certeza qué nodo necesita tu atención: no lo deduce a partir del texto de la terminal.
  • Otras CLI — alternativa mediante coincidencia de patrones. Para los agentes que no disponen de integración mediante hooks, TermTree examina la salida de la terminal en busca de patrones habituales de solicitudes bloqueantes (como confirmaciones del estilo [y/N]) para deducir que la terminal está esperando una entrada.