Nutze Contextify über die Linux-Kommandozeile.

Installieren

Das Installationsprogramm erkennt deine Architektur, lädt die passende Binärdatei herunter und richtet die Indexierung in einem Schritt ein.

curl -fsSL https://contextify.sh/install.sh | sh

Das Installationsprogramm:

• lädt die Binärdatei contextify für x86_64 oder ARM64 herunter und installiert sie unter ~/.local/bin/
• installiert den Skill Total Recall für Claude Code und Codex CLI
• indexiert vorhandene Transkripte in ~/.claude/ und ~/.codex/
• richtet einen systemd-Benutzertimer ein, damit neue Transkripte weiterhin indexiert werden

Die Installation läuft unter deinem Benutzerkonto und braucht keine Root-Rechte. Falls ~/.local/bin nicht in deinem PATH ist, füge es hinzu und öffne eine neue Shell.

Wenn du die Architektur selbst wählen möchtest, lade die Release-Binärdatei direkt herunter. Nutze x86_64 für die meisten Server und Desktops oder ARM64 für Raspberry Pi und AWS Graviton. Entpacke sie und füge contextify zu deinem PATH hinzu.

Prüfe die Installation

contextify --version
contextify status
contextify doctor

status zeigt den Datenbankpfad und die Anzahl indexierter Transkripte und Einträge. doctor prüft Binärdatei, Skill-Installation und Hintergrunddienst. Wenn doctor einen fehlenden Skill meldet, installiere ihn erneut:

contextify install-skill
contextify doctor

Unter Linux liegt die Datenbank gemäß der XDG-Basisverzeichnisspezifikation unter ~/.local/share/contextify/contextify.db. Setze CONTEXTIFY_DB_PATH oder übergib --db, um eine andere Datei zu nutzen.

Halte deinen Verlauf indexiert

Die Suche sieht nur indexierte Transkripte. Das Installationsprogramm indexiert vorhandene Dateien und richtet einen Timer für neue Sitzungen ein. Meist läuft das ohne dein Zutun. So indexierst du bei Bedarf:

contextify ingest

Das Installationsprogramm richtet die Hintergrundindexierung über einen systemd-Benutzertimer ein, der alle 15 Minuten läuft. Prüfe oder verwalte ihn direkt:

systemctl --user status contextify.timer
journalctl --user -u contextify

Wenn der Timer fehlt, installiere ihn mit contextify install-service. Entferne ihn mit contextify uninstall-service. Auf Systemen ohne systemd nutzt das Installationsprogramm stattdessen einen Cron-Eintrag.

Durchsuche deinen Verlauf

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

contextify search "sign-in handoff" --limit 5
contextify search "token refresh race" --days 30
contextify search "cloud sync" --project . --limit 10

Die Suche nutzt FTS5 mit Wortstammbildung. Deshalb findet deploy auch „deployed“ und „deploying“. Bezeichner mit Bindestrichen werden in einzelne Tokens zerlegt. Suche also nach "ct 1703" statt ct-1703. Nutze --json für skriptfähige Ausgabe.

Öffne die Details eines Ergebnisses mit der Eintrags-ID aus der Suchausgabe:

contextify context <entry-id> --before 5 --after 15
contextify projects
contextify activity --days 7

Suche über deinen Assistenten

Das Installationsprogramm ergänzt Claude Code und Codex CLI um den Skill Total Recall. Nach der Installation bittest du deinen Assistenten, frühere Arbeit abzurufen, und er sucht für dich:

/total-recall how did we fix the auth bug?

Delegiere mehrstufige Recherchen an den Recherche-Subagenten. In Claude Code heißt er query:contextify-researcher und wird mit dem Skill ausgeliefert. Codex stellt ihn als contextify_researcher bereit, installiert unter ~/.codex/agents/. Beide führen mehrere Suchanfragen in einer schreibgeschützten Sandbox aus und geben eine Zusammenfassung mit Quellen zurück.

Um die Suche jedem MCP-Client bereitzustellen, starte den Server über stdio:

contextify serve-mcp

Er bietet drei schreibgeschützte Tools: search_conversations für Volltextsuche, list_recent für aktuelle Sitzungen und get_conversation_entries für die Nachrichten eines Transkripts.

Synchronisiere zwischen Rechnern

Contextify Cloud synchronisiert indexierten Verlauf zwischen deinen Rechnern. So können ein Linux-Server und ein Mac-Laptop denselben durchsuchbaren Verlauf nutzen. Verbinde dich im Terminal:

contextify cloud setup
contextify cloud status
contextify cloud sync

Gib bei der Einrichtung der selbst gehosteten Cloud deinen eigenen Server an. Nutze bevorzugt die interaktive Eingabe, damit der API-Schlüssel nicht im Shell-Verlauf landet:

contextify cloud setup --url https://your-server.example.com
contextify cloud projects
contextify cloud sync

cloud projects verwaltet, welche Projekte von diesem Rechner synchronisiert werden. cloud search sucht Einträge auf allen synchronisierten Geräten, nicht nur auf diesem.

Was unter Linux läuft

Weiterführende Dokumentation