How to Install Kiro CLI: AWS's Spec-Driven AI Coding Agent

What Is Kiro CLI?

Kiro CLI is AWS’s terminal AI coding agent powered by Claude Sonnet 4. Its key differentiator: it’s spec-driven. Instead of jumping straight into code, Kiro generates requirements and design documents first, then implements based on those specs.

Think of it as having a senior engineer who writes the spec before touching the keyboard.

After two weeks of use, the biggest win is fewer rewrites. The spec stage catches bad assumptions before any code is written.

How to Install Kiro CLI

One-line install (macOS / Linux)

curl -fsSL https://cli.kiro.dev/install | bash

Debian/Ubuntu (.deb)

wget https://desktop-release.q.us-east-1.amazonaws.com/latest/kiro-cli.deb
sudo dpkg -i kiro-cli.deb

AWS CloudShell (no install needed)

Open CloudShell from the AWS Console and run kiro-cli directly.

Verify

kiro-cli --version

How to Authenticate

kiro-cli

Opens your browser for sign-in. On SSH/remote sessions, it uses device code flow — you’ll see a URL and code to enter on any browser.

What Makes Kiro’s Spec-Driven Approach Different?

When you ask Kiro to build a feature, it follows this workflow:

1. Requirements — generates a requirements document
2. Design — creates a design spec with architecture decisions
3. Tasks — breaks work into implementation tasks
4. Code — writes the implementation

This means you get an auditable trail of decisions. You can review and adjust at each stage before code is written.

How Does Kiro Compare to Other CLI Agents?

	Kiro CLI	Claude Code	Codex CLI	Antigravity CLI
Provider	AWS	Anthropic	OpenAI	Google
Default model	Claude Sonnet 4	Claude Sonnet 4	GPT-4o	Gemini 3.5 Flash
Spec-driven	✅	❌	❌	❌
Specialized agents	✅	❌	❌	✅
Free tier	✅	❌	❌	✅
CloudShell support	✅	❌	❌	❌
Skills/plugins	✅	Hooks	Plugins	Skills
Open source	❌	❌	✅	❌

Choose Kiro when: You want requirements generated before code, you’re in the AWS ecosystem, or you need specialized agents for different tasks (backend, DevOps, review).

Tips

• Use specialized agents. Place agent definitions in .kiro/skills/ for domain-specific workflows.
• Review specs before implementation. The spec-driven approach only helps if you actually read the generated requirements.
• CloudShell for quick tasks. No local install needed — great for infrastructure work.
• Device code auth for SSH. Look for the URL in terminal output when browser can’t open.

Troubleshooting

glibc error on older Linux

Your system has glibc < 2.34. Use the musl build or upgrade to Ubuntu 22.04+/Fedora 36+.

Auth fails in SSH session

Use device code flow: copy the URL from terminal output, open it on any browser, enter the code.

Command not found after install

export PATH="$HOME/.local/bin:$PATH"

Add to ~/.bashrc or ~/.zshrc to persist.

---

Related Articles

• Claude Code Installation Guide
• 5 Best Free AI Coding CLI Tools in 2026
• AI Coding CLI Cost Comparison

Links

• Kiro CLI Docs
• Kiro Official Site
• Kiro CLI Commands Reference