Elocore Hub — extensión VS Code / Cursor
Extensión oficial para vincular tu carpeta de trabajo con un proyecto en Elocore y enviar telemetría mínima al Hub.
Qué hace
- Vincular proyecto al Hub: crea o actualiza
.elocore/project.json con el projectId (UUID) del proyecto en la web.
- Heartbeat de sesión (automático y manual): envía al servidor:
- nombre de la carpeta del workspace (no rutas completas);
- segundos de actividad con la ventana enfocada (aproximado);
- nombres de archivo editados, solo basename con extensión (p. ej.
auth_service.ts);
- commits recientes: hash y mensaje (vía
git log), sin diff ni contenido;
- cada ~15 min (con proyecto vinculado e identificación): árbol de carpetas y nombres de archivo en el workspace (sin contenido), para el tablero de arquitectura en Elocore.
Identificador en el marketplace
ID de extensión: aibux-dev.elocore-hub (publicador Microsoft: aibux-dev / Aibux).
Configuración
En Ajustes (JSON o UI), clave elocore:
| Clave |
Descripción |
elocore.apiBaseUrl |
URL base de la app Next.js, p. ej. http://localhost:3000 |
elocore.telemetryToken |
Mismo valor que ELOCORE_TELEMETRY_INGEST_SECRET en el servidor |
elocore.telemetryIntervalSeconds |
Cada cuántos segundos se envía telemetría automática (mín. 30) |
elocore.telemetryPaused |
true para detener envíos automáticos |
elocore.pairingToken |
Token personal elo_… generado en el Hub (recomendado frente al JWT) |
elocore.supabaseAccessToken |
Alternativa: JWT de sesión Supabase (preferir pairingToken) |
Privacidad (obligatorio)
- No se envía contenido de archivos, diffs, snippets ni credenciales.
- No se envían rutas completas del disco; solo el nombre de la carpeta raíz del workspace, el nombre de archivo (con extensión) de los documentos editados y, para el árbol, nombres relativos de carpetas/archivos (sin contenido; se omiten
node_modules, .git, etc.).
- Los commits se limitan a hash y mensaje público del historial de Git; nunca el diff.
- Requiere
git en el PATH para listar commits; si no hay repositorio Git, simplemente no se envían commits.
Si tienes duda sobre si un dato es seguro, no lo envíes: abre un issue en el repositorio del producto.
Desarrollo e instalación local
cd packages/extension
npm install
npm run compile
En VS Code / Cursor: Run → Start Debugging con la configuración “Extension” (o abre esta carpeta como workspace y usa Run Extension).
Para generar un .vsix (opcional): instala @vscode/vsce globalmente o como devDependency y ejecuta vsce package.
Archivo local .elocore/project.json
Ejemplo:
{
"projectId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
}
El UUID debe coincidir con un proyecto existente en tu instancia de Elocore (Supabase).