Agentenerkennung

Wenn mehrere Agenten gleichzeitig laufen, kannst du nicht jedes Terminal überwachen — jeder Knoten muss dir mitteilen, wann er dich braucht und wo er arbeitet, damit du handeln kannst, statt ihn ständig zu beaufsichtigen. TermTree erreicht dies, indem es in einem Terminal ausgeführte Agenten-CLIs erkennt: Derzeit funktioniert es mit Claude Code und erkennt auch Codex. Im Terminal eines Knotens muss jedoch überhaupt kein Agent laufen — es ist einfach eine normale Shell, bei der TermTree zusätzlich erkennen kann, wenn darin ein Agent ausgeführt wird.

Worktree-Anzeige

Ein Agent, der in einen git-Worktree wechselt, ändert sein eigenes Arbeitsverzeichnis dorthin und gibt von diesem Zeitpunkt an Pfade — in seiner Ausgabe, einem Stacktrace oder in git status — relativ zum Stammverzeichnis dieses Worktrees und nicht zum Shell-Verzeichnis des Bereichs an. Wenn du nicht mehr weißt, in welchem Worktree sich ein Agent befindet, überprüfst du möglicherweise die falsche Kopie einer Datei. Deshalb zeigt TermTree diese Information automatisch an.

Wenn TermTree erkennt, dass der im Vordergrund eines Terminals laufende Agent innerhalb eines git-Worktrees arbeitet, zeigt es an diesem Knoten und in der Titelleiste des Terminals ein Worktree-Symbol an. Bewege den Mauszeiger über das Symbol, um den Branch-Namen des Worktrees zu sehen.

Die Anzeige bleibt auch nach Neustarts erhalten — wenn du TermTree erneut öffnest, wird sie bei einem Knoten, dessen Agent sich in einem Worktree befand, weiterhin angezeigt.

Unter nativem Windows nicht verfügbar. Die Worktree-Erkennung basiert auf der Pfadauflösung im POSIX-Stil und funktioniert daher nicht in einer nativen Windows-Shell. Sie ist außerdem nicht über eine WSL-Grenze hinweg verfügbar, da diese das Arbeitsverzeichnis des Agenten vor dem Host verbirgt — dort greift TermTree auf das von der Shell gemeldete Verzeichnis zurück.

Fortsetzen einer Claude-Sitzung

Drücke bei ausgewähltem Knoten Cmd+Shift+R / Ctrl+Shift+R, um dessen Claude Code-Sitzung fortzusetzen (claude --resume) — das ist hilfreich, wenn das Terminal geschlossen wurde oder du zu einer Unterhaltung zurückkehren möchtest, ohne den Befehl zum Fortsetzen erneut einzugeben. Unter Sitzungspersistenz erfährst du, wie dies nach App-Neustarts auch automatisch geschieht.

Wie TermTree erkennt, dass ein Agent auf dich wartet

Der Status INPUT (orangefarbener Punkt) bedeutet, dass ein Agent blockiert ist und auf deine Antwort wartet. TermTree erkennt dies auf zwei Arten:

  • Claude Code — maßgeblich. TermTree registriert einen Notification-Hook in ~/.claude/settings.json und fügt der Umgebung jedes Terminals eine TERMTREE_NODE_ID hinzu. Wenn Claude eine Benachrichtigung auslöst (beispielsweise um die Erlaubnis für einen Tool-Aufruf zu bitten), weiß TermTree eindeutig, welcher Knoten deine Aufmerksamkeit benötigt — es leitet dies nicht lediglich aus dem Text des Terminals ab.
  • Andere CLIs — Pattern-Matching als Ausweichlösung. Bei Agenten ohne Hook-Integration durchsucht TermTree die Terminalausgabe nach typischen Mustern blockierender Eingabeaufforderungen (etwa Bestätigungen im Stil von [y/N]), um daraus abzuleiten, dass das Terminal auf eine Eingabe wartet.