Dokumentation / Erfassung und Synchronisierung

Erfassung und Synchronisierung

Lokale Verarbeitung kommt vor der Cloud-Synchronisierung.

Contextify liest zuerst Transkriptdateien auf deinem Gerät und indexiert sie in einer lokalen Datenbank. Die Cloud-Synchronisierung ist ein separater Schritt, der geeigneten indexierten Verlauf zum oder vom gehosteten Contextify Cloud oder deinem selbst gehosteten Server überträgt.

Wenn du Claude Code- oder Codex-Sitzungen aus mehreren Jahren hast, kann der erste lokale Verarbeitungsdurchlauf dauern. Das bedeutet nicht, dass die Cloud hängt.

Transkripte Claude Code und Codex schreiben lokale Sitzungsdateien.
Erfassung Contextify indexiert Projekte, Konversationen und Nachrichten lokal.
Synchronisierung Geeigneter indexierter Verlauf kann über die Cloud übertragen werden.

Die zwei Aufgaben

Aufgabe Was sie macht Wo sie stattfindet
Erfassung und Indexierung Liest Transkriptdateien, analysiert Nachrichten, gruppiert sie nach Projekt und aktualisiert lokale Suchindizes. Auf deinem Mac oder dem Linux-Gerät, auf dem contextify ingest läuft.
Cloud-Synchronisierung Lädt geeignete indexierte Datensätze für den gewählten Cloud-Workspace hoch und herunter. Zwischen deinem Gerät und dem gehosteten Contextify Cloud oder deinem selbst gehosteten Cloud-Server.

Ein langer erster Durchlauf ist meist Erfassung, nicht Synchronisierung. Die Cloud kann eine Konversation erst hochladen, wenn Contextify sie lokal gelesen und indexiert hat.

Was auf dem Mac passiert

Erste Erkennung

Die App durchsucht unterstützte Claude Code- und Codex-Transkriptordner, erstellt lokale Projektdatensätze und beginnt, lesbare Konversationen zu verarbeiten.

Laufende Aktualisierungen

Während Konversationen weitergehen, erkennt Contextify neue Transkriptänderungen und indexiert die neuen Nachrichten. Das ist reguläre Hintergrundarbeit, kein einmaliger Import.

Zusammenfassungen und Metadaten

Nach der Indexierung der Nachrichten können lokale Warteschlangen für Zusammenfassungen und Metadaten weiterarbeiten. Du siehst möglicherweise Processing N items, obwohl die Suche bereits funktioniert.

Bei umfangreicher lokaler Verarbeitung kann die App Zustände wie Indexing 3/40 projects, Processing many items... oder Up to date anzeigen. Sie beschreiben lokale Arbeit.

Warum der erste Durchlauf dauern kann

Contextify ist für umfangreiche Verläufe optimiert, einschließlich einer Massenerfassung für große erste Durchläufe. Trotzdem muss es echte Dateien analysieren, viele Datenbankzeilen schreiben und Suchindizes aufbauen.

Was den ersten Durchlauf beeinflusst: Anzahl der Transkripte, sehr große Sitzungen, Datenträgergeschwindigkeit, Akku- und Ruhezustandsverhalten, Ordnerzugriff und ob die App eine neue Datenbank aufbaut.

Was du tun kannst: Lass die App geöffnet, halte den Mac bei umfangreichem Verlauf wach und prüfe die Statusleiste, bevor du von einem Cloud-Fehler ausgehst.

Wenn du die App während eines großen Durchlaufs beendest, ist Contextify darauf ausgelegt, später fortzufahren. Am sichersten ist es beim ersten Start trotzdem, den ersten Durchlauf abzuschließen.

Wie die Cloud-Synchronisierung ins Gesamtbild passt

Die Cloud-Synchronisierung beginnt bei der lokalen Datenbank. Sie lädt geeignete lokale Datensätze hoch und ruft geeignete entfernte Datensätze für den konfigurierten Workspace ab.

  • Gehostete und selbst gehostete Cloud nutzen dasselbe grundlegende Client-Modell.
  • Project Sync steuert, welche lokalen Projekte von diesem Gerät hochgeladen werden.
  • Die Synchronisierung kann während der Erfassung warten, damit lokale Datenbankschreibvorgänge einander nicht behindern.
  • Ist ein Cloud-Ziel nicht erreichbar, bleibt der indexierte Verlauf in der lokalen Datenbank. Sobald das Ziel wieder erreichbar ist, kann die Synchronisierung es erneut versuchen. Anmeldung, Project Sync-Einstellungen oder Serverfehler können trotzdem noch Aufmerksamkeit erfordern.

Ein Cloud-Zielwechsel ist keine Migration zwischen Servern. Er ändert, wohin dieses Gerät künftig synchronisiert. Lies die Anleitung zum Cloud-Wechsel, bevor du zwischen gehosteter und selbst gehosteter Cloud wechselst.

Verhalten unter Linux und in der CLI

Unter Linux gibt es keine Mac-App, die Transkripte in Echtzeit beobachtet. Die CLI erfasst sie in einzelnen Durchläufen. 

contextify status
contextify ingest
contextify install-service

contextify ingest läuft einmal und beendet sich. contextify install-service richtet unter Linux die regelmäßige Erfassung im Hintergrund ein und nutzt, falls verfügbar, einen systemd-Timer. Das Standardintervall beträgt 15 Minuten.

Cloud-Befehle sind von Erfassungsbefehlen getrennt: 

contextify cloud status
contextify cloud projects
contextify cloud sync

Häufige Statusbezeichnungen

Einige Bezeichnungen unterscheiden sich je nach App-Version und Oberfläche leicht. Das sind die üblichen Kategorien.

Status Bedeutet meist Vorgehen
Processing N items Lokale Warteschlangen für Zusammenfassungen oder Metadaten arbeiten noch. Warte und suche erneut, wenn der neueste Kontext noch nicht sichtbar ist.
Indexing X/Y projects Die App erfasst noch bekannte Projekte lokal. Lass den ersten Durchlauf abschließen, bevor du den Fortschritt der Cloud-Synchronisierung beurteilst.
Waiting Die Cloud-Synchronisierung wartet auf den Abschluss der Transkripterfassung. Meist ist keine Aktion nötig.
Deferred Die Synchronisierung pausierte, weil die lokale Erfassung oder Datenbankschreibvorgänge aktiv waren. Die Synchronisierung versucht es automatisch erneut, oder du kannst später manuell synchronisieren.
Syncing Das Gerät lädt Cloud-Änderungen hoch oder herunter. Lass die App für umfangreiche nachholende Uploads geöffnet.
Offline Das konfigurierte Cloud-Ziel ist nicht erreichbar. Prüfe das konkrete gehostete oder selbst gehostete Ziel, nicht nur den allgemeinen Internetzugang.
Attention needed Eine serverseitige Nachholsitzung scheint zu hängen oder wurde mit Problemen abgeschlossen. Nutze Retry und prüfe dann die Fehlerbehebung bei der Cloud-Synchronisierung, wenn der Zustand erneut auftritt.

Nächste Schritte

Schnellstart für den Mac

Installiere die App und finde deine erste indexierte Konversation.

CLI-Schnellstart

Prüfe den lokalen Status, starte die Erfassung unter Linux und verbinde die Cloud im Terminal.

Fehlerbehebung bei der Cloud-Synchronisierung

Untersuche Ziel-Erreichbarkeit, Offline-Zustände, Wiederholungsverhalten und Netzwerkprobleme bei Self-Hosted.

Zuletzt aktualisiert: 6. Mai 2026