Cómo usar Kiro CLI: guía paso a paso

Para usar Kiro CLI, instálalo con curl -fsSL https://cli.kiro.dev/install | bash (o con brew install kiro-cli en macOS), inicia sesión en el navegador, ejecuta kiro-cli dentro de la carpeta de un proyecto y describe lo que quieres. Kiro lee tu código, edita archivos y ejecuta comandos, y te pregunta antes de usar cualquier herramienta en la que aún no confíes. Escribe /model para elegir modelo o deja Auto y que Kiro decida.

Ese es el ciclo básico. Esta guía cubre el resto: el inicio de sesión, los comandos de chat que usarás a diario, modelos y créditos, archivos de steering, agentes propios, servidores MCP, specs, Kiro en CI y cómo usarlo junto a otros agentes. Todo sigue la documentación oficial de Kiro a octubre de 2026.

Qué es Kiro

Kiro es el entorno de desarrollo agéntico de AWS. Tiene varias formas que comparten una misma cuenta: un IDE de escritorio, la CLI y Kiro Web. La CLI es la parte de terminal. Ofrece un chat interactivo con una interfaz de terminal a pantalla completa, un modo headless para scripts y CI, y puede funcionar como agente en editores que hablan Agent Client Protocol (ACP).

Lo que distingue a Kiro de otros agentes de código es su apuesta por las specs. Antes de escribir el código de una funcionalidad, Kiro puede convertir tu idea en requisitos, un diseño y una lista de tareas, y luego ir completando las tareas. Si el enfoque te resulta nuevo, Desarrollo guiado por especificaciones con agentes de IA explica la idea y compara Kiro con otras herramientas que lo hacen.

Una nota sobre versiones: el instalador te da Kiro CLI 2.x. La versión 3 es una versión temprana que puedes probar con kiro-cli --v3. Convive con tu instalación 2.x y tu configuración queda como está hasta que cambies. Esta guía sigue 2.x y avisa donde V3 es distinta.

Paso 1: instala Kiro CLI

En Linux también hay un paquete .deb, un AppImage y un zip. La CLI necesita glibc 2.34 o posterior; en distribuciones más antiguas, usa la variante musl del zip. En Windows, ejecuta el instalador en PowerShell o en Windows Terminal; el antiguo Símbolo del sistema no está soportado.

Comprueba que todo funciona:

kiro-cli doctor

kiro-cli update busca una versión nueva y kiro-cli settings app.disableAutoupdates true desactiva las actualizaciones automáticas. Si instalaste con Homebrew, actualiza con brew upgrade --greedy kiro-cli.

Paso 2: inicia sesión

Tras la instalación, Kiro abre el navegador para que inicies sesión. Las opciones son:

• GitHub o Google: lo más rápido para uso individual.
• AWS Builder ID: una identidad personal y gratuita de AWS.
• AWS IAM Identity Center: para empresas que gestionan Kiro desde AWS. Introduces la URL de inicio y la región de tu organización.
• Un proveedor de identidad externo: como Okta o Microsoft Entra ID, si tu empresa lo ha configurado.

Usa kiro-cli login para volver a iniciar sesión cuando quieras. En una máquina remota sin navegador, kiro-cli login --use-device-flow muestra una URL y un código para abrir en otro dispositivo. El device flow funciona con Builder ID, IAM Identity Center, Google y GitHub, pero no con un proveedor de identidad externo. kiro-cli whoami muestra con qué cuenta estás conectado y kiro-cli logout cierra la sesión.

Conviene saberlo: en el plan gratuito y en los planes individuales, Kiro puede usar tu contenido para mejorar el servicio. Puedes desactivarlo; la documentación de Kiro explica cómo.

Paso 3: lo básico del chat

Entra en un proyecto e inicia Kiro:

cd my-project
kiro-cli

La interfaz de terminal es la opción por defecto. Hay unas cuantas cosas que usarás todo el rato:

• @ruta adjunta un archivo a tu mensaje.
• ! al inicio de una línea ejecuta un comando de shell directamente, por ejemplo !npm test.
• Shift+Tab cambia al modo plan, donde Kiro piensa un cambio antes de tocar el código.
• Shift+Enter o Ctrl+J inserta un salto de línea, Ctrl+O despliega la salida larga y Ctrl+C sale.
• /paste pega una imagen del portapapeles.

Los chats se guardan por carpeta. kiro-cli chat --resume retoma el último chat de la carpeta actual, --resume-picker te deja elegir uno y --list-sessions los lista. Si prefieres la interfaz antigua línea a línea, arranca con kiro-cli chat --classic.

Paso 4: modelos y créditos

Por defecto, Kiro usa Auto, que envía cada petición a un modelo adecuado. La documentación lo recomienda para la mayoría de tareas. Para elegir tú, escribe /model en el chat o lista los modelos desde la shell:

kiro-cli chat --list-models

Para dejar un modelo como predeterminado, configúralo:

kiro-cli settings chat.defaultModel "claude-sonnet-4.6"

Kiro cobra en créditos y cada modelo tiene un multiplicador. A octubre de 2026, Claude Opus 5 cuenta 2,2 veces, Claude Sonnet 5.5 1,3 veces, DeepSeek 3.2 0,25 veces y Qwen3 Coder Next 0,05 veces. La misma tarea puede costar muy distinto según el modelo, así que mira /usage de vez en cuando.

Los planes de pago pueden seguir más allá de sus créditos a 0,04 $ por crédito, y hay paquetes adicionales. El plan gratuito cubre los modelos open-weight y Claude Sonnet 4.5; para los modelos Claude más nuevos necesitas un plan de pago. Precios y modelos cambian a menudo, así que revisa kiro.dev/pricing antes de decidir.

Paso 5: archivos de steering y AGENTS.md

Los archivos de steering son archivos Markdown con las reglas de tu proyecto: qué hace el producto, el stack técnico, dónde está cada cosa, qué evitar. Kiro los busca en dos sitios:

• Workspace: .kiro/steering/ dentro del proyecto, versionado junto al código.
• Global: ~/.kiro/steering/, para reglas que quieres en todas partes. Si se contradicen, gana el workspace.

La documentación recomienda empezar con tres archivos: product.md, tech.md y structure.md. Por defecto, un archivo de steering se incluye en todos los chats. Puedes limitarlo a ciertos archivos con front matter:

---
inclusion: fileMatch
fileMatchPattern: "components/**/*.tsx"
---

- Los componentes son funcionales y usan exportaciones con nombre.
- Los estilos usan CSS modules; nada de estilos en línea.

Hay cuatro modos: always (el predeterminado), fileMatch, manual (lo incorporas con #nombre-de-archivo) y auto (Kiro decide según el nombre y la descripción del archivo). Kiro CLI 2.x solo carga automáticamente los archivos always; V3 admite los cuatro.

Kiro también lee AGENTS.md y lo trata como un archivo de steering que se incluye siempre. Si tu equipo ya mantiene uno para Codex, opencode u otros agentes, Kiro lo usa tal cual. Para saber qué poner, consulta Buenas prácticas de CLAUDE.md.

Paso 6: agentes propios

Un agente propio es una configuración guardada con su prompt, modelo, herramientas y archivos de contexto. Créalo con:

kiro-cli agent create my-agent

Los agentes viven en .kiro/agents/ (por proyecto) o ~/.kiro/agents/ (globales), en JSON o, con V3, también en Markdown. Un ejemplo corto:

{
  "name": "my-agent",
  "description": "Reviews backend changes",
  "prompt": "You are a careful backend reviewer.",
  "model": "claude-sonnet-4.6",
  "includeMcpJson": true,
  "resources": ["file://.kiro/steering/**/*.md", "file://./ARCHITECTURE.md"]
}

Abre un chat con él usando kiro-cli --agent my-agent, cambia dentro del chat con /agent o conviértelo en el predeterminado con kiro-cli settings chat.defaultAgent my-agent. kiro-cli agent list muestra tus agentes y kiro-cli agent validate revisa un archivo.

Dos detalles. Primero, los agentes propios no incluyen los archivos de steering por sí solos; por eso el ejemplo añade .kiro/steering/**/*.md en resources. Segundo, los agentes de la carpeta de un proyecto solo se cargan cuando confías en ese workspace. Los campos de permisos de herramientas difieren entre 2.x y V3; /upgrade-agent convierte un agente cuando pasas a V3.

Paso 7: servidores MCP

Los servidores MCP dan a Kiro herramientas nuevas: búsqueda en documentación, un navegador, tu gestor de incidencias. Van en un archivo mcp.json, ya sea .kiro/settings/mcp.json en el proyecto o ~/.kiro/settings/mcp.json para todos los proyectos:

{
  "mcpServers": {
    "fetch": {
      "command": "uvx",
      "args": ["mcp-server-fetch"],
      "disabled": false
    },
    "my-remote": {
      "url": "https://mcp.example.com/mcp"
    }
  }
}

Un servidor local es un comando que Kiro arranca; uno remoto es una URL (HTTPS, o HTTP en localhost), con headers opcionales e inicio de sesión OAuth. Desde la shell, kiro-cli mcp add añade un servidor, kiro-cli mcp list muestra la configuración y kiro-cli mcp status indica si cada servidor está en marcha. Dentro del chat, /mcp hace lo mismo y gestiona los servidores que piden iniciar sesión.

Si el mismo servidor está definido en varios sitios, la configuración de un agente se impone al archivo del workspace, y el del workspace al global. Cada servidor añade herramientas al contexto, así que desactiva los que no uses con "disabled": true.

Paso 8: specs

Las specs son la seña de identidad de Kiro. Para cualquier cosa mayor que un arreglo rápido, crea una:

/spec new user-invitations

Kiro escribe tres archivos en .kiro/specs/user-invitations/: requirements.md con historias de usuario y criterios de aceptación en notación EARS («Cuando X, el sistema deberá Y»), design.md con el enfoque técnico y tasks.md con una lista numerada de tareas. Lee y corrige cada archivo antes de seguir; esa revisión es justo lo que da sentido al proceso. Después, deja que Kiro complete las tareas:

/spec run user-invitations

Los archivos de la spec son Markdown normal. Si los versionas, se convierten en documentación para el siguiente cambio. Para cambios más pequeños, el modo plan (Shift+Tab o /plan) ofrece una versión más ligera del mismo hábito.

Paso 9: modo headless y CI

Para scripts y CI, ejecuta Kiro sin la interfaz de chat:

export KIRO_API_KEY=your-key
kiro-cli chat --v3 --no-interactive --trust-tools=read_file,grep_search "Summarize the risky changes in this branch"

--trust-tools lista las herramientas que Kiro puede usar sin preguntar (los nombres de aquí son de V3, por eso el ejemplo usa --v3, igual que el ejemplo de GitHub Actions de la documentación). --trust-all-tools lo permite todo, así que úsalo solo en un sandbox. --require-mcp-startup hace fallar la ejecución si un servidor MCP no arranca. Las claves de API están disponibles en los planes Pro, Pro+, Pro Max y Power. Para editores compatibles con ACP, kiro-cli acp ejecuta Kiro como su agente.

Errores habituales

• El instalador falla en Windows. Estás en el Símbolo del sistema. Usa PowerShell o Windows Terminal en Windows 11.
• El binario no arranca en un Linux antiguo. La glibc es anterior a la 2.34. Usa el zip musl.
• Tus reglas de steering se ignoran. El archivo usa fileMatch o auto, que 2.x no carga automáticamente, o estás en un agente propio sin el recurso de steering.
• Los créditos se van rápido. Un modelo caro o un chat largo. Mira /usage, prueba Auto y usa /compact.
• Los comandos de AWS dejaron de funcionar en V3. V3 eliminó la herramienta de AWS integrada; usa en su lugar un servidor MCP de AWS.
• No aparece la opción de clave de API. El modo headless necesita un plan de pago.

¿Kiro CLI u otro agente?

Kiro encaja bien si te gusta planificar con specs, si tu empresa ya gestiona el acceso con AWS IAM Identity Center o si quieres una sola factura que cubra modelos premium y modelos open-weight baratos. Encaja peor si quieres usar tu propia clave de API o modelos locales; eso lo hace opencode con cualquier proveedor. Si ya pagas Claude o ChatGPT, Claude Code o Codex CLI aprovechan directamente esa suscripción. Mejores alternativas a Claude Code compara los principales agentes de CLI uno junto a otro.

Usar Kiro CLI junto a otros agentes

Muchos equipos no se quedan con un solo agente. Kiro escribe la spec, Claude Code o Codex construye una parte y otro agente revisa. Con pestañas de terminal, eso se desordena enseguida. AgentVera es una app de escritorio que ejecuta estas CLI lado a lado en terminales reales, con tus propias instalaciones y sesiones. El soporte de Kiro CLI funciona así:

• Tu sesión de Kiro. AgentVera abre kiro-cli chat en una terminal real. Inicias sesión con kiro-cli login; si no la tienes iniciada, la terminal del agente te pide que lo hagas.
• Modelo y esfuerzo por agente. Deja el modelo vacío para usar el predeterminado de Kiro o elige uno por agente. El esfuerzo va de bajo a máximo.
• Reglas desde tus archivos. Kiro CLI no tiene un flag de instrucciones adicionales, así que las instrucciones permanentes salen de AGENTS.md o de los archivos de reglas del proyecto.
• Tu mcp.json sigue siendo tuyo. Los servidores MCP que añades en AgentVera y el navegador de AgentVera se combinan con tu propio mcp.json de Kiro en cada arranque.
• Las sesiones continúan. Al reanudar un agente, se abre con su ID de sesión o con la última sesión de la carpeta.
• Paneles, flujos y revisión. Ejecuta Kiro en la cuadrícula del workspace junto a Claude Code o Codex, cada uno en su propio git worktree. Los agentes de Kiro funcionan en flujos, mensajes masivos y tareas programadas, y reciben una revisión de código automática al terminar cada turno.

La cuadrícula, los worktrees, la revisión de código y el gestor de MCP están en el plan gratuito; los flujos, en Pro y Team. Descarga AgentVera para probarlo.

Conclusión

Para usar Kiro CLI, instálalo, inicia sesión, ejecuta kiro-cli en un proyecto y describe el cambio. Deja el modelo en Auto hasta que tengas un motivo para cambiarlo y vigila /usage. Las reglas del proyecto van en .kiro/steering/ o AGENTS.md, las herramientas en mcp.json y las configuraciones que repites en agentes propios. Para cualquier cosa mayor que un arreglo rápido, empieza con /spec new: revisar requisitos y una lista de tareas antes de que exista el código es lo que Kiro hace mejor.