Lucky Code
Lucky Code es una extension de Visual Studio Code que orquesta los proveedores de ingenieria que ya tienes instalados. Arma un contexto minimo para cada tarea, reparte el trabajo entre proveedores con un solo escritor a la vez y comprueba el resultado con evidencia del repositorio: pruebas, diff de Git y memoria persistente.
Todo corre en tu equipo. Lucky no reemplaza tus proveedores, los coordina.
Que trae
- Chat con respuesta inmediata. Al enviar una pregunta ves un acuse al instante, y la respuesta del proveedor se va actualizando en el mismo mensaje, sin duplicados ni saltos.
- Carril rapido del borde (opcional). Una primera respuesta breve y provisional que llega en paralelo mientras el proveedor trabaja. Viene apagado y pide tu permiso antes de cada turno.
- Rutinas. Planear, construir, revisar y aprender, con rutas FAST, BUILD, REVIEWED, TRIAD, AGENTIC y MAX. Un plan aprobado se puede ejecutar directamente.
- Verificacion. Descubre y corre las pruebas del proyecto, muestra el diff de Git por archivo y permite deshacer los cambios de la ultima tarea.
- Blackboard. Memoria persistente del proyecto en
.lucky/: decisiones, estado, hallazgos y evidencia de cada tarea.
- Presupuesto. Ventana de uso de cinco horas, tope de llamadas, tope de llamadas de pago y tope de gasto diario en dolares.
- Permisos claros. Solo lectura, escritura del proyecto o acceso completo. El chat siempre trabaja en solo lectura.
Requisitos
- Visual Studio Code 1.95 o superior.
- Git en el PATH.
- Al menos un proveedor instalado, por ejemplo Antigravity, Codex, OpenCode u Ollama. Los que falten aparecen como no conectados, no rompen nada.
Instalacion
Desde la terminal:
code --install-extension lucky-code-0.4.3.vsix
O desde VS Code, con el comando Extensions: Install from VSIX....
Despues abre una carpeta de proyecto, entra al icono de Lucky en la barra lateral y corre Lucky: Initialize Project una vez. Eso crea la carpeta .lucky/ con la memoria del proyecto. Para comprobar que tus proveedores responden, corre Lucky: Run Preflight Diagnostics.
Primeros pasos
- Corre Lucky: Open Lucky Code Chat para abrir el chat.
- Escribe una tarea y elige el modo: Chat para preguntar, Produccion para planear y ejecutar con evidencia.
- Revisa el diff con Lucky: View Git Diff. Si algo no te gusta, Lucky: Undo Last Task Changes lo revierte.
En VS Code tambien tienes el recorrido Primeros pasos con Lucky Code (comando Welcome: Open Walkthrough...).
Configuracion
Todos los ajustes empiezan con lucky. y se editan en la configuracion de VS Code. Los principales:
| Ajuste |
Para que sirve |
lucky.chat.provider |
Proveedor preferido para el chat. |
lucky.permissions.mode |
Solo lectura, escritura del proyecto o acceso completo. |
lucky.routing.profile |
Como se reparte el trabajo entre proveedores. |
lucky.testCommand |
Comando de pruebas del proyecto, si no se detecta solo. |
lucky.budget.dailyUsdLimit |
Tope de gasto diario en dolares. |
lucky.budget.maxTotalInvocations |
Llamadas permitidas por ventana de uso. |
lucky.providers.*.command |
Ejecutable de cada proveedor, si no esta en el PATH. |
lucky.settings.privacy.allowContext.* |
A que proveedores se les permite recibir contexto del proyecto. |
lucky.edge.chat.enabled |
Activa el carril rapido del borde. |
lucky.edge.chat.consent |
Pregunta, siempre o nunca antes de enviar al borde. |
Las claves de API no se guardan en el proyecto. DeepSeek por API lee la clave de la variable de entorno que indica lucky.providers.deepseekPro.apiKeyEnv (por defecto DEEPSEEK_API_KEY) y cobra el proveedor, no Lucky.
Llave del borde
El carril rapido necesita una llave. Corre Lucky: guardar llave del borde, pega la llave y listo. Queda en el almacen seguro de VS Code, atada a la direccion del borde. Si cambias lucky.edge.chat.url, la llave vieja no se envia a la direccion nueva. Para quitarla usa Lucky: borrar llave del borde.
Para usar Lucky Code en el navegador, sin instalar nada, corre Lucky: abrir Lucky Code Cloud.
Privacidad
Lo que sale del equipo y cuando:
- Proveedores locales. Lucky les pasa un contexto acotado de la tarea, nunca el repositorio completo. Lo que cada proveedor haga con eso depende de su propio servicio y de tus ajustes con el.
- Ollama y modelos locales. El contexto no sale del equipo.
- Proveedores por API. Solo reciben contexto si activas su permiso en
lucky.settings.privacy.allowContext.*. Esos permisos vienen apagados, salvo el del proveedor local y el de Antigravity.
- Borde. Viene apagado. Si lo activas, y mientras el consentimiento sea
preguntar, antes de cada turno ves un aviso con lo que se envia: tu pregunta, recortada a 2000 caracteres. Solo eso: ni archivos ni contexto del proyecto. Si la pregunta contiene algo que parece un secreto, no se envia.
- Secretos. Lucky redacta las claves y credenciales que detecta en lo que el ejecutor por API manda al proveedor.
- Archivos locales. El historial del chat, el contexto actual y los adjuntos viven en
.lucky/, dentro del proyecto. Si no quieres versionarlos, agrega esa carpeta a tu .gitignore.
- Telemetria. La extension no incluye telemetria.
Lucky Code Cloud
Si no puedes instalar nada, Lucky Code tambien existe en el navegador, en agent.getlucky.company/code. Trabaja sobre una carpeta de tu equipo con la misma disciplina de la extension. La carpeta no se sube entera, ves lo que sale y ningun archivo cambia sin que apruebes el parche.
Soporte
Escribe a admin@getlucky.company con la version de la extension (aparece en la pestana de Extensiones) y, si puedes, la salida de Lucky: Run Preflight Diagnostics.
Desarrollo
npm install
npm run check
npm run package
npm run check compila y corre las pruebas. npm run package verifica y genera el VSIX en dist/. Con F5 en VS Code se abre un Extension Development Host. Las reglas para contribuir estan en CONTRIBUTING.md.
Licencia
AGPL-3.0-or-later. Hay licencia comercial disponible, ver COMMERCIAL-LICENSE.md en el repositorio.
