Markdown-Ausgabe

AI-translated from English; not yet reviewed by a fluent editor.

# Eine Coding-Agent-Sitzung mit AgentsView prüfen

> Finden Sie in AgentsView ein bekanntes lokales Coding-Agent-Transkript, prüfen Sie erfasste Token und die Herkunft der Kostenangaben und lesen Sie einen klar begrenzten Tagesbericht, ohne Schätzungen mit Rechnungen gleichzusetzen.

By BIG CHANGE Editorial

Published: 2026-10-17T17:20:34.907Z
Updated: 2026-10-17T17:20:34.907Z
Canonical: https://bigchange.ai/blog/audit-coding-agent-session-agentsview

![Conceptual charcoal illustration of a local computer with one blank transcript line highlighted and an external drive beside it.](https://bigchange.ai/api/media/file/agentsview-local-session-audit-concept-v1.png)
AI-generated conceptual illustration by BIG CHANGE; no actual AgentsView interface, transcript, usage figure or billing result is depicted.

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](https://www.agentsview.io/docs/quickstart/) 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](https://www.agentsview.io/docs/quickstart/). Für eine eigenständige CLI ist diese dauerhafte Python-Installation dokumentiert:

```sh
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](https://github.com/kenn-io/agentsview/releases/tag/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](https://www.agentsview.io/docs/configuration/#disabling-session-providers) 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](https://www.agentsview.io/docs/configuration/#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](https://www.agentsview.io/docs/quickstart/#docker) 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](https://github.com/kenn-io/agentsview/blob/main/docker-compose.prod.yaml) 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:

```sh
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](https://www.agentsview.io/docs/quickstart/) 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](https://www.agentsview.io/docs/token-usage/) 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](https://www.agentsview.io/) 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:

```sh
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](https://www.agentsview.io/docs/quickstart/) 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

- [Versionshinweise zu AgentsView v0.45.0](https://github.com/kenn-io/agentsview/releases/tag/v0.45.0): datierte Änderungen bei Agentenabdeckung, Usage-Karten, Synchronisierung und Preisverhalten. Ein Versionshinweis ist eine Anbieteraufzeichnung, kein Test von BIG CHANGE.
- [AgentsView Quick Start](https://www.agentsview.io/docs/quickstart/): unterstützte Installationswege, Server- und Daemon-Befehle, Quellkonfiguration und lokale Suchfunktionen.
- [AgentsView-Konfiguration](https://www.agentsview.io/docs/configuration/): Quellerkennung, Anbieterausschluss, Archivspeicherort und Grenzen dieser Steuerungsmöglichkeiten.
- [Token-Nutzung und Kosten in AgentsView](https://www.agentsview.io/docs/token-usage/): Quellabdeckung, Nutzungsberichte, Preisherkunft, Offline-Modus und bekannte Berichtsgrenzen.
- [AgentsView-Repository](https://github.com/kenn-io/agentsview): Quellcode und MIT-Lizenz; das Repository beschreibt das Standardarchiv als lokal.

## Sources

- [Versionshinweise zu AgentsView v0.45.0](https://github.com/kenn-io/agentsview/releases/tag/v0.45.0) — Datierte Version sowie Funktions- und Abdeckungsänderungen.
- [AgentsView Quick Start](https://www.agentsview.io/docs/quickstart/) — Installation, Ausführung, Quellauswahl und Suchfunktionen.
- [AgentsView-Konfiguration](https://www.agentsview.io/docs/configuration/) — Quellerkennung, Anbieterausschlüsse, Datenverzeichnis und Grenzen der Steuerungsmöglichkeiten.
- [Token-Nutzung und Kosten in AgentsView](https://www.agentsview.io/docs/token-usage/) — Experimentelle Nutzungsberichte, Preisherkunft und Grenzen.
- [AgentsView-Quellcode-Repository](https://github.com/kenn-io/agentsview) — Quellcode, Projektbeschreibung und MIT-Lizenz.