Consapevolezza degli agenti

Quando esegui più agenti contemporaneamente, non puoi controllare ogni terminale: ogni nodo deve segnalarti quando ha bisogno di te e dove sta lavorando, così puoi intervenire invece di sorvegliarlo continuamente. TermTree lo fa riconoscendo le CLI degli agenti in esecuzione in un terminale: attualmente funziona con Claude Code e rileva anche Codex, sebbene il terminale di un nodo non debba necessariamente eseguire un agente: è semplicemente una normale shell che TermTree può anche riconoscere quando ne sta eseguendo uno.

Indicatore del worktree

Un agente che entra in un worktree git modifica la propria directory di lavoro impostandola su quel worktree e, da quel momento, riporta i percorsi — nel proprio output, in una traccia dello stack, in git status — relativamente alla radice di quel worktree, non alla directory della shell del riquadro. Se perdi di vista il worktree in cui si trova un agente, potresti finire per esaminare la copia sbagliata di un file; per questo TermTree lo mostra automaticamente.

Quando TermTree rileva che l’agente in primo piano di un terminale sta lavorando all’interno di un worktree git, mostra un’icona del worktree su quel nodo e sulla barra del titolo del terminale. Passa il puntatore sull’icona per vedere il nome del branch del worktree.

L’indicatore persiste anche dopo i riavvii: riaprendo TermTree, un nodo il cui agente si trovava in un worktree continua a mostrarlo.

Non disponibile su Windows nativo. Il rilevamento dei worktree si basa sulla risoluzione dei percorsi in stile POSIX, quindi non funziona in una shell Windows nativa. Non è disponibile nemmeno oltre il confine di WSL, che nasconde all’host la directory di lavoro dell’agente: in questo caso TermTree ripiega sulla directory segnalata dalla shell.

Ripresa di una sessione Claude

Premi Cmd+Shift+R / Ctrl+Shift+R con un nodo selezionato per riprendere la relativa sessione di Claude Code (claude --resume): è utile se il terminale è stato chiuso o se vuoi tornare a una conversazione senza digitare nuovamente il comando di ripresa. Consulta Persistenza delle sessioni per scoprire come ciò avviene automaticamente anche dopo il riavvio dell’app.

Come TermTree riconosce che un agente è in attesa del tuo intervento

Lo stato INPUT (punto arancione) indica che un agente è bloccato in attesa della tua risposta. TermTree lo rileva in due modi:

• Claude Code — rilevamento autorevole. TermTree registra un hook Notification in ~/.claude/settings.json e inserisce un TERMTREE_NODE_ID nell’ambiente di ciascun terminale. Quando Claude attiva una notifica (ad esempio, per chiedere l’autorizzazione a una chiamata di uno strumento), TermTree sa con certezza quale nodo richiede la tua attenzione: non si limita a dedurlo dal testo del terminale.
• Altre CLI — soluzione di riserva basata sulla corrispondenza di pattern. Per gli agenti privi di un’integrazione tramite hook, TermTree analizza l’output del terminale alla ricerca di pattern comuni delle richieste bloccanti (come le conferme in stile [y/N]) per dedurre che il terminale è in attesa di input.