sync-hub

Ein kleiner lokaler Daemon (nur macOS — launchd, ~/Library/...) , der wortwörtlich den Verlauf deiner lokalen KI-Gespräche (Claude Code, Codex CLI, Claude Cowork, Antigravity, Imports von Claude.ai/ChatGPT) in einer einzigen SQLite-Datenbank zentralisiert und bereitstellt:

• über ein Web-Dashboard (Projektbaum, Volltextsuche, Chat-Ansicht, Synchronisationsabdeckung, Sortierung nicht zugeordneter Sitzungen) ;

• über einen MCP-Server, den Claude Code, Codex und Antigravity direkt abfragen können, um den genauen Kontext eines anderen Tools abzurufen, ohne jemals zusammenzufassen oder neu zu konstruieren — immer der Originaltext.

Es wird nie etwas geraten: Eine Sitzung, deren Arbeitsverzeichnis keinem bekannten Projekt entspricht, landet in einem Bucket „Nicht zugeordnet", sichtbar und sortierbar, anstatt per Heuristik zugeordnet zu werden.

Warum

Die Arbeit mit mehreren KI-Tools an denselben Projekten führt bei jedem Tool-Wechsel zu Kontextverlust. sync-hub synchronisiert nichts in die Tools (es greift nie auf den nativen Speicher eines anderen Tools zu) — es liest, was bereits lokal existiert, und macht es für jedes über MCP verbundene Tool abfragbar.

Related MCP server: flightlog

Installation

Voraussetzungen: macOS, Node.js ≥ 20 (better-sqlite3 hat ein Prebuild für neuere Versionen — im Normalfall keine Compiler-Tools nötig).

git clone <url-de-ce-repo>
cd sync-hub
npm install
npm run build
./scripts/install_service.sh   # installe un service launchd macOS (démarre à la connexion)

Das Dashboard wird unter http://127.0.0.1:4000 bereitgestellt (standardmäßig nur lokal).

Zum Deinstallieren: ./scripts/uninstall_service.sh.

Umgebungsvariablen (alle optional)

MCP-Server verbinden

# Claude Code
claude mcp add sync-hub -s user -- node <repo>/dist/server/mcp-entry.js

# Codex — dans ~/.codex/config.toml
[mcp_servers.sync-hub]
command = "node"
args = ["<repo>/dist/server/mcp-entry.js"]

Bereitgestellte Tools:

• Wortgetreues Lesen: get_project_timeline, get_thread, search_transcripts

• Kontinuität zwischen Threads: link_threads, unlink_thread, get_thread_link_updates (nur Delta)

• Projektverwaltung (gleiche Aktionen wie im Dashboard): list_projects, list_threads, rename_project, merge_projects, assign_thread_to_project, archive_thread, archive_project

Claude.ai / ChatGPT-Export importieren

Lege die Exportdatei(en) in imports/claude/ oder imports/chatgpt/ ab und starte dann einen Scan neu (Button „Erneut scannen" im Dashboard oder POST /api/sync/rescan).

Entwicklung

npm run dev     # client (Vite) + serveur (tsx watch) en parallèle
npm test        # suite de tests (vitest)
npm run lint    # typecheck

Architektur

• src/core/db.ts — SQLite-Schema + Datenzugriff.

• src/core/registry.ts — Projekt-zu-Sitzungs-Zuordnung (nur exakte Übereinstimmung, niemals Heuristik).

• src/core/adapters/ — ein Adapter pro Quelle (Claude Code, Codex, Cowork, Antigravity, Bulk-Exporte).

• src/core/watch.ts — Echtzeit-Überwachung neuer Sitzungen.

• src/core/mcp-server.ts — MCP-Server.

• src/server/ — REST-API + WebSocket (Fastify).

• src/client/ — Dashboard (React + Vite + Tailwind).