lucky-agent
v0.4.0
Published
Puente local de Lucky Agent: lee, escribe y ejecuta en tu carpeta de trabajo solo con tu aprobación.
Readme
lucky-agent
Puente local para conectar un equipo con Lucky y usar el modo MCP dentro de una carpeta de trabajo.
Instalacion
npx lucky-agent conectarEn Windows: irm https://agent.getlucky.company/i | iex
En macOS o Linux: curl -fsSL https://agent.getlucky.company/i | sh
Comandos
lucky conectar [--nombre equipo]solicita un codigo y guarda la conexion.lucky estadomuestra la base, alcances, vencimiento, version de Node y donde se guarda la credencial, nunca la llave.lucky desconectarborra la credencial del llavero o del archivo. La revocacion del equipo se hace desde/cuentas/yo.lucky mcpinicia el servidor MCP local usando la credencial guardada.lucky puenteaprueba en esta terminal las acciones propuestas por Lucky.lucky guiamuestra una guia corta.lucky sparkles [--abrir]presenta Lucky Sparkles PrintLab y su enlace.
Seguridad
Cada accion se aprueba en la terminal. La carpeta de trabajo limita las rutas, los comandos peligrosos se bloquean,
los secretos no se leen y la llave se manda solo como Authorization: Bearer. La llave queda guardada por equipo,
con permisos privados, y se puede revocar. En Windows la proteccion depende de los permisos de la carpeta del usuario,
no de 0600. Los comandos destructivos del sistema nunca se ejecutan.
La credencial usa el llavero del sistema con servicio lucky-agent y cuenta igual a la base: Credential Manager en Windows,
Keychain en macOS y Secret Service mediante secret-tool en Linux. Si no existe o falla, queda en
~/.lucky-agent/credencial.json con permisos privados, en Windows se ajusta tambien con icacls.
Si ya existe ese archivo, se migra al llavero y solo se borra despues de leerlo y verificarlo.
LUCKY_LLAVERO=archivo fuerza el archivo, sirve para pruebas y como salida de emergencia. En macOS security add-generic-password
recibe la credencial como argumento por la limitacion de ese comando, no se usa asi en Windows ni Linux.
Licencia
Este paquete se distribuye bajo AGPL-3.0-or-later. Tambien existe una licencia comercial dual en COMMERCIAL-LICENSE.md.
