AgentValley für Claude Code Monitoring am Mac

Was macht AgentValley einfach erklärt?

AgentValley ist eine kostenlose, quelloffene Mac-App für die Überwachung lokaler Claude-Code-Sitzungen. Einfach erklärt: Ein kleines Kontrollfenster unter der Notch zeigt, welcher Agent arbeitet und welcher eine Antwort benötigt. So müssen Sie nicht ständig zwischen Terminalfenstern wechseln. Kleine Pixelfiguren unterscheiden die Agenten; auch gestartete Unteragenten erhalten eine eigene Zeile. Voraussetzung sind Claude Code und macOS 15 oder neuer.

Welche lokalen Daten werden gelesen?

Laut öffentlicher Beschreibung liest AgentValley ~/.claude/projects und ~/.claude/sessions sowie Prozess- und Git-Informationen. Eigene Daten liegen unter ~/Library/Application Support/AgentValley. Erst wenn Sie „Plan limits“ einschalten, liest die App den Claude-Code-Login aus dem Schlüsselbund und sendet ihn an api.anthropic.com. Die tägliche Update-Abfrage bei GitHub lässt sich abschalten.

Die optionale Terminal-Statuszeile benötigt eine bewusste Installation: Sie verändert ~/.claude/settings.json, installiert eine Schrift und ergänzt gegebenenfalls die Ghostty-Konfiguration. Ein Entfernungsbefehl macht diese Ergänzungen rückgängig. Diese Angaben sind keine Zusage, dass die App in jeder Einstellung ohne Netzwerkzugriff arbeitet.

Sitzungen und Rückfragen im Blick behalten

Die App bündelt Sitzungen nach Projekt und ordnet auch Worktrees ihrem Projekt zu. Eine Sitzung erscheint als Karte, ihre Unteragenten stehen darunter. Aufgabe, Modell und letzter Arbeitsschritt helfen dabei, etwa eine Dateisuche von der eigentlichen Umsetzung zu unterscheiden. Unteragenten zeigen zusätzlich die Zahl ihrer Schritte.

Bei einer Rückfrage oder Berechtigungsanfrage erscheint eine rote Zahl an der Notch. Im Fenster lesen Sie den Inhalt und wechseln zur passenden App. Mit „Go to the session’s tab“ können Terminal und iTerm2 den richtigen Tab öffnen. Bei Ghostty ist das nicht eindeutig, wenn zwei Sitzungen denselben Ordner verwenden. Die zunächst aktivierten Töne lassen sich ausschalten oder durch einen einfachen Klang ersetzen.

Installation und erster Arbeitsablauf

1. Laden Sie die offizielle DMG-Datei herunter, ziehen Sie AgentValley nach Programme und starten Sie die App. Alternativ: brew install --cask morsechimwai/tap/agent-valley.
2. Starten Sie eine Claude-Code-Sitzung und öffnen Sie das Fenster, indem Sie auf die Notch zeigen. Prüfen Sie Projekt, Aufgabe und letzte Aktion.
3. Mit Control–Option–Command–A öffnen Sie die Übersicht aus einer anderen App. Pfeiltasten wählen eine Zeile, Return wechselt zur Sitzung.
4. Für Antworten direkt an der Notch aktivieren Sie „Answer from the notch“, führen den angezeigten Plugin-Befehl aus und starten Claude Code neu. „Allow once“ oder „Deny“ wählen Sie selbst nach Prüfung der Anfrage.

Kosten, Token und Nutzungslimits verstehen

Über das Diagrammsymbol öffnet sich History. Sie können Tage, Wochen oder Monate ansehen und bis zu Stunden beziehungsweise einzelnen Projektsitzungen wechseln. Die Beträge beruhen auf API-Preisen. Sie sind eine Vergleichsgröße für den Verbrauch und keine automatisch zutreffende Aborechnung. Ein PDF-Bericht lässt sich für alle Projekte oder ein einzelnes Projekt exportieren; die Historie bleibt lokal erhalten.

Außerdem sehen Sie Token für die letzten fünf Stunden und den heutigen Tag sowie einen Zwölf-Stunden-Verlauf. „Plan limits“ zeigt nach Aktivierung Fünf-Stunden- und Wochenlimits mit Rücksetzzeit. Stand 25. Oktober 2026 ist die App kostenlos; freiwilliges Sponsoring ist kein kostenpflichtiger Funktionsplan.

Für wen sich die App eignet

Besonders hilfreich ist die Übersicht bei mehreren gleichzeitig laufenden lokalen Coding-Sitzungen. Über die Display-Einstellung kann das Fenster auf einen angeschlossenen Bildschirm umziehen. „Quiet“ bedeutet, dass ein Agent seit zwei Minuten nichts geschrieben hat; daraus folgt weder ein sicherer Stillstand noch ein fertiges Ergebnis. Dokumentiert ist der Einsatz mit Claude Code am Mac. Der App-Quellcode steht unter MIT-Lizenz; das Projekt gehört nicht zu Anthropic.

Häufige Fragen

Ist AgentValley kostenlos?

Ja. Die App ist kostenlos und quelloffen. Für die Nutzung von Claude Code gelten dessen eigene Zugangs- und Abrechnungsbedingungen.

Entsprechen die Kosten meiner Rechnung?

Nein. History berechnet einen Verbrauchswert anhand von API-Preisen. Dieser Betrag muss nicht mit Ihren tatsächlichen Zahlungen übereinstimmen.

Muss ich für die Anzeige ein Plugin installieren?

Für die normale Übersicht ist das Antwort-Plugin nicht erforderlich. Es wird manuell installiert, wenn Sie Berechtigungen direkt im Notch-Fenster beantworten möchten.

Offizielle Downloads und Hilfe

• Offizielle Releases und Download
• Quellcode und Einrichtungsanleitung
• Fehler und Vorschläge auf GitHub