Agent Tree: Claude Code Unteragenten als Baum aus Kästen sehen
Eine Seitenleiste, die Unteragenten als Kästen zeichnet, mit Hauptsitzung, Berater und Sitzungsprotokoll.
Berechtigungen
- Fängt Tool-Aufrufe abSieht jeden Tool-Aufruf von Claude (tool.call / tool.check) und könnte ihn blockieren oder verändern.
- Liest deine PromptsKann sehen, was du eingibst, und den Gesprächsverlauf lesen (prompt.* / session.append / session.messages).
- Verändert die OberflächeZeichnet in die Oberfläche von Claude Code: Leisten, Bereiche, Statustext, Toasts (ui.render / $.ui.*).
- Fügt Befehle/Tools hinzuRegistriert neue Slash-Befehle oder Tools, die du oder Claude aufrufen können ($.command.register / $.tool.register).
- getestet mit
- v2.1.310
- zuletzt getestet
- erfordert
- Claude Code ≥ 2.1.287
- Oberflächen
- Bereich, Statuszeile
In Claude Code installieren:
/plugin install agent-tree --marketplace MikeGT4/agent-treeWas macht diese Mod?
Agent Tree ist eine Community-Mod von Mike Pollow, Digitalroots (MikeGT4). Sie zeigt deine Claude Code Unteragenten in einer Seitenleiste als Baum aus Kästen. Oben steht die Hauptsitzung mit Modell, Effort-Stufe, Kontextverbrauch und Rundennummer. Darunter hat jeder Unteragent einen Kasten mit Typ, Modell, Beschreibung, letztem Werkzeug, Statuszeile und Zeitleistenbalken. Ein letzter Kasten markiert den Weg zurück zur Hauptsitzung und zählt die zurückgegebenen Antworten.
Neben dem Baum zeigt eine Berater-Spalte, ob ein Beraternmodell eingerichtet ist, wie oft es befragt wurde, aus der Hauptsitzung oder aus Unteragenten, und wann zuletzt. Ganz unten listet ein Sitzungsprotokoll die Runden, Starts und Enden von Agenten, Berateraufrufe und deine eigenen Auswahlen. Laufen viele Agenten, wechselt die Leiste zu kompakten Zeilen, und ein Workflow mit vielen Agenten wird zu einem Kasten zusammengefasst.
Die Leiste ist zugleich eine Bedienfläche. Ein Klick auf den Typ eines Agenten zeigt Auftrag, letzte Werkzeuge und letzte Antwort und erlaubt, ihn zu stoppen. Du kannst eine Modellfamilie für neue Unteragenten oder für einen laufenden Agenten wählen. Nur in diesen Fällen ändert die Mod, was Claude Code tut. Die Statuszeile bekommt außerdem eine kurze Zusammenfassung wie Sub-agents [1/1] · $0.00. Der Autor hat sie mit Claude Code 2.1.296 und 2.1.307 bis 2.1.310 getestet.
Demo
Die Aufnahme startet Claude Code mit der geladenen Mod im kleinen Demoprojekt und führt /agent-tree aus, was die Leiste öffnet: Die Hauptsitzung ist bereit, es gibt noch keine Unteragenten, und das Sitzungsprotokoll ist leer. Dann bittet sie Claude, mit einem Unteragenten src/login.js zu lesen und in einem Satz zu beschreiben. Die Leiste wechselt zu ARBEITET, das Protokoll bekommt eine Zeile „Round 1“, und ein general-purpose-Unteragent erscheint als laufend, die Hauptsitzung „wartet auf Unteragenten“ und die Kontextzahl füllt sich. Wenn der Agent fertig ist, wird seine Antwort im Kasten „zurück zur Hauptsitzung“ gezählt.
Installation
Nutze eine der Methoden im Installationsblock; sie installieren direkt aus dem Marketplace des Autors. Öffne danach die Leiste mit /agent-tree.
$ install agent-tree
Erfordert Claude Code ≥ 2.1.287
Wird aus dem Marketplace des Autors installiert: MikeGT4/agent-tree
1.Eine Zeile, direkt in Claude Code
/plugin install agent-tree --marketplace MikeGT4/agent-treeIn eine laufende Sitzung einfügen (v2.1.275+). Claude Code fragt zuerst, ob der Marketplace hinzugefügt werden soll.
2.Aus deiner Shell
claude plugin marketplace add MikeGT4/agent-tree claude plugin install agent-tree@agent-treeFühre danach in jeder bereits geöffneten Sitzung /reload-plugins aus.
3.Ohne Installation ausprobieren
git clone https://github.com/MikeGT4/agent-tree claude --plugin-dir ./agent-treeLädt die Mod nur für eine Sitzung. An deinen Einstellungen wird nichts geändert.
So funktioniert es
Die Mod hält den Baum in einem Zustandsatom und hört auf die Agent-Ereignisse: agent.spawn fügt einen Knoten hinzu, tool.call zählt Werkzeuge, turn.step hält Modell, Effort und Beraternutzung fest, und turn.complete markiert einen Agenten als fertig, fehlgeschlagen oder gestoppt. ui.render zeichnet die Leiste aus diesem Zustand. Ein Timer mit 250 ms bewegt den Spinner nur, solange ein Agent läuft. Die Stopp-Funktion ist der Teil, der Werkzeugaufrufe sperrt, aus hooks/register.tsx:
if (stoppingIds.has(agentId)) {
if (e.tool !== HANDBACK) {
const current = await read($, tree)
return { deny: wordsFor(lang).stopAnswer(current.agents.find(n => n.id === agentId)?.toolCount ?? 0) }
}Betroffen ist nur ein Agent, den du stoppen ließest. Texte aus der Sitzung (Auftrag, Antworten, Werkzeugetiketten) werden vor dem Zeichnen bereinigt: Terminal-Escapes und Steuerzeichen werden entfernt, und Zeichenfolgen, die wie Token, Passwörter oder KEY=value aussehen, werden durch ••• ersetzt. Werkzeugetiketten zeigen einen Dateinamen, Programmnamen oder Host, nicht den ganzen Befehl.
Anpassen
/config bietet fünf Optionen: Breite der angedockten Leiste (Standard 90 Spalten, 40 bis 140), wie viele Unteragenten der Baum behält (Standard 30), beim Start öffnen (Standard aus), Bewegung (Spinner und Fluss-Animation, Standard an) und Sprache (auto, de, en). Eine von Hand gezogene Breite hat Vorrang. Tasten in der Leiste: m für die Modellauswahl, 0 bis 4 zum Wählen, x zum Schließen, s zum Stoppen in der Detailansicht und ctrl+x tab, um die Leiste zu fokussieren.
Berechtigungen & Sicherheit
Wir haben jede Datei gelesen, die das Plugin ausführen kann: hooks/hooks.json, register.tsx, model.ts, view.tsx, words.ts, die Typdeklarationen, die Tests, die README und PRIVACY.md. Es gibt keine package.json, kein Installationsskript, keine Binärdatei und keinen gebündelten Code. Die einzige Nicht-Textdatei ist ein PNG-Symbol.
- Netzwerk, Prozesse, Dateien, Daemons, Geheimnisse: keine. Wir fanden keinen Netzwerkaufruf, keinen Shell-Befehl, kein Schreiben von Dateien, keine Umgebungsvariable und keinen Zugriff auf Zugangsdaten, und nichts läuft nach dem Beenden von Claude Code weiter. Der Timer stoppt, wenn kein Agent beschäftigt ist.
- Liest: Agentenliste und Nachrichten von Unteragenten (für die Detailansicht), deine Einstellungen
languageundadvisorModel, Kontext- und Kostenwerte. - Telemetrie: keine.
- Sperrende Hooks:
agent.spawnsetzt dein gewähltes Modell bei neuen Unteragenten, die keines nennen,turn.stepschaltet den nächsten Schritt eines laufenden Agenten auf das gewählte Modell um oder ersetzt ihn durch einen kurzen Bericht, wenn du stoppst, undtool.calllehnt weitere Werkzeugaufrufe eines gestoppten Agenten ab. Alle drei wirken nur, nachdem du in der Leiste geklickt hast, was zu README und PRIVACY.md passt. Der Stoppbericht ist eine synthetische Assistentennachricht mit einemSubagentHandback-Werkzeugaufruf mit zufälliger ID. - Prompt-Injection: keine gefunden. Die Mod fügt Prompts keinen Text hinzu und enthält kein verstecktes Unicode.
- Lizenz: MIT, mit LICENSE-Datei.
claude plugin validate meldete weder Fehler noch Warnungen; es weist darauf hin, dass das Plugin-Verzeichnis eigene Regeln für Hooks-Module hat, die validate nicht anwendet. Die 63 Tests des Autors liefen mit Claude Code 2.1.310 fehlerfrei durch.
- Fängt Tool-Aufrufe ab
- Sieht jeden Tool-Aufruf von Claude (tool.call / tool.check) und könnte ihn blockieren oder verändern.
- Liest deine Prompts
- Kann sehen, was du eingibst, und den Gesprächsverlauf lesen (prompt.* / session.append / session.messages).
- Verändert die Oberfläche
- Zeichnet in die Oberfläche von Claude Code: Leisten, Bereiche, Statustext, Toasts (ui.render / $.ui.*).
- Fügt Befehle/Tools hinzu
- Registriert neue Slash-Befehle oder Tools, die du oder Claude aufrufen können ($.command.register / $.tool.register).
Kompatibilität & Fehlerbehebung
Geprüft mit Claude Code 2.1.310 unter macOS (validate, Tests und die Aufnahme). Die Mod braucht die Mod-Schnittstelle. Wenn die Leiste nicht erscheint:
claude --versionist 2.1.287 oder neuer.- Du hast
/agent-treeausgeführt; die Leiste öffnet sich nicht von selbst. Bei Erfolg gibt der Befehl „Agent Tree opened“ aus. - Das Terminal ist breit genug: Unter 84 Spalten wird die Berater-Spalte über den Baum gestapelt, und unter 40 Spalten Leistenbreite wird es eng.
- Agenten, die vor dem Laden der Mod gestartet wurden, werden beim Öffnen der Leiste aus der Agentenliste übernommen.
- In einer einfachen Sitzung zeigt die Leiste nichts an: Ohne Unteragenten steht dort „no sub-agents yet“.
FAQ
- Sendet Agent Tree Daten oder macht es Netzwerkanfragen?
- Nein. Im Code gibt es keine Netzwerkaufrufe, und die PRIVACY.md des Autors sagt, dass nichts den Rechner verlässt. Der Baum liegt nur im Speicher der laufenden Sitzung, es werden keine Dateien geschrieben.
- Kann ich einen laufenden Unteragenten in der Leiste stoppen?
- Ja. Klicke auf den Typ des Agenten, um die Details zu öffnen, und drücke dann stoppen (oder die Taste s). Weitere Werkzeugaufrufe dieses Agenten werden abgelehnt, und sein nächster Schritt gibt einen kurzen Bericht „vom Nutzer gestoppt“ zurück.
- Kann ich das Modell eines Unteragenten ändern?
- Ja. Der Knopf Modell legt die Modellfamilie (Haiku, Sonnet, Opus oder Fable) für neue Unteragenten fest, und der Knopf im Kasten eines laufenden Agenten schaltet dessen nächste Schritte um. Ein Modell, das der Aufruf selbst nennt, bleibt unberührt.
- Ist die Leiste immer geöffnet?
- Nicht standardmäßig. /agent-tree öffnet sie, /agent-tree stop schließt sie und /agent-tree clear beginnt den Baum neu. Die Einstellung „Beim Start öffnen“ öffnet sie in jeder Sitzung.
- Sind die Beschriftungen auf Englisch?
- Standardmäßig folgen sie der Spracheinstellung, Deutsch oder Englisch. Die Option Language kann de oder en erzwingen. Die Zeiten im Protokoll erscheinen im 24-Stunden-Format.
# Ähnliche Mods
EmpfohlenAgent Radar
Pro laufendem Subagent eine Live-Zeile über der Eingabe: Zeit, Tool-Anzahl und aktuelle Aktion, dazu ein /radar-Pane.
- über dem Prompt
- Bereich
- Toast
- Fängt Tool-Aufrufe ab
- Liest deine Prompts
- Verändert die Oberfläche
- Fügt Befehle/Tools hinzu
getestet mit v2.1.291
EmpfohlenAgent Profiler
Wohin die Zeit einer Claude-Code-Sitzung geht: Modell, Tools, Subagenten, live in der Statuszeile. Mit OTLP-Export.
- Statuszeile
- Bereich
- Toast
- Schreibt Dateien
- Netzwerk
- Fängt Tool-Aufrufe ab
- Verändert die Oberfläche
- Fügt Befehle/Tools hinzu
getestet mit v2.1.303
Mehr in Panes & Dashboards, Timer, Todos, Standups.