{"id":22940,"date":"2026-04-27T10:00:00","date_gmt":"2026-04-27T13:00:00","guid":{"rendered":"https:\/\/uds.com.br\/blog\/?p=22940"},"modified":"2026-05-04T16:02:44","modified_gmt":"2026-05-04T19:02:44","slug":"kiro-cli-terminal","status":"publish","type":"post","link":"https:\/\/uds.com.br\/blog\/kiro-cli-terminal\/","title":{"rendered":"Kiro CLI: como usar o agente de IA da AWS direto no terminal"},"content":{"rendered":"\n

O Kiro CLI \u00e9 a interface de linha de comando do Kiro IDE da AWS. Ele traz a mesma intelig\u00eancia ag\u00eantica da IDE para o terminal, usando os mesmos steering files, as mesmas integra\u00e7\u00f5es MCP e o mesmo agente Auto que otimiza qualidade, velocidade e custo automaticamente. A documenta\u00e7\u00e3o oficial<\/a> o descreve como “a lightning-fast coding experience that adapts to how you work.”<\/p>\n\n\n\n

Para desenvolvedores backend, engenheiros DevOps e quem trabalha em servidores remotos via SSH, o Kiro CLI \u00e9 a forma mais natural de usar IA no desenvolvimento: sem interface gr\u00e1fica, sem mouse, sem troca de contexto entre terminal e IDE.<\/p>\n\n\n\n

O que \u00e9 o Kiro CLI e como se diferencia da IDE<\/strong><\/h2>\n\n\n\n

O Kiro CLI e o Kiro IDE compartilham o mesmo motor de IA e a mesma configura\u00e7\u00e3o (pasta .kiro\/<\/code>). A diferen\u00e7a \u00e9 a interface: enquanto a IDE oferece uma experi\u00eancia visual completa baseada no Code OSS, o CLI opera inteiramente no terminal.<\/p>\n\n\n\n

Na pr\u00e1tica, tudo que voc\u00ea configura na IDE (steering files, hooks, MCP servers) funciona no CLI automaticamente, sem reconfigura\u00e7\u00e3o. Voc\u00ea pode alternar entre IDE e terminal no mesmo projeto sem perder contexto.<\/p>\n\n\n\n

O CLI \u00e9 ideal para tr\u00eas cen\u00e1rios que a IDE n\u00e3o cobre t\u00e3o bem: trabalho em servidores headless via SSH, automa\u00e7\u00e3o em pipelines de CI\/CD, e fluxos de desenvolvimento onde o terminal j\u00e1 \u00e9 o ambiente principal.<\/p>\n\n\n\n

Como instalar o Kiro CLI<\/strong><\/h2>\n\n\n\n

O CLI est\u00e1 dispon\u00edvel para macOS e Linux. No Windows, funciona via WSL (Windows Subsystem for Linux).<\/p>\n\n\n\n

Instala\u00e7\u00e3o (macOS e Linux):<\/strong><\/p>\n\n\n\n

curl -fsSL https:\/\/cli.kiro.dev\/install | bash<\/code><\/pre>\n\n\n\n
Ap\u00f3s a instala\u00e7\u00e3o, reinicie o terminal ou execute source ~\/.bashrc<\/code> (ou ~\/.zshrc<\/code> no macOS). Verifique com:<\/p>\n\n\n\n
kiro-cli --version<\/code><\/pre>\n\n\n\n
Autentica\u00e7\u00e3o:<\/strong><\/p>\n\n\n\n
kiro-cli login<\/code><\/pre>\n\n\n\n
O comando abre o navegador para login com GitHub, Google ou AWS Builder ID \u2014 as mesmas op\u00e7\u00f5es da IDE. Em servidores sem browser, o login funciona via device flow: o CLI exibe um c\u00f3digo que voc\u00ea insere em qualquer navegador.<\/p>\n\n\n\n
Windows (WSL):<\/strong> instale o WSL primeiro (Windows 11 ou Windows 10 build 2004+) e siga os mesmos passos acima dentro do ambiente Linux do WSL.<\/p>\n\n\n\n
A documenta\u00e7\u00e3o completa de instala\u00e7\u00e3o est\u00e1 em kiro.dev\/docs\/cli\/installation<\/a>.<\/p>\n\n\n\n
Comandos essenciais e slash commands<\/strong><\/h2>\n\n\n\n
Com o CLI instalado e autenticado, os principais comandos para come\u00e7ar:<\/p>\n\n\n\n
Iniciar uma sess\u00e3o de chat:<\/strong><\/p>\n\n\n\n
kiro-cli chat<\/code><\/pre>\n\n\n\n
Abre um chat interativo com o agente no terminal. Dentro do chat, voc\u00ea pode usar slash commands:<\/p>\n\n\n\n
Comando<\/th>O que faz<\/th><\/tr><\/thead>
\/help<\/code><\/td>Ativa o Help Agent integrado, que responde com base na documenta\u00e7\u00e3o oficial<\/td><\/tr>
\/agent swap<\/code><\/td>Alterna entre agentes customizados na mesma sess\u00e3o<\/td><\/tr>
\/agent create<\/code><\/td>Cria um novo agente customizado com assist\u00eancia de IA<\/td><\/tr>
\/model<\/code><\/td>Mostra e permite trocar o modelo de IA (Auto, Sonnet 4, Sonnet 4.5, Haiku 4.5, Opus)<\/td><\/tr>
\/mcp<\/code><\/td>Lista MCP servers conectados na sess\u00e3o<\/td><\/tr>
\/context show<\/code><\/td>Mostra o contexto ativo (steering files, skills, recursos)<\/td><\/tr>
\/save<\/code> e \/load<\/code><\/td>Exporta\/importa o estado da conversa em JSON<\/td><\/tr>
\/usage<\/code><\/td>Mostra estimativa de uso da janela de contexto<\/td><\/tr>
!<\/code><\/td>Executa um comando shell de dentro da sess\u00e3o Kiro<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
Abrir um projeto:<\/strong><\/p>\n\n\n\n
kiro .<\/code><\/pre>\n\n\n\n
Abre o Kiro CLI no diret\u00f3rio atual (mesmo conceito do code .<\/code> para VS Code). Os steering files e MCP servers do projeto s\u00e3o carregados automaticamente.<\/p>\n\n\n\n
Agentes customizados no Kiro CLI<\/strong><\/h2>\n\n\n\n
Agentes customizados s\u00e3o configura\u00e7\u00f5es especializadas que definem quais ferramentas o agente pode usar, quais permiss\u00f5es tem e qual contexto deve carregar. A documenta\u00e7\u00e3o de custom agents<\/a> explica o conceito em detalhes.<\/p>\n\n\n\n
Para criar um agente, use o slash command dentro de uma sess\u00e3o de chat:<\/p>\n\n\n\n
\/agent create<\/code><\/pre>\n\n\n\n
O CLI pede nome, descri\u00e7\u00e3o e escopo (local ou global), e gera a configura\u00e7\u00e3o automaticamente com assist\u00eancia de IA. O arquivo \u00e9 salvo em .kiro\/agents\/<\/code> (workspace) ou ~\/.kiro\/agents\/<\/code> (global) no formato JSON.<\/p>\n\n\n\n
Exemplo: agente especialista em AWS<\/strong><\/p>\n\n\n\n
json<\/p>\n\n\n\n
{\n  \"name\": \"aws-specialist\",\n  \"description\": \"Agente para infraestrutura AWS\",\n  \"prompt\": \"Voc\u00ea \u00e9 um especialista em infraestrutura AWS com foco em boas pr\u00e1ticas\",\n  \"tools\": [\"read\", \"write\", \"shell\", \"aws\"],\n  \"allowedTools\": [\"read\", \"aws\"],\n  \"toolsSettings\": {\n    \"aws\": {\n      \"allowedServices\": [\"s3\", \"lambda\", \"cloudformation\", \"ec2\", \"iam\"]\n    }\n  },\n  \"resources\": [\n    \"file:\/\/README.md\",\n    \"file:\/\/infrastructure\/**\/*.yaml\"\n  ],\n  \"model\": \"claude-sonnet-4\"\n}<\/code><\/pre>\n\n\n\n
Para usar o agente em uma sess\u00e3o:<\/p>\n\n\n\n
kiro-cli --agent aws-specialist<\/code><\/pre>\n\n\n\n
Ou alterne durante uma sess\u00e3o ativa com \/agent swap<\/code>.<\/p>\n\n\n\n
O poder dos agentes customizados est\u00e1 no campo allowedTools<\/code>: ferramentas pr\u00e9-aprovadas n\u00e3o pedem confirma\u00e7\u00e3o a cada uso, eliminando interrup\u00e7\u00f5es durante o fluxo de trabalho. Para ferramentas sens\u00edveis (como escrita de arquivos ou execu\u00e7\u00e3o de shell), mantenha fora do allowedTools<\/code> para que o CLI pe\u00e7a aprova\u00e7\u00e3o.<\/p>\n\n\n\n
Subagentes: delegando tarefas em paralelo<\/strong><\/h2>\n\n\n\n
Desde a vers\u00e3o 1.26 (fevereiro de 2026), o Kiro CLI suporta subagentes<\/a>: agentes especializados que rodam em paralelo, cada um com seu contexto e permiss\u00f5es. O agente principal delega tarefas para subagentes, que executam e devolvem resultados.<\/p>\n\n\n\n
Na pr\u00e1tica, isso permite fluxos como: o agente principal recebe uma tarefa complexa, delega a pesquisa para um subagente de documenta\u00e7\u00e3o, a implementa\u00e7\u00e3o para um subagente de c\u00f3digo e a valida\u00e7\u00e3o para um subagente de testes \u2014 todos executando em paralelo.<\/p>\n\n\n\n
Voc\u00ea controla quais agentes podem ser usados como subagentes (availableAgents<\/code>) e quais podem rodar sem confirma\u00e7\u00e3o (trustedAgents<\/code>) na configura\u00e7\u00e3o do agente principal.<\/p>\n\n\n\n
Agent Client Protocol: Kiro CLI em JetBrains e Zed<\/strong><\/h2>\n\n\n\n
Desde a vers\u00e3o 1.25 (fevereiro de 2026), o CLI suporta o Agent Client Protocol (ACP), um padr\u00e3o aberto que permite usar o agente do Kiro dentro de editores compat\u00edveis como JetBrains IDEs e Zed. O comando:<\/p>\n\n\n\n
kiro-cli acp<\/code><\/pre>\n\n\n\n
Inicia 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 \u00e0s capacidades ag\u00eanticas do Kiro sem trocar de editor.<\/p>\n\n\n\n
Kiro CLI em pipelines de CI\/CD<\/strong><\/h2>\n\n\n\n
Uma das aplica\u00e7\u00f5es mais poderosas do CLI \u00e9 a integra\u00e7\u00e3o em pipelines de CI\/CD. O agente pode ser chamado como etapa de um workflow para tarefas automatizadas como an\u00e1lise de seguran\u00e7a, gera\u00e7\u00e3o de testes e verifica\u00e7\u00e3o de conformidade.<\/p>\n\n\n\n
O CLI suporta configura\u00e7\u00e3o de permiss\u00f5es granulares para ambientes automatizados: quais comandos shell podem ser executados, quais paths podem ser escritos e quais servi\u00e7os AWS podem ser acessados. Isso garante que o agente opera dentro de limites seguros em ambientes de produ\u00e7\u00e3o.<\/p>\n\n\n\n
Para times que querem o Kiro em pipelines mas precisam de governan\u00e7a, o MCP Registry<\/a> permite controlar centralmente quais ferramentas o CLI pode acessar.<\/p>\n\n\n\n
<\/div>\n\n\n\n\n\n