Dokumentation / CLI-Schnellstart

CLI-Schnellstart

Durchsuche Contextify im Terminal.

Die CLI contextify liest deine lokale Contextify-Datenbank. Unter macOS ist das dieselbe Datenbank, die auch die Mac-App nutzt. Außerdem installiert sie Total Recall-Skills und führt Befehle zur Cloud-Synchronisierung aus.

Nutze sie für schnelle lokale Suchen oder skriptfähige Statusprüfungen unter macOS und Linux. Windows x64 und ARM64 sind ebenfalls verfügbar.

Installation nach Plattform

Installation Vorgehen Grund
Mac-DMG Öffne Contextify einmal. Die App installiert oder repariert die CLI unter Settings → CLI. DMG-Versionen können den lokalen Shim und den Skill Total Recall direkt installieren.
Mac App Store brew install PeterPym/contextify/contextify-query Die App in der Sandbox kann die CLI nicht in Systempfade schreiben.
Linux Installiere die Linux-Release-Binärdatei und füge contextify zu deinem PATH hinzu. Unter Linux steht die CLI im Mittelpunkt; Contextify.app gibt es dort nicht.

Prüfe die CLI

contextify --version
contextify status
contextify doctor

status prüft die Datenbank. doctor prüft die Installation von CLI und Skills. Wenn doctor fehlende Skills meldet, führe Folgendes aus: 

contextify install-plugin
contextify doctor

Der frühere Befehlsname contextify-query funktioniert weiterhin. In der Dokumentation und in Anleitungen solltest du jedoch den Befehl contextify verwenden.

Unter Linux indexierst du Transkripte vor der Suche mit contextify ingest. Nutze contextify install-service, wenn du eine regelmäßige Erfassung im Hintergrund möchtest.

Starte deine erste lokale Suche

Beginne mit einer markanten Formulierung, Aufgaben-ID, einem Branch-Namen, Dateipfad oder einer Fehlermeldung aus einer KI-Sitzung. 

contextify search "sign-in handoff" --limit 5
contextify search "ct 1703" --days 30
contextify search "cloud sync" --project . --limit 10

Die Suche zerlegt Bezeichner mit Bindestrichen in Tokens. Wenn ct-1703 nicht wie erwartet gefunden wird, versuche "ct 1703" oder benachbarte Wörter aus derselben Konversation.

Die Suche sieht nur lokal indexierten Verlauf. Fehlt eine neue Konversation, starte zuerst die Erfassung oder lass die installierte App die Verarbeitung abschließen.

Verbinde die Cloud über die CLI

Die Einrichtung der gehosteten Cloud startet standardmäßig die Anmeldung über den Browser: 

contextify cloud setup
contextify cloud status
contextify cloud sync

Nutze bei Self-Hosted nach Möglichkeit die interaktive Eingabe. So landet kein API-Schlüssel in deinem Shell-Verlauf. 

contextify cloud setup --url https://your-server.example.com
contextify cloud projects
contextify cloud projects --exclude my-private-project
contextify cloud sync

cloud projects --exclude ändert Project Sync für diesen Mac. Ausgeschlossene Projekte werden von diesem Gerät künftig nicht mehr hochgeladen.

Für Automatisierung ohne interaktive Eingabe wird --key unterstützt. Behandle das Befehlsprotokoll als vertraulich, wenn es einen echten Schlüssel enthält. 

contextify cloud setup --url https://your-server.example.com --key ctx_REDACTED --no-input

Weiterführende Dokumentation

Total Recall für Claude Code

Installiere, prüfe und nutze den Assistenten-Skill.

Total Recall für Codex

Skill-Speicherorte und Überprüfung speziell für Codex.

Fehlerbehebung bei der Cloud-Synchronisierung

Verstehe die Zustände offline, error, deferred und attention.

Erfassung und Synchronisierung

Unterscheide die lokale Transkriptverarbeitung vom Hoch- und Herunterladen in der Cloud.

Zuletzt aktualisiert: 6. Mai 2026