Conduit AI Bridge

Proceso local que corre en la máquina del usuario. Conecta el app en Vercel con el modelo LLM local, el filesystem, y Obsidian.

Por qué es local

• Accede al CLI del modelo LLM instalado en la PC
• Lee y escribe archivos locales (Obsidian vault, filesystem)
• No tiene URL pública — solo escucha en localhost:3284

Instalación

npm install -g @conduitai/bridge
conduit-bridge start

Comandos disponibles

conduit-bridge start     # Inicia el bridge en localhost:3284
conduit-bridge stop      # Detiene el proceso
conduit-bridge status    # Muestra si está corriendo + PID + URL
conduit-bridge --version # Muestra la versión instalada

Setup para desarrollo (contribuidores)

git clone https://github.com/FlowingKi/conduit-ai-bridge.git
cd conduit-ai-bridge
npm install
cp .env.example .env
# Editar .env con los valores reales
npm run dev

Variables de entorno (.env)

PORT=3284
BRIDGE_TOKEN=<token secreto — debe coincidir con el configurado en el app>
SUPABASE_URL=<url del proyecto Supabase>
SUPABASE_SERVICE_ROLE_KEY=<service role key>

⚠️ Protocolo de actualización — OBLIGATORIO

Cada vez que el repo recibe cambios, el usuario debe actualizar su bridge local:

cd conduit-ai-bridge
git pull
npm install   # solo si cambiaron dependencias en package.json
npm run dev   # reiniciar el proceso

Cómo saber si el bridge está desactualizado:

• El app muestra errores en el chat o features que no funcionan
• La pantalla Monitor en /monitor muestra versión desactualizada
• El app espera un campo en el request body que el bridge no acepta

Arquitectura

Vercel (Next.js app)
    │
    │  HTTP POST localhost:3284/chat/run
    │  { systemPrompt, messages, composioMcpUrl? }
    ▼
Bridge (Express local)
    │
    ├── spawn("claude", ["--print", prompt, "--mcp-config", tempFile?])
    │       ▲
    │       └── Composio MCP URL (tools SaaS via HTTP)
    │
    └── SSE stream de respuesta → Vercel → browser

Endpoints

| Método | Ruta | Descripción | |--------|------|-------------| | GET | /ping | Health check — devuelve { ok: true } | | POST | /chat/run | Ejecuta chat con el modelo LLM, stream SSE | | POST | /flow/run | Ejecuta un flow de canvas | | POST | /task/run | Ejecuta una tarea asíncrona |

Relación con el repo principal

• App: https://github.com/FlowingKi/conduit-ai — deploya en Vercel
• Bridge: https://github.com/FlowingKi/conduit-ai-bridge — este repo, corre local

Cuando se agrega una feature que requiere cambios en ambos repos, los dos deben commitearse y pushearse antes de cerrar la tarea.