O Kiro CLI é a interface de linha de comando do Kiro IDE da AWS. Ele traz a mesma inteligência agêntica da IDE para o terminal, usando os mesmos steering files, as mesmas integrações MCP e o mesmo agente Auto que otimiza qualidade, velocidade e custo automaticamente. A documentação oficial o descreve como “a lightning-fast coding experience that adapts to how you work.”
Para desenvolvedores backend, engenheiros DevOps e quem trabalha em servidores remotos via SSH, o Kiro CLI é a forma mais natural de usar IA no desenvolvimento: sem interface gráfica, sem mouse, sem troca de contexto entre terminal e IDE.
O que é o Kiro CLI e como se diferencia da IDE
O Kiro CLI e o Kiro IDE compartilham o mesmo motor de IA e a mesma configuração (pasta .kiro/). A diferença é a interface: enquanto a IDE oferece uma experiência visual completa baseada no Code OSS, o CLI opera inteiramente no terminal.
Na prática, tudo que você configura na IDE (steering files, hooks, MCP servers) funciona no CLI automaticamente, sem reconfiguração. Você pode alternar entre IDE e terminal no mesmo projeto sem perder contexto.
O CLI é ideal para três cenários que a IDE não cobre tão bem: trabalho em servidores headless via SSH, automação em pipelines de CI/CD, e fluxos de desenvolvimento onde o terminal já é o ambiente principal.
Como instalar o Kiro CLI
O CLI está disponível para macOS e Linux. No Windows, funciona via WSL (Windows Subsystem for Linux).
Instalação (macOS e Linux):
curl -fsSL https://cli.kiro.dev/install | bashApós a instalação, reinicie o terminal ou execute source ~/.bashrc (ou ~/.zshrc no macOS). Verifique com:
kiro-cli --versionAutenticação:
kiro-cli loginO comando abre o navegador para login com GitHub, Google ou AWS Builder ID — as mesmas opções da IDE. Em servidores sem browser, o login funciona via device flow: o CLI exibe um código que você insere em qualquer navegador.
Windows (WSL): instale o WSL primeiro (Windows 11 ou Windows 10 build 2004+) e siga os mesmos passos acima dentro do ambiente Linux do WSL.
A documentação completa de instalação está em kiro.dev/docs/cli/installation.
Comandos essenciais e slash commands
Com o CLI instalado e autenticado, os principais comandos para começar:
Iniciar uma sessão de chat:
kiro-cli chatAbre um chat interativo com o agente no terminal. Dentro do chat, você pode usar slash commands:
| Comando | O que faz |
|---|---|
/help | Ativa o Help Agent integrado, que responde com base na documentação oficial |
/agent swap | Alterna entre agentes customizados na mesma sessão |
/agent create | Cria um novo agente customizado com assistência de IA |
/model | Mostra e permite trocar o modelo de IA (Auto, Sonnet 4, Sonnet 4.5, Haiku 4.5, Opus) |
/mcp | Lista MCP servers conectados na sessão |
/context show | Mostra o contexto ativo (steering files, skills, recursos) |
/save e /load | Exporta/importa o estado da conversa em JSON |
/usage | Mostra estimativa de uso da janela de contexto |
! | Executa um comando shell de dentro da sessão Kiro |
Abrir um projeto:
kiro .Abre o Kiro CLI no diretório atual (mesmo conceito do code . para VS Code). Os steering files e MCP servers do projeto são carregados automaticamente.
Agentes customizados no Kiro CLI
Agentes customizados são configurações especializadas que definem quais ferramentas o agente pode usar, quais permissões tem e qual contexto deve carregar. A documentação de custom agents explica o conceito em detalhes.
Para criar um agente, use o slash command dentro de uma sessão de chat:
/agent createO CLI pede nome, descrição e escopo (local ou global), e gera a configuração automaticamente com assistência de IA. O arquivo é salvo em .kiro/agents/ (workspace) ou ~/.kiro/agents/ (global) no formato JSON.
Exemplo: agente especialista em AWS
json
{
"name": "aws-specialist",
"description": "Agente para infraestrutura AWS",
"prompt": "Você é um especialista em infraestrutura AWS com foco em boas práticas",
"tools": ["read", "write", "shell", "aws"],
"allowedTools": ["read", "aws"],
"toolsSettings": {
"aws": {
"allowedServices": ["s3", "lambda", "cloudformation", "ec2", "iam"]
}
},
"resources": [
"file://README.md",
"file://infrastructure/**/*.yaml"
],
"model": "claude-sonnet-4"
}Para usar o agente em uma sessão:
kiro-cli --agent aws-specialistOu alterne durante uma sessão ativa com /agent swap.
O poder dos agentes customizados está no campo allowedTools: ferramentas pré-aprovadas não pedem confirmação a cada uso, eliminando interrupções durante o fluxo de trabalho. Para ferramentas sensíveis (como escrita de arquivos ou execução de shell), mantenha fora do allowedTools para que o CLI peça aprovação.
Subagentes: delegando tarefas em paralelo
Desde a versão 1.26 (fevereiro de 2026), o Kiro CLI suporta subagentes: agentes especializados que rodam em paralelo, cada um com seu contexto e permissões. O agente principal delega tarefas para subagentes, que executam e devolvem resultados.
Na prática, isso permite fluxos como: o agente principal recebe uma tarefa complexa, delega a pesquisa para um subagente de documentação, a implementação para um subagente de código e a validação para um subagente de testes — todos executando em paralelo.
Você controla quais agentes podem ser usados como subagentes (availableAgents) e quais podem rodar sem confirmação (trustedAgents) na configuração do agente principal.
Agent Client Protocol: Kiro CLI em JetBrains e Zed
Desde a versão 1.25 (fevereiro de 2026), o CLI suporta o Agent Client Protocol (ACP), um padrão aberto que permite usar o agente do Kiro dentro de editores compatíveis como JetBrains IDEs e Zed. O comando:
kiro-cli acpInicia o Kiro como agente ACP que se comunica via stdin/stdout usando JSON-RPC. Isso significa que desenvolvedores que usam IntelliJ, PyCharm, WebStorm ou Zed podem ter acesso às capacidades agênticas do Kiro sem trocar de editor.
Kiro CLI em pipelines de CI/CD
Uma das aplicações mais poderosas do CLI é a integração em pipelines de CI/CD. O agente pode ser chamado como etapa de um workflow para tarefas automatizadas como análise de segurança, geração de testes e verificação de conformidade.
O CLI suporta configuração de permissões granulares para ambientes automatizados: quais comandos shell podem ser executados, quais paths podem ser escritos e quais serviços AWS podem ser acessados. Isso garante que o agente opera dentro de limites seguros em ambientes de produção.
Para times que querem o Kiro em pipelines mas precisam de governança, o MCP Registry permite controlar centralmente quais ferramentas o CLI pode acessar.
Perguntas frequentes sobre o Kiro CLI
O Kiro CLI é gratuito?
O CLI usa o mesmo plano da conta Kiro. No plano Free (50 créditos/mês), o CLI tem os mesmos limites da IDE. Planos Pro, Pro+ e Power ampliam a capacidade para ambos. O agente Auto, que otimiza custo automaticamente, é o padrão tanto no CLI quanto na IDE.
Posso usar o Kiro CLI em servidores sem interface gráfica?
Sim, esse é um dos principais cenários de uso. O CLI foi projetado para servidores headless, containers Docker e ambientes de CI/CD. A autenticação funciona via device flow mesmo sem browser no servidor: o CLI exibe um código que você insere em qualquer navegador.
O histórico de conversas é salvo?
Sim. O CLI mantém histórico de sessões associado ao diretório do projeto. Você pode retomar uma conversa anterior com kiro-cli chat no mesmo diretório. Também é possível exportar e importar estados de conversa com /save e /load.
Qual a diferença entre Kiro CLI e Kiro Autonomous Agent?
O CLI é para desenvolvimento interativo no terminal — você conversa com o agente em tempo real. O Autonomous Agent trabalha de forma assíncrona em segundo plano, em sandboxes na nuvem, enquanto você foca em outra coisa. São complementares.
O CLI funciona em Windows?
Nativamente, não. O Kiro CLI é suportado em macOS e Linux. No Windows, funciona via WSL (Windows Subsystem for Linux) com os mesmos comandos da versão Linux.
