VaultFlow para VS Code
Lleva el proyecto activo del editor al panel de VaultFlow y
muestra en la barra lateral la actividad de los agentes, sin salir del editor.
La extensión es un puente ligero: no envía nada a la red, no guarda credenciales y no duplica el
panel. Abre la aplicación de escritorio y lee el mismo feed JSONL que ella.
Qué hace
- Abre VaultFlow en el proyecto actual. El panel arranca con esa carpeta ya seleccionada
(
--workspace). Si ya está abierto, no abre otra ventana: adopta el proyecto, se pone al frente y
el panel lo refleja en unos segundos.
- 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, VaultFlow
se abre en el proyecto de esa sesión.
- Barra de estado con el resumen de sesiones activas y un refresco a mano.
- Ayuda con las rutas reales de configuración y del feed según el sistema.
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 la aplicación |
vaultflow.openApp |
Abre el panel sin cambiar el proyecto que tenga. |
| 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. |
Ajustes
| Ajuste |
Por defecto |
Para qué sirve |
vaultflow.appPath |
vacío |
Ruta al ejecutable de VaultFlow (AppImage, instalación de Windows…). Vacío usa el repositorio en modo desarrollo si lo reconoce. |
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
- VaultFlow instalado (paquete de Fedora/Windows) o el repositorio clonado con
npm install.
- VS Code
1.85 o superior.
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.
Cómo publicar en el Marketplace
El paso a paso completo está en PUBLISHING.md. Resumen:
npm run ext:sync # copia los módulos compartidos de src/
npm run ext:package # genera dist/vaultflow-vscode.vsix
npm run ext:publish # lo sube al publisher giulicatellapy
El .vsix también puede subirse a mano desde el portal del publisher, sin token de Azure DevOps: el
paquete se arrastra en New extension → Visual Studio Code.
Licencia
MIT. Consulta LICENSE.
