AgentsView peut réunir les journaux de sessions d’agents de programmation de plusieurs outils dans une archive locale permettant la recherche. Ce guide s’adresse à un responsable d’ingénierie qui doit retrouver une tâche connue, examiner les champs d’utilisation effectivement enregistrés par son agent et identifier la source de chaque montant de coût.

Ce parcours repose sur la documentation de la version v0.45.0 d’AgentsView du 9 octobre 2026 et sur les guides actuels de démarrage rapide et d’utilisation des jetons, consultés le 17 octobre. BIG CHANGE n’a pas installé AgentsView, importé de transcription ni testé ces étapes. Vérifiez la version installée, car la documentation et les listes de versions peuvent évoluer.

Avant de commencer

Il vous faut une session terminée d’un agent de programmation que vous êtes autorisé à lire, une expression distinctive ou l’ID de cette session et l’autorisation de lire son répertoire local de journaux. Le Quick Start répertorie des téléchargements pour ordinateur sur macOS, Windows et Linux, avec des paquets wheel de la CLI pour Linux x86_64 et aarch64, macOS x86_64 et arm64, ainsi que Windows x86_64 et arm64. L’application de bureau est fournie en paquet ; une compilation depuis les sources comporte des prérequis distincts pour Go, Node et CGO. Selon le démarrage rapide, l’archivage local de base ne nécessite ni compte sur un service hébergé ni clé API.

Les journaux peuvent contenir des prompts, du code source, des entrées d’outils et des secrets. Ne choisissez que les répertoires que votre équipe vous autorise à examiner. Décidez quels fournisseurs et répertoires racines l’archive peut ingérer avant son premier démarrage : un simple agentsview serve découvre et synchronise immédiatement les sources prises en charge par défaut. Pour cet exercice, laissez l’interface web sur son adresse de bouclage documentée. N’activez pas de synchronisation hébergée des données brutes, d’envois vers PostgreSQL ou ClickHouse, de publication sur Gist, d’analyses générées ou de point d’accès d’embeddings hébergé pour répondre à cette seule question. La recherche sémantique est facultative ; la recherche plein texte ordinaire fonctionne avec l’index local.

1. Installer et identifier l’exécutable

Choisissez une méthode dans le guide d’installation. Pour une CLI autonome, l’installation Python permanente documentée est la suivante :

Terminal
pip install agentsview
agentsview --version

Le guide propose aussi uvx agentsview pour une exécution sans installation permanente, des programmes d’installation par plateforme et des paquets de bureau. Sur macOS, le cask Homebrew relie la CLI fournie avec l’application ; pour une application installée depuis un DMG, il peut être nécessaire d’ajouter son répertoire CLI au PATH. Vérifiez quel exécutable votre shell trouve avant de vous fier à sa version. GitHub désigne v0.45.0 comme la version du 9 octobre, mais utilisez votre propre résultat de --version pour interpréter les écrans et le schéma du rapport.

2. Restreindre les sources avant la première synchronisation

Pour une installation de la CLI ou de l’application de bureau sur l’hôte, préparez un nouveau répertoire de données et son config.toml avant de démarrer AgentsView. Le guide de configuration décrit disabled_agents pour exclure des fournisseurs du système de fichiers local et [agents.<id>].dirs pour remplacer les racines par défaut d’un fournisseur. Inscrivez tous les ID des autres fournisseurs figurant dans le tableau Session Discovery de ce guide dans disabled_agents, puis réglez le dirs du seul fournisseur autorisé sur la racine approuvée. Par exemple, [agents.codex] avec dirs = ["/approved/codex/sessions"] remplace les répertoires par défaut de Codex ; adaptez le chemin à votre système. Si la liste d’exclusion n’est pas complète, ne démarrez pas encore le démon de l’hôte. Remplacer uniquement CODEX_SESSIONS_DIR ou CLAUDE_PROJECTS_DIR change la racine de ce fournisseur, mais laisse les autres éligibles à leur propre découverte par défaut.

Choisissez un nouveau répertoire pour AGENTSVIEW_DATA_DIR lors de cet audit si une archive existante peut déjà contenir des sessions sans rapport. Le guide de configuration précise que les sessions précédemment archivées de fournisseurs désactivés restent disponibles : changer ce réglage ne purge donc pas une ancienne archive. Il indique aussi que disabled_agents couvre la découverte et la surveillance locales, pas les importations ou exportations distantes ; laissez les hôtes distants et les destinations d’exportation non configurés pour cette tâche locale.

Un conteneur isolé est l’alternative lorsqu’il n’est pas pratique de tenir une liste d’exclusion de tous les autres fournisseurs. L’exemple Docker du Quick Start publie l’interface uniquement sur 127.0.0.1, monte une source d’agent en lecture seule et utilise un volume de données séparé. Montez uniquement la racine de la source autorisée et définissez sa variable de répertoire correspondante dans un nouveau conteneur ; omettez les autres montages de l’exemple Compose du projet. Un conteneur ne voit que les répertoires de sessions de l’hôte explicitement montés. Les images Docker publiées couvrent Linux amd64 et arm64 ; cette voie nécessite une installation Docker fonctionnelle.

3. Construire l’archive locale

Pour la CLI de l’hôte dont les sources sont délimitées, lancez le serveur au premier plan documenté :

Terminal
agentsview serve

Après avoir appliqué et vérifié le périmètre des sources à l’étape 2, cela initialise ~/.agentsview/sessions.db ou le répertoire de données choisi, découvre les journaux des agents activés, les synchronise, surveille les changements et ouvre http://127.0.0.1:8080. Gardez ce terminal ouvert. Si vous préférez un processus en arrière-plan, utilisez agentsview daemon start et agentsview daemon status ; l’application de bureau gère son propre backend. Un serveur compatible déjà actif peut simplement indiquer son URL : vérifiez donc si un démon tourne avant de supposer que la nouvelle configuration a régi l’ingestion.

Si vous avez choisi le conteneur isolé, vérifiez son unique montage de source en lecture seule et son nouveau volume de données, puis lancez-le avec la commande Docker documentée. Utilisez son interface de bouclage et exécutez les rapports CLI agentsview ultérieurs dans ce conteneur afin qu’ils lisent la même archive. N’exécutez pas simultanément sur l’hôte un serve sans restriction des sources.

Vérifiez que la source de la tâche connue apparaît et que les fournisseurs non souhaités n’apparaissent pas. Si la session manque, examinez le chemin approuvé, le réglage du fournisseur et l’état de synchronisation avant de conclure qu’elle n’existe pas. Exécutez agentsview sync si les fichiers récemment modifiés doivent être intégrés avant un rapport ; le serveur surveille aussi les changements. Revérifiez le périmètre configuré avant toute resynchronisation complète.

4. Retrouver la tâche et vérifier la transcription

Dans l’interface web, utilisez Ctrl/Cmd+K pour chercher une expression littérale distinctive de la tâche connue. Filtrez la liste par projet, agent ou date, puis ouvrez un résultat et vérifiez ses messages et appels d’outils. Si vous possédez déjà l’ID complet de la session ou son UUID, Ctrl/Cmd+G l’ouvre directement. Ces commandes sont documentées dans le Quick Start. Notez l’agent, l’ID de session et la date pour relier le résultat d’utilisation à la bonne conversation.

Si la recherche littérale ne trouve pas la tâche, essayez une expression plus courte et vérifiez que l’agent sous-jacent a écrit une transcription locale dans un répertoire lisible par AgentsView. Une tâche présente uniquement dans un service distant, un format non pris en charge ou un répertoire hors des racines configurées ne se retrouve pas en cherchant davantage. N’activez pas l’indexation sémantique ou le téléversement de transcriptions comme remède habituel à une source locale absente.

5. Examiner les champs d’utilisation de la session

Ouvrez la vue d’utilisation de la session retrouvée et repérez les champs enregistrés de modèle, d’entrée, de sortie, de création de cache et de lecture du cache qui sont présents. Le guide d’utilisation des jetons présente les rapports de coûts comme expérimentaux et encore en développement. AgentsView ingère les métadonnées de modèle et de jetons des journaux sources et conserve l’utilisation brute des jetons dans les lignes de messages. Il utilise les coûts explicites communiqués par une source lorsqu’ils sont disponibles ; sinon, il calcule un coût à partir des jetons exploitables et des tarifs du modèle. Les indications de provenance JSON les nomment reported, computed ou mixed.

Si vous voulez conserver un enregistrement lisible par machine de cette unique session, l’exemple CLI du projet utilise agentsview session usage SESSION_ID --format json. Remplacez SESSION_ID par l’ID vérifié dans la transcription, puis gardez le JSON avec votre note sur la tâche. Vérifiez le modèle indiqué, les catégories de jetons et la source du coût dans cette sortie avant de citer un total.

Traitez un champ vide ou un modèle absent comme inconnu. AgentsView ne peut pas reconstruire une utilisation que l’agent n’a jamais enregistrée. Les notes de version indiquent que l’ingestion Junie CLI exclut les conversations et appels d’outils qui n’existent que dans l’IDE, tandis que le repli en texte brut d’Antigravity contient la transcription sans utilisation de jetons ni coût. Ces exemples montrent concrètement qu’une session trouvable ne possède pas forcément un montant de dépense complet. Un montant communiqué par la source peut aussi décrire le total de la session, tandis que sa répartition par modèle reste estimée.

6. Délimiter le rapport journalier

Utilisez les filtres de date, de projet et d’agent de la page Usage pour examiner le jour contenant la session. La page propose aussi un tableau Top Sessions by Cost qui renvoie aux transcriptions individuelles. Pour un rapport vérifiable dans le terminal, remplacez la date locale de la session et le nom de l’agent dans :

Terminal
agentsview usage daily --since YYYY-MM-DD --until YYYY-MM-DD --agent codex --breakdown

Le tableau journalier sépare l’entrée non mise en cache, la sortie, la création de cache et les lectures du cache, avec des lignes par modèle lorsque --breakdown est défini. La date est regroupée selon le fuseau horaire du système, sauf si --timezone est fourni. Un total journalier peut inclure d’autres sessions de cet agent ; il sert à vérifier le périmètre et l’ordre de grandeur, pas à chiffrer cette seule tâche. Gardez l’ID de session avec le rapport journalier et vérifiez quelles lignes lui appartiennent réellement.

Pour un rapport sans récupération du catalogue de prix, ajoutez --offline. Selon AgentsView, cela lit l’archive existante sans synchroniser les sources ni démarrer le démon, en utilisant ses prix de repli intégrés. Actualisez d’abord l’archive si les modifications récentes de la session comptent ; un rapport hors ligne ne peut pas découvrir de nouveaux journaux. Les commandes d’utilisation normales peuvent récupérer les prix de LiteLLM et d’OpenRouter, tandis que le catalogue intégré vieillit avec la version installée.

7. Interpréter le montant et arrêter le service

Étiquetez chaque montant selon sa provenance. Computed signifie qu’AgentsView a multiplié les jetons enregistrés par les tarifs sélectionnés. Reported signifie que la source a fourni un coût explicite. Mixed signifie que le rapport combine plusieurs types. Même un montant communiqué par la source ne prouve pas qu’une facture du fournisseur pour l’ensemble du compte a été rapprochée des données. Comparez séparément les relevés de facturation ou du forfait du fournisseur concerné, notamment lorsque les niveaux de service, remises ou quotas inclus dans l’abonnement importent. La documentation d’AgentsView précise qu’il ne peut pas déduire les prix Batch, Flex, Priority, régionaux ou du cache d’une heure si l’utilisation stockée omet ce niveau. Certains jetons côté outil sont absents des transcriptions locales.

Le critère de réussite est une transcription retrouvée dont l’agent, l’ID et la date correspondent à la vue d’utilisation choisie, avec les champs de modèle et de jetons disponibles consignés et les champs indisponibles marqués comme inconnus. Le résultat est une archive locale permettant la recherche et une note d’utilisation de la tâche ou du jour au périmètre délimité, pas une facture. Arrêtez un agentsview serve au premier plan avec Ctrl+C, ou arrêtez un serveur en arrière-plan avec agentsview daemon stop. Le Quick Start précise qu’arrêter le démon arrête à la fois l’interface web et la surveillance des sessions.

Le grand changement

Une transcription locale donne à la discussion sur les coûts un point de départ traçable. Le responsable d’ingénierie peut remonter d’un montant à une tâche enregistrée précise et voir s’il vient de l’agent ou d’un catalogue de prix. Lorsque le journal est incomplet, le rapport doit préserver cette lacune.

Sources et lectures complémentaires

  • Notes de version d’AgentsView v0.45.0 : changements datés de la couverture des agents, des cartes Usage, de la synchronisation et du comportement des prix. Une note de version est un document du fournisseur, pas un test de BIG CHANGE.
  • AgentsView Quick Start : méthodes d’installation prises en charge, commandes de serveur et de démon, configuration des sources et commandes de recherche locale.
  • Configuration d’AgentsView : découverte des sources, exclusion des fournisseurs, emplacement de l’archive et limites de ces contrôles.
  • Utilisation des jetons et coûts d’AgentsView : couverture des sources, rapports d’utilisation, provenance des prix, mode hors ligne et limites connues des rapports.
  • Dépôt AgentsView : code source et licence MIT ; le dépôt décrit l’archive par défaut comme locale.