Kiro
Esta guía cubre la autenticación, configuración y uso de Kiro en un entorno de sandbox.
Documentación oficial: Kiro CLI
Inicio rápido
Crea un sandbox y ejecuta Kiro para un directorio de proyecto:
$ sbx run kiro ~/mi-proyecto
El parámetro del espacio de trabajo es opcional y toma como valor predeterminado el directorio actual:
$ cd ~/mi-proyecto
$ sbx run kiro
En la primera ejecución, Kiro te pedirá que te autentiques utilizando el flujo de dispositivo.
Autenticación
Kiro utiliza la autenticación de flujo de dispositivo, la cual requiere un inicio de sesión interactivo a través de un navegador web. Este método proporciona una autenticación segura sin almacenar directamente claves de API.
Inicio de sesión mediante flujo de dispositivo
La primera vez que ejecutas Kiro, te pedirá que te autentiques:
- Kiro muestra una URL y un código de verificación
- Abre la URL en tu navegador web
- Introduce el código de verificación
- Completa el flujo de autenticación en tu navegador
- Regresa a la terminal: Kiro procederá automáticamente
La sesión de autenticación persiste en el sandbox y no requiere inicios de sesión repetidos a menos que destruyas y vuelvas a crear el sandbox.
Inicio de sesión manual
Puedes iniciar el flujo de inicio de sesión de forma manual:
$ sbx run kiro --name <nombre-sandbox> -- login --use-device-flow
Este comando inicia la autenticación de flujo de dispositivo sin comenzar una sesión de desarrollo.
Persistencia de la autenticación
Kiro almacena el estado de autenticación en ~/.local/share/kiro-cli/data.sqlite3 dentro del sandbox. Esta base de datos persiste mientras exista el sandbox. Si destruyes el sandbox, tendrás que autenticarte de nuevo cuando lo vuelvas a crear.
Configuración
Los sandboxes no heredan la configuración a nivel de usuario de tu host. Solo la configuración a nivel de proyecto en el directorio de trabajo está disponible dentro del sandbox. Consulta ¿Por qué el sandbox no utiliza la configuración de mi agente a nivel de usuario? para conocer las soluciones alternativas.
Kiro requiere una configuración mínima. El agente se ejecuta en modo trust-all-tools (confiar en todas las herramientas) de forma predeterminada, lo que le permite ejecutar comandos sin avisos de aprobación repetidos.
Pasar opciones en tiempo de ejecución
Pasa opciones de la CLI de Kiro después de --:
$ sbx run kiro --name <nombre-sandbox> -- <opciones-de-kiro>
Imagen base
Plantilla: docker/sandbox-templates:kiro
Preconfigurado para ejecutarse sin avisos de aprobación. El estado de autenticación persiste a lo largo de los reinicios del sandbox.
Consulta Personalización para preinstalar herramientas o personalizar este entorno.