VaultFlow para VS Code
El panel de VaultFlow dentro del editor: el motor se hospeda en
el propio proceso de la extensión, el panel se sirve en una webview nativa y la barra lateral resume la
actividad de los agentes.
La extensión no envía nada a la red y no guarda credenciales en claro: las claves que se escriben en el
panel se cifran con el almacén del editor. El panel del editor y el de escritorio son el mismo: comparten
media/panel.html, media/panel.css y media/panel.js, y el puente de la webview se genera desde
src/preload.cjs con npm run ext:sync.
Instalación
Qué hace
- Abre el panel en el proyecto actual. El panel arranca con esa carpeta ya seleccionada. Si ya está
abierto, no monta otra webview: adopta el proyecto, se pone al frente y se refresca en unos segundos.
- El motor viaja dentro de la extensión. El runtime de los agentes corre en el proceso del editor
(
src/app-host.cjs), con los mismos canales que la aplicación de escritorio: no hace falta instalar
ni arrancar nada aparte.
- Tu gobernanza global viaja con el motor. Las reglas maestras y la biblioteca de habilidades
(
rules.txt y skills.txt) se leen del proyecto abierto y, si el proyecto no trae las suyas, de la
copia que se empaqueta en src/governance con npm run ext:sync. El bloque se inyecta en todos los
agentes, sean de API o de CLI local.
- Barra lateral con las sesiones. Cada fila es una sesión publicada en
events.jsonl: proveedor, antigüedad, último evento, herramienta y archivo. Al pulsarla, el panel se
abre en el proyecto de esa sesión.
- Barra de estado con el resumen de sesiones activas y un refresco a mano.
- Proveedores que se configuran solos. Al elegir Claude, ChatGPT, DeepSeek o Qwen —y cualquiera de
los free tiers del catálogo— la URL base y el modelo se rellenan en el panel y se guarda el motor que
corresponde.
- Ayuda con las rutas reales de configuración y del feed según el sistema.
- Aplicación de escritorio opcional. El botón Escritorio del panel abre la ventana completa de
VaultFlow (bandeja del sistema, atajos globales) cuando hace falta; la ruta se toma de
vaultflow.appPath. Si no está instalada, el panel del editor sigue funcionando y el aviso lleva al
repositorio: no hay nada que instalar para usar la extensión.
- Descarga lo que necesita cuando lo necesita. El conector de WhatsApp es lo único que no viaja
dentro del paquete (sus dos dependencias arrastran su propio navegador). Al vincularlo, la extensión
ofrece bajarlo —o se lanza a mano con el comando de abajo— y el resto del panel no se toca mientras
tanto.
- Al cerrar, todo se apaga: la tarea en curso se aborta, los conectores se desconectan y la webview
se destruye.
Proveedores
El panel trae el mismo catálogo que la aplicación de escritorio y abre con los cuatro grandes: al
elegir uno, la URL base y el modelo se rellenan solos y solo queda pegar la clave.
| Proveedor |
URL base |
Modelo por defecto |
| Claude (Anthropic) |
https://api.anthropic.com/v1 |
claude-sonnet-5-5 |
| ChatGPT (OpenAI) |
https://api.openai.com/v1 |
gpt-6.1-sol |
| DeepSeek |
https://api.deepseek.com |
deepseek-flash |
| Qwen (Alibaba Model Studio) |
https://dashscope-intl.aliyuncs.com/compatible-mode/v1 |
qwen3.8-flash |
Claude guarda el motor anthropic (API nativa /v1/messages, clave en x-api-key); los otros tres
usan cualquier endpoint compatible con OpenAI (/chat/completions, clave como Bearer). Debajo siguen
los free tiers —Groq, Cerebras, Gemini, Mistral, OpenRouter :free, Cloudflare, ModelScope, Pollinations
y los 34 proveedores que agrega FreeLLMAPI tras un único
/v1— y Ollama local, con su URL base y dónde conseguir la clave.
Comandos
| Comando (paleta) |
Identificador |
Qué hace |
| VaultFlow: Abrir el proyecto actual |
vaultflow.openWorkspace |
Abre el panel con la carpeta abierta en VS Code. |
| VaultFlow: Abrir el panel |
vaultflow.openApp |
Muestra el panel con el proyecto que ya tenga abierto. |
| VaultFlow: Refrescar sesiones |
vaultflow.refreshSessions |
Relee el feed al invocarlo. |
| VaultFlow: Abrir el feed de eventos |
vaultflow.openFeed |
Abre events.jsonl en el editor. |
| VaultFlow: Ver la ayuda y las rutas de datos |
vaultflow.openHelp |
Muestra dónde vive cada archivo y un ejemplo de evento. |
| VaultFlow: Descargar el conector de WhatsApp |
vaultflow.downloadConnectors |
Baja las dos dependencias del conector de WhatsApp en la extensión; no hace falta para usar el panel. |
Ajustes
| Ajuste |
Por defecto |
Para qué sirve |
vaultflow.appPath |
vacío |
Ruta al ejecutable de VaultFlow (AppImage, instalación de Windows…) para el botón Escritorio del panel. Vacío usa el repositorio en modo desarrollo si lo reconoce. El panel del editor no la necesita. |
vaultflow.feedPath |
vacío |
Ruta del feed events.jsonl si no está en la del sistema. |
vaultflow.refreshSeconds |
30 |
Cada cuántos segundos se releen las sesiones; 0 lo desactiva. |
Requisitos
- VS Code
1.85 o superior. El motor de VaultFlow viaja dentro de la extensión: no hay que instalar
nada aparte para usar el panel.
- Opcional: VaultFlow instalado (paquete de Fedora/Windows) o el repositorio clonado con
npm install,
solo para abrir la aplicación de escritorio desde el botón Escritorio del panel.
- Opcional: el conector de WhatsApp. La extensión lo descarga al vincular WhatsApp y necesita
npm en
el equipo para esa descarga; si no está, el aviso lo dice y todo lo demás sigue funcionando.
Publicar eventos propios
Cualquier proceso puede aparecer en la vista y en la oficina del panel escribiendo una línea JSON por
evento en el feed:
mkdir -p -m 700 ~/.local/share/agent-workbench
printf '%s\n' '{"provider":"Mi agente","sessionId":"sesion-123","cwd":"/ruta/al/proyecto","timestamp":"'"$(date -Iseconds)"'","event":"Preparando cambios","status":"working"}' \
>> ~/.local/share/agent-workbench/events.jsonl
En Windows el archivo es %LOCALAPPDATA%\agent-workbench\events.jsonl. Los campos provider,
sessionId, cwd (absoluto) y timestamp son obligatorios; prompt, tool, file, event y
status son opcionales y mejoran lo que se ve.
Repositorio
Esta extensión es la pieza de VS Code de un proyecto más grande: el motor, la aplicación de escritorio,
los conectores y esta extensión viven juntos en
https://github.com/FUDAPY/Vault-Flow
Ahí está el código fuente, cómo compilarlo y empaquetarlo, el registro de cambios de cada versión y la
documentación del resto del proyecto. Las dudas, las propuestas y los informes de errores se atienden en
ese mismo repositorio.
Licencia
MIT. Consulta LICENSE.