AgentValley per il monitoraggio di Claude Code

A cosa serve AgentValley, in parole semplici?

AgentValley è un’app Mac gratuita e open source che riunisce le sessioni locali di Claude Code in un pannello sotto la tacca dello schermo. In pratica è una piccola sala di controllo: mostra quale agente lavora e quale aspetta una risposta mentre usi un’altra app. Ogni agente ha una riga e un personaggio in pixel, compresi i sottoagenti avviati dalla sessione. Servono Claude Code e macOS 15 o successivo.

Riconoscere agenti attivi e richieste in attesa

Le sessioni sono raggruppate per progetto, includendo i relativi worktree. Ogni scheda mostra compito, modello e ultimo passaggio degli agenti; i sottoagenti hanno anche il conteggio dei passaggi. Puoi così distinguere un’esplorazione delegata dall’attività principale senza aprire ogni finestra.

Un numero rosso segnala domande o richieste di autorizzazione. Apri il pannello per leggere il contenuto e raggiungi l’app interessata. L’opzione “Go to the session’s tab” seleziona la scheda in Terminal e iTerm2. In Ghostty può esserci ambiguità se due sessioni usano la stessa cartella. I suoni inizialmente attivi possono essere disabilitati o sostituiti con un semplice avviso.

Leggere costi, token e limiti

History si apre dal pulsante del grafico. Scegli giorno, settimana o mese e approfondisci le ore di un giorno o le sessioni di un progetto. I valori sono calcolati ai prezzi API: aiutano a confrontare il consumo, ma non equivalgono automaticamente alla fattura di un abbonamento. Puoi esportare un PDF per tutti i progetti o per uno solo. La cronologia rimane sul Mac anche dopo la pulizia dei vecchi file di Claude Code.

Il pannello mostra token delle ultime cinque ore e della giornata, oltre a un grafico di dodici ore. “Plan limits” è inizialmente disattivato; abilitarlo aggiunge limiti di cinque ore e settimanali con tempi di ripristino. Al 25 ottobre 2026 l’app è gratuita; le donazioni sono volontarie e l’accesso a Claude Code è separato.

Installazione e primo utilizzo

1. Scarica il DMG ufficiale, trascina AgentValley in Applicazioni e avvialo. In alternativa usa brew install --cask morsechimwai/tap/agent-valley.
2. Avvia una sessione Claude Code e porta il puntatore sulla tacca. Verifica progetto, compito e ultima azione.
3. Premi Control–Opzione–Comando–A da un’altra app, seleziona una riga con le frecce e premi Invio per tornare alla sessione.
4. Per rispondere dal pannello, abilita “Answer from the notch”, esegui il comando del plugin indicato nelle impostazioni e riavvia Claude Code. Leggi la richiesta prima di scegliere “Allow once” o “Deny”.

Il plugin per le risposte è facoltativo e si installa manualmente.

Dati locali e funzioni facoltative

La descrizione pubblica dichiara la lettura di ~/.claude/projects, ~/.claude/sessions, processi e informazioni Git dei progetti. I dati dell’app sono in ~/Library/Application Support/AgentValley. Attivando “Plan limits”, l’app legge il login Claude Code dal Portachiavi e lo invia a api.anthropic.com. Il controllo giornaliero degli aggiornamenti su GitHub è disattivabile.

La barra di stato facoltativa del terminale modifica ~/.claude/settings.json, installa un font e può aggiungere una riga alla configurazione Ghostty. Il comando di rimozione annulla queste aggiunte. Non va quindi interpretata come un’app priva di qualsiasi comunicazione di rete in ogni configurazione.

A chi è utile e quali limiti considerare

È utile soprattutto a chi esegue più sessioni locali e vuole trovare rapidamente quella in attesa. Nelle impostazioni puoi spostare il pannello su un monitor collegato. Lo stato “quiet” indica assenza di attività scritta da due minuti, non una percentuale di completamento o un blocco certo. L’ambito documentato è Claude Code su Mac. Il codice dell’app è MIT e il progetto è indipendente da Anthropic.

Domande frequenti

AgentValley è gratuito?

Sì. L’app è gratuita e open source; il supporto economico è facoltativo. Restano separate le condizioni di accesso a Claude Code.

La stima corrisponde alla fattura?

No. È una stima basata sui prezzi API, che può essere diversa dagli importi effettivamente pagati con il tuo piano.

Serve un plugin per vedere le sessioni?

Non per la visualizzazione ordinaria. Il plugin si installa manualmente per consentire o negare richieste dal pannello.

Download e supporto ufficiali

• Versioni e download ufficiali
• Codice sorgente e istruzioni
• Segnalazioni su GitHub Issues