AGENT SESSIONS : un historique unifié et un compteur de quota pour les quinze agents de code sur macOS

https://jazzyalex.github.io/agent-sessions

📌 AGENT SESSIONS est une application macOS open source qui lit l’historique local de quinze agents de code (Codex, Claude, Cursor et douze autres) pour le réunir dans un seul moteur de recherche, avec transcriptions et images. Codex et Claude bénéficient en plus d’un compteur de quota : un jauge en live mesure combien chaque session brûle de vos limites de cinq heures et hebdomadaires, tarifé par modèle.

Le problème de départ est celui de tout développeur qui fait tourner plusieurs agents en parallèle. Codex, Claude, Cursor et les autres écrivent des sessions sur le Mac toute la journée, chacune dans son propre format et son propre dossier. Agent Sessions lit tous ces fichiers pour les afficher dans une seule fenêtre, où l’on peut chercher en texte intégral, parcourir les transcriptions avec les appels d’outils et les images, et reprendre une session en cliquant sur un bouton de reprise.

Le Quota Meter est la fonctionnalité la plus utile. Un compteur classique affiche 60 % utilisé, sans dire quel agent a consommé quoi. Agent Sessions attribue la consommation à chaque session individuellement, en live, par rapport à vos fenêtres de cinq heures et hebdomadaires de Codex et Claude. Une barre par session montre le taux de combustion, et on sait immédiatement laquelle arrêter.

Quatre objectifs sont disponibles : cinq heures, hebdomadaire, tokens par heure ou dollars. L’objectif dollars tarife chaque modèle d’une session à son propre taux, de sorte qu’un orchestrateur Opus pilotant des sous-agents Sonnet est facturé à ce que chacun coûte vraiment, plutôt que fusionné en un seul chiffre. Des prévisions de fin de course donnent l’autonomie restante avant d’atteindre le mur, et des alertes séparées gèrent l’épuisement prédit et les seuils bas.

Le widget toujours visible garde ces limites à l’écran : une petite fenêtre affiche l’autonomie restante pour les fenêtres de cinq heures et hebdomadaires, et on peut la glisser n’importe où.

La recherche fonctionne à la manière d’Apple Notes, à la fois sur tous les agents et dans une session unique. Les sorties visuelles de Codex, Claude et OpenCode sont affichées en ligne et consultables dans un navigateur d’images dédié. Parmi les quinze sources : Codex (Desktop, CLI, VS Code), Claude (Desktop, CLI), Cursor, Antigravity, GitHub Copilot, OpenCode, Pi, Hermes, Kimi Code, Grok CLI, Qwen Code, OpenClaw, Devin CLI et fx de Vercel.

Chaque agent est lu depuis ses propres fichiers de session, en lecture seule. Les chemins couvrent des dossiers comme ~/.codex/sessions, ~/.claude/projects, ~/.local/share/opencode/opencode.db et bien d’autres. Depuis la version 5.0, les agents sont des adaptateurs enfichables : ajouter celui que l’on utilise est une recette documentée, et il suffit d’un fichier avec un test.

La reprise se fait d’un clic droit sur une session CLI supportée : copier la commande de reprise exacte, ou l’ouvrir directement dans Terminal.app, iTerm2 ou Warp.

Tout se passe en local. Aucun traitement dans le cloud, aucune télémétrie, aucun téléchargement d’historique de session. L’application lit les dossiers que l’on choisit, construit des index locaux pour la recherche, et la seule activité réseau est la vérification optionnelle de mises à jour Sparkle et la lecture d’une liste publique de prix de modèles pour l’estimation en dollars.

L’installation se fait en DMG ou en Homebrew, avec mises à jour automatiques signées et notarisées. L’application exige macOS 14 et plus.

• ✔️ Quinze agents : Codex, Claude, Cursor, OpenCode, Pi, Grok, Kimi, Qwen…
• 🔍 Recherche texte intégral unifiée et dans une session
• 🖼️ Affichage et navigation des images en sortie
• 🔄 Reprise en un clic dans Terminal, iTerm2 ou Warp
• ⏱️ Quota Meter : taux de combustion par session, live
• 💵 Coût par modèle, pas un chiffre fusionné
• 🔔 Alertes de fin de course et de seuil bas
• 📊 Analytics : tendances, répartition, heatmaps
• 🏠 Local-first, aucune télémétrie
• 🧩 Agents comme adaptateurs enfichables, recette documentée
• 🍎 macOS 14+, DMG ou Homebrew

Agent Sessions est distribué gratuitement sous licence MIT par jazzyalex. C’est un complément de choix à Luvus ou Herdr : là où ceux-ci orchestrent les agents en direct, Agent Sessions archive, cherche et facture ce qu’ils ont déjà fait.

🔗 Site : https://jazzyalex.github.io/agent-sessions/

🔗 GitHub : https://github.com/jazzyalex/agent-sessions