AgentValley als Claude Code monitor op je Mac

Wat doet AgentValley in gewone taal?

AgentValley is een gratis, opensource Mac-app die lokale Claude Code-sessies samenbrengt in een paneel onder de notch. In gewone taal is het een klein overzichtsscherm: je ziet welke agent bezig is en welke op je antwoord wacht, zonder steeds alle terminalvensters te openen. Elke agent krijgt een rij en een figuurtje in pixelstijl, ook de subagents die een sessie inschakelt. Je hebt Claude Code en macOS 15 of nieuwer nodig.

Kosten en gebruikslimieten goed lezen

Open History via de grafiekknop en kies een dag, week of maand. Je kunt verder kijken naar uren of naar de sessies van een project. De bedragen zijn berekend met API-prijzen. Gebruik ze om verbruik te vergelijken; ze vervangen geen rekening van je abonnement. Export PDF maakt een overzicht voor alle projecten of één project. De geschiedenis blijft op de Mac bestaan wanneer Claude Code oude bestanden opruimt.

Daarnaast toont het paneel tokens voor de afgelopen vijf uur en vandaag, met een grafiek over twaalf uur. “Plan limits” staat standaard uit en voegt na inschakeling vijfuurs- en weeklimieten met resetmoment toe. Gecontroleerd op 25 oktober 2026: de app is gratis en sponsoring is vrijwillig. Toegang tot Claude Code heeft eigen voorwaarden.

Zie welke sessie op je wacht

Sessies staan per project bij elkaar; worktrees tellen mee bij hun project. Op een sessiekaart zie je taak, model en laatste stap. Subagents hebben bovendien een stappenteller. Daardoor kun je een gedelegeerde zoekopdracht onderscheiden van het hoofdwerk.

Een rood getal bij de notch wijst op een vraag of toestemmingsverzoek. Open het paneel om de inhoud te lezen en spring naar de juiste app. Met “Go to the session’s tab” vinden Terminal en iTerm2 het betreffende tabblad. Bij Ghostty is dat minder eenduidig als twee sessies dezelfde map gebruiken. De geluiden staan aanvankelijk aan en zijn uit te schakelen of te vervangen door een eenvoudig signaal.

Installeren en naar een sessie springen

1. Download het officiële DMG-bestand, sleep AgentValley naar Programma’s en start de app. Homebrew kan ook: brew install --cask morsechimwai/tap/agent-valley.
2. Start een Claude Code-sessie, wijs naar de notch en controleer project en laatste actie.
3. Open het paneel vanuit een andere app met Control–Option–Command–A. Kies met de pijltjes en druk Return om naar de sessie te springen.
4. Wil je verzoeken in het paneel beantwoorden, schakel dan “Answer from the notch” in, voer de getoonde pluginopdracht uit en herstart Claude Code. Kies pas na het lezen “Allow once” of “Deny”.

Die antwoordplugin is een aparte, handmatige installatie.

Lokale gegevens en optionele instellingen

Volgens de openbare beschrijving leest de app ~/.claude/projects, ~/.claude/sessions, processen en Git-informatie van projecten. Eigen gegevens staan in ~/Library/Application Support/AgentValley. Alleen met “Plan limits” ingeschakeld leest zij je Claude Code-login uit Sleutelhanger en stuurt die naar api.anthropic.com. De dagelijkse updatecontrole bij GitHub kun je uitzetten.

De optionele terminalstatusregel past ~/.claude/settings.json aan, installeert een lettertype en voegt waar nodig een regel aan Ghostty toe. Een verwijderopdracht draait dat terug. Lokaal werken betekent hier dus niet dat elke instelling zonder netwerkverkeer werkt.

Voor wie is de app handig?

De app helpt vooral wanneer meerdere lokale sessies tegelijk draaien en je de wachtende sessie wilt vinden. Via Instellingen kan het paneel naar een aangesloten beeldscherm. “Quiet” betekent twee minuten zonder geschreven activiteit; het bewijst geen vastloper of bepaald voltooiingspercentage. De beschreven ondersteuning betreft Claude Code op Mac. De appbroncode heeft een MIT-licentie en het project is onafhankelijk van Anthropic.

Veelgestelde vragen

Is AgentValley gratis?

Ja. De app is gratis en opensource. Een vrijwillige bijdrage is geen verplicht betaald pakket en verandert de toegang tot Claude Code niet.

Zijn de getoonde kosten mijn rekening?

Nee. Het is een berekening met API-prijzen. Wat je betaalt hangt af van je eigen abonnement of factureringsvorm.

Heb ik een plugin nodig om sessies te bekijken?

Niet voor het gewone overzicht. De plugin is bedoeld om toestemmingsverzoeken vanuit de notch toe te staan of te weigeren.

Officiële downloads en hulp

• Officiële versies en downloads
• Broncode en installatiehandleiding
• Problemen melden via GitHub Issues