AgentValley pour suivre Claude Code sur Mac

À quoi sert AgentValley, simplement ?

AgentValley est une application Mac gratuite et open source qui rassemble les sessions locales de Claude Code sous l’encoche de l’écran. Pour faire simple, c’est un petit poste de contrôle : il indique quel agent travaille et lequel attend votre réponse. Vous pouvez ainsi rester dans une autre application sans vérifier chaque terminal. Chaque agent possède une ligne et un petit personnage en pixels, y compris les sous-agents. Il faut Claude Code et macOS 15 ou une version ultérieure.

Repérer les agents qui attendent une réponse

Les sessions sont regroupées par projet, avec les worktrees rattachés à leur projet. Chaque carte affiche les agents, leur tâche, leur modèle et leur dernière étape. Les sous-agents disposent aussi d’un compteur d’étapes, utile pour distinguer une recherche déléguée du travail principal.

Un compteur rouge signale une question ou une demande d’autorisation. Ouvrez le panneau pour la lire, puis rejoignez l’application concernée. L’option “Go to the session’s tab” cible l’onglet dans Terminal et iTerm2. Avec Ghostty, deux sessions dans le même dossier peuvent rendre ce choix ambigu. Les sons, activés au départ, peuvent être coupés ou remplacés par un simple signal.

Comprendre les coûts et les limites

Le bouton en forme de graphique ouvre History. Choisissez un jour, une semaine ou un mois, puis examinez les heures d’une journée ou les sessions d’un projet. Les montants sont calculés aux tarifs API : ils permettent de comparer la consommation, sans constituer votre facture d’abonnement. Un export PDF peut couvrir tous les projets ou un seul. L’historique reste sur le Mac après le nettoyage des anciens fichiers par Claude Code.

Le panneau montre aussi les tokens des cinq dernières heures et de la journée, avec un graphique sur douze heures. “Plan limits”, désactivé par défaut, affiche les limites sur cinq heures et sur la semaine ainsi que leur réinitialisation. Au 25 octobre 2026, l’application est gratuite ; le soutien financier est facultatif. L’accès à Claude Code reste séparé.

Installer et retrouver une session

1. Téléchargez le DMG officiel, placez AgentValley dans Applications et lancez-le. Homebrew constitue une autre option : brew install --cask morsechimwai/tap/agent-valley.
2. Lancez une session Claude Code, pointez vers l’encoche et vérifiez le projet ainsi que la dernière action.
3. Depuis une autre application, Control–Option–Commande–A ouvre le panneau. Les flèches sélectionnent une ligne et Retour rejoint la session.
4. Pour répondre aux autorisations dans le panneau, activez “Answer from the notch”, exécutez la commande du plugin affichée dans les réglages et redémarrez Claude Code. Lisez la demande avant de choisir “Allow once” ou “Deny”.

Cette installation manuelle du plugin est distincte du simple suivi.

Données locales et options à activer

Selon la description publique, l’app lit ~/.claude/projects, ~/.claude/sessions, des informations sur les processus et le Git des projets. Ses données se trouvent dans ~/Library/Application Support/AgentValley. Activer “Plan limits” autorise la lecture de la connexion Claude Code dans le Trousseau et son envoi à api.anthropic.com. La vérification quotidienne des mises à jour GitHub peut être désactivée.

La ligne d’état facultative du terminal modifie ~/.claude/settings.json, installe une police et ajoute, si nécessaire, une ligne à la configuration Ghostty. Une commande de retrait annule ces ajouts. Le fonctionnement local ne doit donc pas être interprété comme une absence de réseau dans toutes les options.

À qui cet outil convient-il ?

AgentValley convient surtout aux développeurs qui font travailler plusieurs sessions locales en parallèle. Les réglages permettent de déplacer le panneau sur un écran connecté. L’état “quiet” signifie qu’aucune activité écrite n’a été observée depuis deux minutes ; ce n’est pas une mesure du pourcentage d’avancement. Le périmètre documenté est Claude Code sur Mac. Le code de l’application est sous licence MIT et le projet n’est pas affilié à Anthropic.

Questions fréquentes

AgentValley est-il gratuit ?

Oui. L’application est gratuite et open source. Le sponsoring est facultatif et ne remplace pas les conditions d’accès à Claude Code.

Le coût affiché correspond-il à ma facture ?

Non. History utilise les tarifs API comme base d’estimation. Le montant réellement payé dépend de votre formule et de votre facturation.

Faut-il installer un plugin pour surveiller les sessions ?

Pas pour consulter les sessions. Le plugin est un ajout manuel permettant de répondre aux demandes d’autorisation depuis l’encoche.

Téléchargements et assistance officiels

• Versions et téléchargements officiels
• Code source et guide de configuration
• Signaler un problème sur GitHub