apricot-terminal

El ayudante local que conecta tu terminal (con tu Claude Code y tu suscripción) al box Terminal del Estudio de Apricot HQ — automático y en el deploy.

El navegador no puede correr claude por sí solo (pared de seguridad). Este ayudante corre en tu compu y se encuentra con el Estudio a través de Supabase Realtime (el punto de encuentro), así funciona aunque el Estudio sea el sitio deployado. Claude corre acá, en tu Mac; cero nube nuestra, cero costo de API.

Instalación (una vez)

npx apricot-terminal install

Te abre el navegador para autorizar esta compu (1 clic, reusa tu sesión del HQ) y deja el ayudante arrancando solo con tu Mac. Listo: abrís el Estudio → pestaña Terminal → escribís claude y trabajás; lo que arme aparece en el lienzo.

Comandos

• apricot-terminal — corre el ayudante (relay). Si no está conectado, te lleva a autorizar primero.
• apricot-terminal connect — solo (re)autorizar esta compu.
• apricot-terminal install — autorizar + auto-arranque (LaunchAgent de macOS).
• apricot-terminal uninstall — quitar el auto-arranque.
• apricot-terminal --local — modo viejo ws://localhost (solo si abrís el Estudio en localhost; no anda contra el deploy).

Seguridad

El canal de encuentro se llama con un secreto de 256 bits por usuario (capability imposible de adivinar). Solo vos podés leerlo (RLS en la DB), y el ayudante lo recibe por loopback local al autorizar (nunca sale de tu compu). Vive en ~/.apricot/terminal.json (perms 600). Rotarlo (desde el HQ) invalida el emparejamiento al instante. Pasa por la infra de Supabase (tu backend), no por un server nuestro.

Notas

• Solo anda con tu compu prendida (Claude corre ahí) y claude logueado.
• Lag de tipeo ~100-150ms (los bytes pasan por la nube). Perfecto para hablarle a Claude y ver cómo trabaja.
• Auto-arranque: macOS por ahora. En otros SO, corré apricot-terminal a mano.

Dev

npm install
npm test          # node --test (modo --local / server.mjs)
node cli.mjs      # arrancar el relay a mano