pagent – Agent-Transkripte lesen

pagent

Übersicht

Finde einen Paseo-Agenten und lies seine Konversation, ohne jedes Mal neu entdecken zu müssen, wo Paseo Dinge ablegt. pagent liest nur: Es startet, stoppt, lenkt oder reanimiert nie einen Agenten und es fordert den Dämon nie auf, einen geschlossenen Agenten neu zu laden.

Aufruf

SKILL=<Basisverzeichnis dieses Skills>/pagent.py   # die Harness gibt das Basisverzeichnis oben aus

python3 $SKILL 11111111-1111-4111-8111-111111111111   # Kopfzeile: Status, cwd, Modell, Transkriptpfad
python3 $SKILL 11111111 --task                        # + jede vom Benutzer gegebene Anweisung
python3 $SKILL 11111111 -t -n 20                      # + die letzten 20 Wendungen
python3 $SKILL 11111111 -t --full                     # Wendungen ungekürzt
python3 $SKILL "Rechnungsexport"                      # Suche nach Titel
python3 $SKILL                                        # alle Agenten, neueste zuerst

Eine Anfrage ist eine ID, ein ID-Präfix oder eine case-insensitive Teilzeichenkette des Titels. Mehrere Treffer werden als Liste ausgegeben; ein einzelner Treffer zeigt die Detailansicht. python3 $SKILL --help gibt die Verwendung aus.

Schritte

1. Agent auflösen. Führe die Anfrage ohne Flags aus: Die Kopfzeile zeigt Status, Arbeitsverzeichnis, Modell und den Transkriptpfad. Eine Liste bedeutet, dass die Anfrage mehrdeutig war; grenze sie mit einer ID oder einem längeren Titel-Fragment ein.
2. Lesen, was gefragt wurde. --task gibt jede Anweisung des Benutzers aus, nicht nur die erste. Die erste Zeile nennt das Thema; die Korrekturen zwei Nachrichten später enthalten die Entscheidungen („Verwende Option B, behalte aber das Wiederholungslimit bei drei"). Beide werden ausgegeben; Präambel der Harness und eingefügte Skill-Körper werden nicht ausgegeben. Dies ist besonders wichtig, wenn man die Arbeit eines Agenten übernimmt – siehe das ptakeover-Skill.
3. Lesen, wie weit er gekommen ist. -t -n <Wendungen> gibt das Ende des Gesprächs aus; füge --full hinzu, wenn eine Wendung abgeschnitten wurde. Lesen ist sicher, während der Agent läuft, da das Transkript nur an Anhängt wird.
4. Nachbarn prüfen. Ein Agent, dessen cwd mit deinem übereinstimmt, könnte dieselben Dateien bearbeiten. Führe git status aus, bevor du annimmst, dass ein unerwarteter Diff von dir stammt.

Mit -t oder --task liefert ein fehlendes Transkript einen Fehlercode ungleich Null. Ein stilles 0 würde als „Der Agent hat nichts gesagt" interpretiert werden, was die falsche Schlussfolgerung für jeden wäre, der eine Aufgabe rekonstruiert.

Wo die Daten liegen

• Agent-Metadaten: ~/.paseo/agents/<Workspace>/<ID>.json — Titel, lastStatus (running / idle / …), cwd, Modell, requiresAttention, Zeitstempel.
• Konversation: nicht in dieser Datei. Sie lebt in der Harness, die sie geschrieben hat, abhängig von persistence.sessionId:
  • Claude Code — <Konfiguration>/projects/<escaped-cwd>/<sessionId>.jsonl. claude-rotate behält ein Konfigurationsverzeichnis pro Konto, daher kann es unter ~/.claude oder unter einem beliebigen ~/.config/claude-rotate/configs/*/ liegen — das Skript durchsucht alle, anstatt den escaped-pfad zu erraten.
  • Codex — ~/.codex/sessions/<J>/<M>/<T>/rollout-<Stempel>-<sessionId>.jsonl, ein anderes Datensatzformat (payload.type), das der Parser zusammen mit Claudes verarbeitet. Das Archivieren eines Agenten verschiebt den Rollout in das flache ~/.codex/archived_sessions/.
  • Antigravity — sessionId ist ein plugin:{…"conversationId":…}-Wrapper; der Verlauf ist ~/.gemini/antigravity-cli/brain/<conversationId>/.system_generated/logs/transcript_full.jsonl (Datensätze, die nach step_index indiziert sind). Nicht conversations/<id>.db, dieser ist Protobuf. Agenten des älteren antigravity-acp-Anbieters haben dieses Log nie geschrieben, daher haben sie keinen lesbaren Verlauf.

Mit einem Agenten sprechen, auf einen warten

Dieses Skill liest nur. Für den Rest:

• Sprechen: paseo send <ID> "<Text>" --behavior steer --no-wait. Der agentenbezogene CLI und send_agent_prompt-Aufrufe verwenden standardmäßig Steuerung; ein explizites Verhalten funktioniert auch außerhalb eines Agenten. Steuerung kann auf Unterbrechung zurückfallen, wenn der Anbieter es nicht akzeptieren kann (z. B. während der Komprimierung). --no-wait kehrt nach dem Versand zurück; es stellt die Nachricht nicht hinter die Wendung in die Warteschlange.
• Nichts versehentlich wiederbeleben: paseo send reanimiert einen archivierten Agenten, überprüfe daher zuerst ArchivedAt in paseo inspect <ID> --json. Reanimiere niemals einen archivierten Agenten, nur um einen Bericht zu übermitteln; hinterlasse die Informationen bei seiner Arbeit (einem TODO, Protokoll oder Commit) oder teile es dem Benutzer mit.
• Warten: paseo-notify <ID>, beende dann deinen Zug – eine Nachricht trifft ein, wenn er anhält. Außerhalb von paseo: paseo wait <ID> --json, im Hintergrund; lese status (idle, permission, error, timeout) aus dem JSON – der Exit-Code ist für alle 0. Warte niemals mit sleep, Monitor, /loop oder einer Abfrage von paseo ls/logs/inspect.

Häufige Fehler

Fehler	Korrektur
Allein auf Grundlage der ersten Anfrage übernehmen	--task gibt auch jede spätere Korrektur aus; sie enthalten die Entscheidungen
paseo logs zum Lesen eines geschlossenen oder archivierten Agenten	Es zwingt den Dämon, die Sitzung des Agenten nur zum Lesen neu zu laden; verwende dieses Skill, das nur Dateien liest
Ein stilles Beenden als „Der Agent hat nichts gesagt" interpretieren	Ein fehlendes Transkript endet mit einem Fehlercode; überprüfe den Exit-Code und den Transkriptpfad in der Kopfzeile
Senden eines Berichts an einen archivierten Agenten	paseo send reanimiert ihn; überprüfe zuerst ArchivedAt und hinterlasse den Bericht stattdessen bei seiner Arbeit
Warten auf einen Agenten mit sleep, Monitor, /loop oder wiederholtem paseo ls/logs/inspect	paseo-notify <ID> und beende deinen Zug
Behandle einen unerwarteten Diff als deinen eigenen, wenn der Agent dein cwd teilt	Überprüfe git status; der Agent könnte dieselben Dateien bearbeiten