AgentsView kann Sitzungsprotokolle von Coding-Agenten aus mehreren Werkzeugen in einem durchsuchbaren lokalen Archiv zusammenführen. Dieser Leitfaden richtet sich an eine technische Teamleitung, die eine bekannte Aufgabe finden, die vom Agenten tatsächlich erfassten Nutzungsfelder prüfen und die Quelle jeder Kostenangabe bestimmen möchte.

Diese Anleitung basiert auf der Dokumentation zur AgentsView-Version v0.45.0 vom 9. Oktober 2026 sowie den aktuellen Schnellstart- und Token-Nutzungsleitfäden, geprüft am 17. Oktober. BIG CHANGE hat AgentsView weder installiert noch ein Transkript importiert oder diese Schritte getestet. Prüfen Sie die installierte Version, da sich Dokumentation und Versionslisten ändern können.

Bevor Sie beginnen

Sie benötigen eine abgeschlossene Coding-Agent-Sitzung, die Sie lesen dürfen, eine markante Formulierung oder Sitzungs-ID dieser Aufgabe sowie die Berechtigung zum Lesen des lokalen Protokollverzeichnisses. Der Quick Start nennt Desktop-Downloads für macOS, Windows und Linux sowie CLI-Wheels für Linux x86_64 und aarch64, macOS x86_64 und arm64 sowie Windows x86_64 und arm64. Die Desktop-App wird als Paket geliefert; ein Build aus dem Quellcode hat eigene Anforderungen an Go, Node und CGO. Laut Schnellstart erfordert die grundlegende lokale Archivierung weder ein Konto bei einem gehosteten Dienst noch einen API-Schlüssel.

Sitzungsprotokolle können Prompts, Quellcode, Werkzeugeingaben und Geheimnisse enthalten. Wählen Sie nur Verzeichnisse, deren Prüfung Ihr Team erlaubt. Entscheiden Sie, welche Anbieter und Stammverzeichnisse das Archiv einlesen darf, und zwar vor dem ersten Start: Ein einfaches agentsview serve entdeckt und synchronisiert die standardmäßig unterstützten Quellen sofort. Belassen Sie die Weboberfläche für diese Übung auf der dokumentierten Loopback-Adresse. Aktivieren Sie nicht allein für diese Frage gehostete Rohdatensynchronisierung, Übertragungen an PostgreSQL oder ClickHouse, Gist-Veröffentlichung, generierte Erkenntnisse oder einen gehosteten Embedding-Endpunkt. Semantische Suche ist optional; gewöhnliche Volltextsuche funktioniert mit dem lokalen Index.

1. Installieren und die ausführbare Datei bestimmen

Wählen Sie eine Methode aus der Installationsanleitung. Für eine eigenständige CLI ist diese dauerhafte Python-Installation dokumentiert:

Terminal
pip install agentsview
agentsview --version

Die Anleitung bietet außerdem uvx agentsview für die Ausführung ohne dauerhafte Installation, plattformspezifische Installer und Desktop-Pakete. Unter macOS verknüpft der Homebrew-Cask die mit der App gebündelte CLI; bei einer aus einem DMG installierten App muss gegebenenfalls deren CLI-Verzeichnis zu PATH hinzugefügt werden. Prüfen Sie, welche ausführbare Datei Ihre Shell findet, bevor Sie deren Versionsangabe vertrauen. GitHub kennzeichnet v0.45.0 als Version vom 9. Oktober. Verwenden Sie beim Interpretieren der Ansichten und des Berichtsschemas jedoch Ihr eigenes --version-Ergebnis.

2. Quellen vor der ersten Synchronisierung begrenzen

Richten Sie für eine CLI- oder Desktop-Installation auf dem Host ein neues Datenverzeichnis und dessen config.toml vor dem Start von AgentsView ein. Die Konfigurationsanleitung beschreibt disabled_agents zum Ausschließen lokaler Dateisystemanbieter und [agents.<id>].dirs zum Ersetzen der standardmäßigen Stammverzeichnisse eines Anbieters. Tragen Sie alle anderen Anbieter-IDs aus der dortigen Tabelle Session Discovery in disabled_agents ein und setzen Sie das dirs des einen zugelassenen Anbieters auf das genehmigte Stammverzeichnis. Beispielsweise ersetzt [agents.codex] mit dirs = ["/approved/codex/sessions"] die Standardverzeichnisse von Codex; passen Sie den Pfad an Ihr System an. Starten Sie den Host-Daemon noch nicht, wenn die Ausschlussliste unvollständig ist. Eine einzelne Überschreibung von CODEX_SESSIONS_DIR oder CLAUDE_PROJECTS_DIR ändert das Stammverzeichnis dieses Anbieters, lässt andere Anbieter aber weiterhin für ihre eigene standardmäßige Erkennung zu.

Verwenden Sie für diese Prüfung ein neues AGENTSVIEW_DATA_DIR, falls ein bestehendes Archiv bereits nicht zugehörige Sitzungen enthalten könnte. Laut Konfigurationsanleitung bleiben zuvor archivierte Sitzungen deaktivierter Anbieter verfügbar; die geänderte Einstellung leert also kein altes Archiv. Außerdem umfasst disabled_agents die lokale Erkennung und Überwachung, nicht aber entfernte Importe oder Exporte. Lassen Sie für diese lokale Aufgabe entfernte Hosts und Exportziele unkonfiguriert.

Ein isolierter Container ist die Alternative, wenn eine Ausschlussliste für alle anderen Anbieter unpraktikabel ist. Das Docker-Beispiel im Quick Start veröffentlicht die Oberfläche nur unter 127.0.0.1, bindet eine Agentenquelle schreibgeschützt ein und verwendet ein separates Daten-Volume. Binden Sie nur das genehmigte Quellstammverzeichnis ein und setzen Sie in einem neuen Container die zugehörige Verzeichnisvariable; lassen Sie die anderen Einbindungen aus dem Compose-Beispiel des Projekts weg. Ein Container sieht nur ausdrücklich eingebundene Sitzungsverzeichnisse des Hosts. Die veröffentlichten Docker-Images decken Linux amd64 und arm64 ab; dieser Weg setzt eine funktionierende Docker-Installation voraus.

3. Das lokale Archiv aufbauen

Starten Sie für die Host-CLI mit begrenztem Quellumfang den dokumentierten Vordergrundserver:

Terminal
agentsview serve

Nachdem Sie den Quellumfang in Schritt 2 eingestellt und geprüft haben, initialisiert dies ~/.agentsview/sessions.db beziehungsweise das gewählte Datenverzeichnis, entdeckt Protokolle aktivierter Agenten, synchronisiert sie, überwacht Änderungen und öffnet http://127.0.0.1:8080. Lassen Sie dieses Terminal geöffnet. Für einen Hintergrundprozess verwenden Sie agentsview daemon start und agentsview daemon status; die Desktop-App verwaltet ihr eigenes Backend. Ein bereits laufender kompatibler Server gibt möglicherweise nur seine URL zurück. Prüfen Sie deshalb auf einen laufenden Daemon, bevor Sie annehmen, die neue Konfiguration habe den Datenimport gesteuert.

Wenn Sie den isolierten Container gewählt haben, prüfen Sie seine einzelne schreibgeschützte Quelleinbindung und sein neues Daten-Volume und starten ihn dann mit dem dokumentierten Docker-Befehl. Verwenden Sie seine Loopback-Oberfläche und führen Sie die späteren agentsview-CLI-Berichte in diesem Container aus, damit sie dasselbe Archiv lesen. Starten Sie nicht gleichzeitig auf dem Host den Befehl serve ohne Quellbegrenzung.

Prüfen Sie, ob die Quelle der bekannten Aufgabe erscheint und unerwünschte Anbieter nicht erscheinen. Fehlt die Sitzung, kontrollieren Sie genehmigten Pfad, Anbietereinstellung und Synchronisierungsstatus, bevor Sie auf eine nicht vorhandene Sitzung schließen. Führen Sie agentsview sync aus, wenn neue Dateiänderungen vor einem Bericht übernommen werden müssen; der Server überwacht Änderungen ebenfalls. Prüfen Sie den konfigurierten Umfang vor jeder vollständigen Neusynchronisierung erneut.

4. Die Aufgabe finden und das Transkript überprüfen

Verwenden Sie in der Weboberfläche Ctrl/Cmd+K, um eine markante wörtliche Formulierung der bekannten Aufgabe zu suchen. Grenzen Sie die Liste nach Projekt, Agent oder Datum ein, öffnen Sie einen Kandidaten und prüfen Sie dessen Nachrichten und Werkzeugaufrufe. Wenn Ihnen bereits die vollständige Sitzungs-ID oder UUID vorliegt, öffnet Ctrl/Cmd+G die Sitzung direkt. Diese Bedienelemente sind im Quick Start dokumentiert. Notieren Sie Agent, Sitzungs-ID und Datum, damit sich das Nutzungsergebnis dem richtigen Gespräch zuordnen lässt.

Findet die wörtliche Suche die Aufgabe nicht, versuchen Sie eine kürzere Formulierung und prüfen Sie, ob der zugrunde liegende Agent ein lokales Transkript in ein von AgentsView lesbares Verzeichnis geschrieben hat. Eine Aufgabe, die nur in einem entfernten Dienst, einem nicht unterstützten Format oder einem Verzeichnis außerhalb der konfigurierten Stammverzeichnisse vorliegt, lässt sich nicht durch intensiveres Suchen wiederfinden. Aktivieren Sie semantische Indexierung oder Transkript-Uploads nicht als routinemäßige Lösung für eine fehlende lokale Quelle.

5. Die Nutzungsfelder der Sitzung prüfen

Öffnen Sie die Nutzungsansicht der gefundenen Sitzung und bestimmen Sie, welche erfassten Felder für Modell, Eingabe, Ausgabe, Cache-Erstellung und Cache-Lesen vorhanden sind. Die Anleitung zur Token-Nutzung bezeichnet die Kostenberichterstattung als experimentell und noch in Entwicklung. AgentsView liest Modell- und Token-Metadaten aus Quellprotokollen ein und bewahrt die rohen Token-Nutzungsdaten in Nachrichtenzeilen auf. Sofern vorhanden, nutzt es ausdrücklich von einer Quelle gemeldete Kosten; andernfalls berechnet es Kosten aus nutzbaren Token-Angaben und Modellpreisen. Seine JSON-Herkunftsangaben nennen diese reported, computed oder mixed.

Wenn Sie einen maschinenlesbaren Datensatz für diese einzelne Sitzung speichern möchten: Das CLI-Beispiel des Projekts verwendet agentsview session usage SESSION_ID --format json. Ersetzen Sie SESSION_ID durch die im Transkript überprüfte ID und bewahren Sie die JSON-Datei zusammen mit Ihrer Aufgabennotiz auf. Kontrollieren Sie in dieser Ausgabe das gemeldete Modell, die Token-Kategorien und die Kostenquelle, bevor Sie einen Gesamtbetrag nennen.

Behandeln Sie ein leeres Feld oder ein fehlendes Modell als unbekannt. AgentsView kann keine Nutzung rekonstruieren, die der Agent nie aufgezeichnet hat. Laut Versionshinweisen schließt der Junie-CLI-Import Gespräche und Werkzeugaufrufe aus, die nur in der IDE vorliegen; der Klartext-Fallback von Antigravity enthält dagegen Transkriptinhalte ohne Token-Nutzung oder Kosten. Das sind konkrete Beispiele dafür, dass eine durchsuchbare Sitzung keine vollständige Ausgabenangabe haben muss. Ein gemeldeter Quellbetrag kann außerdem die gesamte Sitzung betreffen, während die Aufteilung nach Modellen eine Schätzung bleibt.

6. Den Tagesbericht eingrenzen

Prüfen Sie den Tag der Sitzung mit den Datums-, Projekt- und Agentenfiltern der Seite Usage. Die Seite bietet außerdem die Tabelle Top Sessions by Cost mit Links zu einzelnen Transkripten. Ersetzen Sie für einen überprüfbaren Terminalbericht das lokale Sitzungsdatum und den Agentennamen in:

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

Die Tagestabelle trennt nicht zwischengespeicherte Eingabe, Ausgabe, Cache-Erstellung und Cache-Lesezugriffe; bei gesetztem --breakdown erscheinen Zeilen je Modell. Das Datum wird nach der Systemzeitzone gruppiert, sofern nicht --timezone angegeben wird. Eine Tagessumme kann andere Sitzungen desselben Agenten enthalten; sie dient zur Prüfung von Umfang und Größenordnung, ist aber nicht der Preis der einen Aufgabe. Bewahren Sie die Sitzungs-ID beim Tagesbericht auf und prüfen Sie, welche Zeilen tatsächlich dazugehören.

Fügen Sie für einen Bericht ohne Abruf des Preiskatalogs --offline hinzu. Laut AgentsView liest dies das vorhandene Archiv ohne Quellsynchronisierung oder Daemon-Start und verwendet die eingebetteten Ersatzpreise. Aktualisieren Sie das Archiv vorher, wenn jüngste Sitzungsänderungen wichtig sind; ein Offline-Bericht kann keine neuen Protokolle entdecken. Normale Nutzungsbefehle rufen möglicherweise Preise von LiteLLM und OpenRouter ab, während der eingebettete Katalog mit der installierten Version altert.

7. Die Zahl einordnen und den Dienst beenden

Kennzeichnen Sie jede Zahl entsprechend ihrer Herkunft. Computed bedeutet, dass AgentsView erfasste Token mit gewählten Preisen multipliziert hat. Reported bedeutet, dass die Quelle ausdrückliche Kosten geliefert hat. Mixed bedeutet, dass der Bericht mehrere Arten kombiniert. Selbst eine von der Quelle gemeldete Zahl beweist nicht, dass eine Anbieterrechnung für das gesamte Konto abgeglichen wurde. Vergleichen Sie die eigenen Abrechnungs- oder Tarifunterlagen des betreffenden Anbieters unabhängig, besonders bei relevanten Service-Stufen, Rabatten oder Abonnementkontingenten. Laut AgentsView-Dokumentation kann es keine Batch-, Flex-, Priority-, regionalen oder Ein-Stunden-Cache-Preise ableiten, wenn diese Stufe in der gespeicherten Nutzung fehlt. Manche werkzeugseitigen Token fehlen in lokalen Transkripten.

Als Erfolg gilt ein gefundenes Transkript, dessen Agent, ID und Datum mit der ausgewählten Nutzungsansicht übereinstimmen, wobei vorhandene Modell- und Token-Felder dokumentiert und nicht verfügbare Felder als unbekannt markiert sind. Das Ergebnis ist ein durchsuchbares lokales Archiv und eine begrenzte Nutzungsnotiz zur Aufgabe beziehungsweise zum Tag, keine Rechnung. Beenden Sie ein im Vordergrund laufendes agentsview serve mit Ctrl+C oder einen Hintergrundserver mit agentsview daemon stop. Der Quick Start erklärt, dass das Beenden des Daemons sowohl die Weboberfläche als auch die Sitzungsüberwachung stoppt.

Die große Veränderung

Ein lokales Transkript bietet einen nachvollziehbaren Ausgangspunkt für die Kostendiskussion. Die technische Teamleitung kann einen Betrag zu einer bestimmten protokollierten Aufgabe zurückverfolgen und sehen, ob er vom Agenten oder aus einem Preiskatalog stammt. Wo das Protokoll unvollständig ist, sollte der Bericht diese Lücke erhalten.

Quellen und weiterführende Lektüre