Modèle / jeu de données
mikehasa/agentacct avatar
mikehasa/agentacct

agentacct : relier journaux locaux, coûts estimés et travail des agents

Découvrez ce que vos agents de codage ont fait et combien cela a coûté. Décompose chaque tâche en étapes de travail, outils utilisés, fichiers modifiés, tests exécutés, temps et jetons dépensés. Tableau de bord local pour Claude Code, Codex, OpenCode et plus encore. Pas de connexion, pas de télémétrie.

720 étoiles78 forksPythonMIT
GitHub

En bref

De quoi s’agit-il ?
Lit les journaux de session Claude Code et Codex pour afficher l'utilisation, le coût estimé, les étapes de travail et la confiance d'attribution dans une interface terminal en direct. Pas de télémétrie, pas de serveur.
À qui s’adresse-t-il ?
mikehasa-agentacct s adresse aux lecteurs dont le besoin correspond aux fonctions décrites dans son README. Il ne convient pas d en déduire des garanties absentes de cette source.
Puis-je l’utiliser commercialement ?
Oui. MIT est une licence permissive : vous pouvez utiliser, modifier et vendre un logiciel qui en dépend, à condition de conserver les mentions de droit d’auteur et de licence.
Est-il encore maintenu ?
Oui. Les derniers commits datent d’il y a 2 jours.
En quel langage est-il écrit ?
Principalement Python, d’après les statistiques de langage de GitHub.

Ces réponses reposent sur les données GitHub du projet (dernière synchronisation le 14 septembre 2026) et sur notre analyse. Elles ne constituent pas un avis juridique.

ANALYSE OPEN SOURCE APPROFONDIE

Lecture des journaux de session locaux dans un tableau de bord terminal en direct

agentacct lit les journaux de session que Claude Code et Codex écrivent déjà sur votre machine, les joint aux travaux que chaque session enregistre au fur et à mesure, et affiche le résultat dans `agentacct tui`, un tableau de bord terminal en direct. Pas de navigateur, pas de serveur, pas de compte. Tout reste sur votre machine : l'état est constitué de fichiers locaux simples, rien ne lie un port réseau, pas de télémétrie, pas de compte, pas de synchronisation cloud. agentacct ne stocke ni ne demande jamais de clé API de fournisseur.

Dans mikehasa-agentacct, le point « Lecture des journaux de session locaux dans un tableau de bord terminal en direct » doit être lu à partir des éléments effectivement cités par le README. Il décrit une capacité ou un contexte précis, sans établir à lui seul une promesse de performance, de sécurité ou de compatibilité. La distinction est importante pour choisir un périmètre réaliste et pour ne pas attribuer au dépôt une fonction que sa documentation ne mentionne pas.

Le lecteur peut confronter cette section aux fichiers, exemples et liens nommés dans la source. Lorsque le README ne donne pas une information, elle reste non documentée. Cette réserve est particulièrement utile pour mikehasa-agentacct, car les dépendances et l environnement d exécution peuvent modifier le résultat observé.

Utilisation, étapes de travail et étiquettes d'attribution

La TUI affiche les fenêtres d'utilisation, les barres de limite de débit du fournisseur avec compte à rebours de réinitialisation et les sessions récentes. Appuyez sur `s` pour explorer les sessions, `u` pour l'écran d'utilisation, `p` pour enregistrer un instantané SVG partageable. Les jetons par agent, modèle et jour sont lus à partir des fichiers de session locaux des clients et étiquetés `client_reported` ; les coûts sont des estimations de table de prix, jamais des factures. Chaque session résume ses étapes de travail enregistrées et ses vérifications machine, avec des statuts comme `in progress`, `handed off`, `done`, `blocked`, et des résultats de vérification avec codes de sortie. L'attribution entre l'utilisation et le travail porte une étiquette de confiance : exact, high, medium, low. Lorsque agentacct ne peut pas prouver un lien, il affiche l'écart plutôt qu'une supposition.

Dans mikehasa-agentacct, le point « Utilisation, étapes de travail et étiquettes d'attribution » doit être lu à partir des éléments effectivement cités par le README. Il décrit une capacité ou un contexte précis, sans établir à lui seul une promesse de performance, de sécurité ou de compatibilité. La distinction est importante pour choisir un périmètre réaliste et pour ne pas attribuer au dépôt une fonction que sa documentation ne mentionne pas.

La vérité d'utilisation et le sens du travail restent séparés jusqu'à la jointure

agentacct garde deux flux de preuves séparés et les joint sur de vraies identifiants clients. La vérité d'utilisation provient des fichiers de session locaux du client, étiquetés `client_reported`. Le sens du travail provient des sections et événements que l'agent enregistre via MCP pendant qu'il travaille, y compris `agentacct_record_section` et `agentacct_record_machine_check`, ainsi que des vérifications machine comme les tests. La jointure relie les deux via des identifiants de session/transcription et étiquette chaque attribution exact, high, medium ou low. Pour Claude Code, un pont hook installé capture de vrais identifiants de session/transcription au début de la session et à chaque appel d'outil ; pour Codex, le lien est prouvé à partir des journaux de session du client lors de l'importation. Les détails sont dans docs/reference.md.

Dans mikehasa-agentacct, le point « La vérité d'utilisation et le sens du travail restent séparés jusqu'à la jointure » doit être lu à partir des éléments effectivement cités par le README. Il décrit une capacité ou un contexte précis, sans établir à lui seul une promesse de performance, de sécurité ou de compatibilité. La distinction est importante pour choisir un périmètre réaliste et pour ne pas attribuer au dépôt une fonction que sa documentation ne mentionne pas.

Installation avec pipx et exécution d'onboard

Nécessite Python >= 3.11 sur macOS ou Linux, Windows uniquement via WSL. Installez avec `pipx install agentacct`, puis exécutez `agentacct onboard` une fois par machine. Onboard détecte les journaux d'agents de codage locaux, configure un stockage global, effectue une première synchronisation d'utilisation et démarre éventuellement un tableau de bord navigateur à http://127.0.0.1:8765. Vous devez ouvrir une nouvelle session d'agent après l'onboarding car les serveurs MCP et les hooks se lient au démarrage de la session, donc la session d'onboarding ne peut pas devenir la première tâche enregistrée. Pour une installation par dépôt, utilisez `agentacct onboard --scope project`. `agentacct demo` exécute une visite guidée locale sécurisée avec un stockage jetable. Le runtime géré est contrôlé avec `agentacct start`, `status`, `stop`, `repair`.

Dans mikehasa-agentacct, le point « Installation avec pipx et exécution d'onboard » doit être lu à partir des éléments effectivement cités par le README. Il décrit une capacité ou un contexte précis, sans établir à lui seul une promesse de performance, de sécurité ou de compatibilité. La distinction est importante pour choisir un périmètre réaliste et pour ne pas attribuer au dépôt une fonction que sa documentation ne mentionne pas.

Limites d'honnêteté et estimations étiquetées

agentacct est en alpha précoce et préfère montrer un écart plutôt qu'une supposition. Pas de tableau de bord hébergé, pas de télémétrie, pas de synchronisation automatique de compte cloud. Il peut recevoir de la télémétrie localement si vous pointez explicitement un exportateur OTLP vers lui. Les coûts sont des estimations d'un tableau de prix local, jamais des factures. Il ne lit que les fichiers de session locaux des clients détectés et ne surveille jamais les processus non liés démarrés en dehors d'agentacct/integrations. Les arrêts durs ne s'appliquent qu'aux exécutions lancées par agentacct lui-même ou au chemin proxy opt-in. Le support est par capacité, pas par logo. Claude Code et Codex ont aujourd'hui des chemins d'utilisation observés en direct ; d'autres clients (Hermes, OpenCode, OpenClaw, Cursor) ont des chemins plus étroits et explicitement limités. L'estimation du plan hebdomadaire Claude est en bêta et n'affiche un chiffre que lorsqu'il peut se calibrer sur votre compte à partir de votre propre historique de limites enregistré.

Dans mikehasa-agentacct, le point « Limites d'honnêteté et estimations étiquetées » doit être lu à partir des éléments effectivement cités par le README. Il décrit une capacité ou un contexte précis, sans établir à lui seul une promesse de performance, de sécurité ou de compatibilité. La distinction est importante pour choisir un périmètre réaliste et pour ne pas attribuer au dépôt une fonction que sa documentation ne mentionne pas.

Statut alpha, documentation et contribution

Les interfaces peuvent changer pendant qu'agentacct est en alpha. Le dépôt contient une documentation extensive : référence, manuel d'installation, table de vérité sur l'utilisation et les coûts, intégrations d'agents de codage, architecture, modèle de menace pour la vie privée, limites de sécurité, démo complète, preuves de fumée en direct, liste de contrôle alpha publique. Le développement est couvert dans CONTRIBUTING.md. Exécutez les tests à partir d'un clone avec pytest ; l'installation pipx ne fournit pas d'outils de test. Les demandes de commentaires incluent quel agent vous utilisez, quel problème de dérive ou de coût vous avez rencontré, quelle jointure semblait erronée et quelle intégration devrait être supportée ensuite. Ouvrez un problème, en supprimant toute clé API ou chemin privé des journaux avant de les partager.

Dans mikehasa-agentacct, le point « Statut alpha, documentation et contribution » doit être lu à partir des éléments effectivement cités par le README. Il décrit une capacité ou un contexte précis, sans établir à lui seul une promesse de performance, de sécurité ou de compatibilité. La distinction est importante pour choisir un périmètre réaliste et pour ne pas attribuer au dépôt une fonction que sa documentation ne mentionne pas.

Vérifier mikehasa-agentacct sur son chemin réel

Pour mikehasa/agentacct, installez Python 3.11 ou plus récent avec pipx, lancez agentacct onboard, puis ouvrez une nouvelle session d agent comme l indique README.md. Contrôlez agentacct status et l écran de la TUI; comparez les étiquettes client_reported, la confiance d attribution et les coûts estimés avec les journaux locaux. agentacct demo permet ensuite un essai jetable. Ne partagez aucun chemin privé ni clé dans les preuves.

Ce contrôle doit rester proportionné au projet. Notez la version, l entrée utilisée et la sortie obtenue, puis reliez chaque observation à un nom propre au dépôt. Une démonstration réussie ne prouve pas les scénarios non décrits; elle permet seulement de confirmer le chemin choisi et de repérer les écarts entre la documentation de mikehasa-agentacct et votre environnement.

Conclusion éditoriale

mikehasa-agentacct s adresse aux lecteurs dont le besoin correspond aux fonctions décrites dans son README. Il ne convient pas d en déduire des garanties absentes de cette source. Commencez par le chemin concret indiqué pour mikehasa-agentacct, contrôlez sa sortie et gardez séparées les capacités annoncées, les limites documentées et les résultats de votre environnement.

Sources officielles

  1. Official README
  2. Project repository
  3. Release notes
Notes de la communauté

Notes de la communauté