sync-hub

Un pequeño demonio local (solo macOS — launchd, ~/Library/...) que centraliza, verbatim, el historial de tus conversaciones de IA locales (Claude Code, Codex CLI, Claude Cowork, Antigravity, imports Claude.ai/ChatGPT) en una base SQLite única, y lo expone:

• a través de un dashboard web (árbol de proyectos, búsqueda de texto completo, vista de chat, cobertura de sincronización, clasificación de sesiones no vinculadas);

• a través de un servidor MCP que Claude Code, Codex y Antigravity pueden consultar en directo para recuperar el contexto exacto de otra herramienta, sin resumir ni reconstruir nunca — siempre el texto original.

Nada se adivina nunca: una sesión cuyo directorio de trabajo no corresponde a ningún proyecto conocido va a un bucket «No asignado», visible y clasificable, en lugar de ser vinculada por heurística.

Por qué

Trabajar con varias herramientas de IA en los mismos proyectos hace que se pierda el contexto en cada cambio de herramienta. sync-hub no sincroniza nada hacia las herramientas (nunca toca el almacenamiento nativo de otra herramienta) — solo lee lo que ya existe localmente y lo hace consultable por cualquier herramienta conectada vía MCP.

Related MCP server: flightlog

Instalación

Requisitos: macOS, Node.js ≥ 20 (better-sqlite3 tiene un prebuild para las versiones recientes — no se necesitan herramientas de compilación en el caso habitual).

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)

El dashboard se sirve en http://127.0.0.1:4000 (solo local por defecto).

Para desinstalar: ./scripts/uninstall_service.sh.

Variables de entorno (todas opcionales)

Conectar el servidor MCP

# 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"]

Herramientas expuestas:

• lectura verbatim: get_project_timeline, get_thread, search_transcripts

• continuidad entre hilos: link_threads, unlink_thread, get_thread_link_updates (delta-only)

• gestión de proyectos (mismas acciones que el dashboard): list_projects, list_threads, rename_project, merge_projects, assign_thread_to_project, archive_thread, archive_project

Importar una exportación de Claude.ai / ChatGPT

Coloca el/los archivo(s) de exportación en imports/claude/ o imports/chatgpt/, y vuelve a ejecutar un escaneo (botón «Rescanear» del dashboard, o POST /api/sync/rescan).

Desarrollo

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

Arquitectura

• src/core/db.ts — esquema SQLite + acceso a datos.

• src/core/registry.ts — resolución proyecto ↔ sesión (correspondencia exacta únicamente, nunca heurística).

• src/core/adapters/ — un adaptador por fuente (Claude Code, Codex, Cowork, Antigravity, exports bulk).

• src/core/watch.ts — vigilancia en tiempo real de nuevas sesiones.

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

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

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