Amiyadesi/agent-session-bridge

Agentensitzungen migrieren

Verwenden Sie asb / agent-session-bridge; JSON-Stdout ist die Maschinenschnittstelle. Das CLI verwendet lokale Dateien, führt keine Modellaufrufe durch und lädt niemals Transkripte hoch. Kopieren und Verschieben umfassen nur Gesprächskontext: Benutzer-/Assistentennachrichten, Komprimierungszusammenfassungen und unterstützte Benutzerbilder. Tool-Aufrufe/-Ergebnisse, Denkprozesse und System-/Laufzeitaufzeichnungen werden automatisch herausgefiltert. Die Anzahl erscheint als filtered:* im Manifest; kein zusätzliches Flag erforderlich. Behalten Sie den Quellentitel bei, wenn das Ziel dies unterstützt. Native Codex-Titel stammen aus der passenden Datenbankzeile (name, dann title); eigenständige Exporte benötigen einen Titel im Log. Quellmodell/-Anbieter und Denkeinstellungen werden ausgeschlossen. Verwenden Sie einen installierten Befehl oder das .venv/Scripts/asb.exe (Windows) / .venv/bin/asb (POSIX) des Checkouts. Wenn nicht installiert, benötigt dieses Projekt Python 3.14+; erstellen Sie ein Projekt-Venv und führen Sie dort python -m pip install -e . aus.

Sitzungen auswählen

• Einzelne Datei: asb inspect <datei> dann asb convert <datei> --to pi.
• Exakte ID: asb convert --from codex --session <vollständige-id> --to pi.
• Projekt: asb list --from codex --project <absolutes-verzeichnis>, dann asb convert --from codex --to pi --project <absolutes-verzeichnis>.
• Exportverzeichnis: asb convert <verzeichnis> --from codex --to pi.
• Ein Projektfilter gleicht das aufgezeichnete Arbeitsverzeichnis und dessen Unterverzeichnisse über Pfadgrenzen ab. Er durchsucht keine Nachrichtentexte.
• --source-root überschreibt einen Quellspeicher; --target-home ist das Ziel-Agenten-Basisverzeichnis (nicht dessen sessions-Verzeichnis).
• Verwenden Sie --cwd nur, wenn der Benutzer beabsichtigt, das Arbeitsverzeichnis zu verschieben.
• Pi erfordert ein Zielmodell, da es die Modellauswahl aus historischen Assistentennachrichten wiederherstellt. Das CLI liest Vorgaben aus settings.json des Ziel-Basisverzeichnisses, dann aus .pi/settings.json des Ziel-CWD; --provider / --model überschreiben diese. Ohne vollständige Zielvorgaben geben Sie das beabsichtigte Zielpaar an. Ersetzen Sie niemals das Quellmodell. Es werden keine Einstellungsdateien geändert.

Unterstützte Namen: codex, pi, dsh, opencode, qwen, claude, workbuddy, antigravity, antigravity-desktop. Verwenden Sie asb formats / asb convert --help für verfügbare Optionen.

Ausführen

Führen Sie zuerst ohne --apply aus. Lesen Sie count, errors, source, target, dropped_events und warnings. Melden Sie die ausgewählte Menge und Materialverluste, ohne Gesprächsinhalte auszugeben. Beheben Sie unerwartete Übereinstimmungen oder nicht unterstützte Inhalte, bevor Sie eine destruktive Verschiebung durchführen.

• Der Benutzer bittet um Kopieren, oder lässt die Aufbewahrung unbestimmt: hängen Sie --apply an; Quellen behalten.
• Der Benutzer fordert explizit an, diese Quellsitzungen zu verschieben / auszuschneiden / zu löschen: hängen Sie --move --apply an.
• Bereits erteilte Autorisierung beibehalten. Nur nachfragen, wenn die Löschabsicht oder die ausgewählte Menge unklar ist.
• Aktive Quellunterhaltungen vor einer Verschiebung stoppen. Das CLI lehnt während der Konvertierung geänderte Quellen ab, kann aber nicht verhindern, dass ein anderer Client schreibt.
• Ersetzen Sie niemals manuelles rm, del oder rekursives Löschen durch die überprüfte Verschiebung des CLI.
• Überprüfen Sie jedes Ergebnis/jeden Fehler in einer Stapelverarbeitung. Ein Exit-Code ungleich Null kann teilweisen Erfolg bedeuten; wiederholen Sie nicht blind erfolgreiche Elemente, die neue IDs erhalten.

Das CLI überprüft geschriebene Bytes, parst das Ziel und registriert erforderliche native Datenbankzeilen vor dem Löschen. Die Quellbereinigung zielt nur auf die ausgewählte Sitzungs-ID, das passende Transkript und bekannte Indizes. Diese Prüfung ruft kein Modell auf. Verwenden Sie das zurückgegebene resume-Argv als Befehlsvorschlag; die native ID-Suche geht vom normalen Ziel-Basisverzeichnis aus. Für benutzerdefinierte Ziel-Basisverzeichnisse starten Sie den Client mit seiner entsprechenden Basisverzeichnis-Umgebungsüberschreibung.

Formatbeschränkungen

• Native OpenCode-Auswahl: asb convert --from opencode --session <id> --to pi --move --apply. Die Standardauswahl liest seine Datenbank; --source-root kann auf das Verzeichnis mit opencode.db zeigen. Eine manuell gelieferte JSON-Exportdatei ist eine eigenständige Datei; das Ausschneiden dieses Exports löscht nicht die ursprüngliche Datenbank-Sitzung.
• Native Ziel-Basisverzeichnisse von Codex / WorkBuddy / OpenCode / Antigravity müssen bereits client-initialisierte Datenbanken enthalten. Unbekannte Schemata oder erforderliche Felder schlagen klar fehl. Verwenden Sie --output-dir für portable Dateien ohne Datenbankregistrierung.
• Starten Sie für ein Git-Projekt OpenCode einmal im gewünschten Arbeitsverzeichnis, um seinen Projektindex vor dem Import dort zu initialisieren.
• WorkBuddy behandelt lokale Sitzungen und seine Datenbank/den Cache. Mehrere Zielkonten erfordern --workbuddy-user-id. Fortsetzen über WorkBuddy's Sitzungsliste. Blob-Bilder werden ausgelassen und gezählt.
• DSH liest v4 JSONL/zstd. Ältere Logs müssen zuerst von DSH aktualisiert werden. Mehrere Generationen blockieren eine Verschiebung.
• DSH-Bilder werden derzeit ausgelassen und gezählt. Zusammenfassungen werden zu gekennzeichnetem Benutzerkontext.
• Antigravity meint das agy-CLI-SQLite-Format, nicht direkten Desktop .pb oder verschlüsselten Speicher. Sein Basisverzeichnis ist ~/.gemini/antigravity-cli; verwenden Sie --source-root / --target-home für Überschreibungen. Schließen Sie Clients, die dieses Basisverzeichnis verwenden, vor nativen Schreib-/Löschvorgängen. Aktive Presence-Locks und WAL/SHM/Journal-Dateien blockieren Löschvorgänge.
• Antigravity verwendet eine sitzungsspezifische Datenbank, gemeinsam genutzte conversation_summaries.db, jetbox_summaries_proto.pb, annotations/<id>.pbtxt und den Letzte-Unterhaltung-Cache. Das CLI schreibt und entfernt die ausgewählten Datensätze gemeinsam. Bewahren Sie portable .db- und .manifest.json-Dateien zusammen auf, um Titel/CWD-Metadaten zu erhalten. Zusammenfassungen werden zu gekennzeichnetem Benutzerkontext, Bilder werden ausgelassen und gezählt.
• antigravity-desktop unterstützt IDE 2.5.5 SQLite .db-Sitzungen, mit Quell-/Ziel-Basisverzeichnis ~/.gemini/antigravity-ide (älteres SQLite-Basisverzeichnis ~/.gemini/antigravity). Beispiel: asb convert --from codex --to antigravity-desktop --project <verzeichnis> --apply. Wählen Sie eine Desktop-ID oder ein Projekt wie bei anderen Formaten. Desktop und agy-CLI konvertieren in beide Richtungen unter Verwendung ihrer unterschiedlichen Formatnamen.
• Native Desktop-Schreib-/Löschvorgänge aktualisieren sowohl bekannte state.vscdb-Verlaufsindizes, vorhandene Protobuf-Caches, Titelannotationen als auch die ausgewählte Unterhaltungsdatenbank. Standard-Profilpfade werden abgeleitet; für benutzerdefinierte Basisverzeichnisse übergeben Sie --source-state-db oder --target-state-db mit dem entsprechenden globalStorage/state.vscdb. Schließen Sie den Desktop-Client zuerst; ein laufender Language-Service oder SQLite-Seitenwagen blockieren Änderungen. Eine gleichnamige Legacy .pb blockiert Löschvorgänge. Die gemeinsam genutzte Zustandsdatenbank und benachbarte Sitzungen bleiben erhalten.
• Desktop hat keinen zurückgegebenen Fortsetzungsbefehl: Öffnen Sie ihn über die native Verlaufsoberfläche. Offizielles Language-Service-Rücklesen wird durch ID verifiziert; GUI-Verlaufsfindung und Modellfortsetzung sind nicht verifiziert. Behaupten Sie keine GUI-Prüfung allein durch Datei-Parsing oder Datenbankregistrierung.
• Legacy Desktop .pb oder verschlüsselter Verlauf müssen zuerst durch den offiziellen Client in SQLite aktualisiert/importiert werden. Alternativ klonen Sie ihn über agy /resume → Antigravity und konvertieren diese CLI-Kopie; das Verschieben der Kopie löscht nicht das Desktop-Original.
• Löschen entfernt das ausgewählte Transkript/Bridge-Manifest, native Sitzungsdatenbankzeilen und bekannte Verlaufs-/Listeneinträge. Gemeinsam genutzte Projekte, Anhänge, Backups, Authentifizierung und Laufzeiteinstellungen bleiben erhalten. Ein Fehler während der Quellbereinigung kann ein gültiges Ziel und eine beibehaltene Quelle hinterlassen: Überprüfen Sie Fehler vor dem Wiederholen.
• Portable Dateien (--output / --output-dir) müssen für die ID-basierte Fortsetzung nativ installiert/importiert werden. Pi kann jede ausgegebene Pi-Datei über pi --session <datei> öffnen.
• Komprimierungsgrenzen bleiben wirksam: Pi setzt ab der letzten Zusammenfassung und späteren Nachrichten fort; frühere Nachrichten bleiben in seinem Sitzungsverlauf. Zusammenfassungen können vergangene Aktionen beschreiben; rohe Tool-Ausführungsdatensätze sind ausgeschlossen.