pi-provider-kiro

A pi provider extension that connects pi to the Kiro API (AWS CodeWhisperer/Q), exposing 19 free models across 8 families through one provider surface.

Why this exists

Kiro gives you a strong free model menu, but pi needs a provider that speaks Kiro's auth, model catalog, and streaming protocol cleanly. pi-provider-kiro handles that bridge, including:

• AWS Builder ID, IAM Identity Center, Google, and GitHub login flows
• shared credentials from an existing kiro-cli session when available
• reasoning-aware streaming
• region-aware model filtering so pi only shows models your Kiro region can actually use

Quick start

Install the provider:

pi install npm:pi-provider-kiro

Or install it globally with npm:

npm install -g pi-provider-kiro

Then log in from pi:

/login kiro

The login flow supports:

• AWS Builder ID — native device-code flow, works well over SSH/remotes
• Your organization — IAM Identity Center start URL
• Google — social login via kiro-cli
• GitHub — social login via kiro-cli

If you already use kiro-cli, the provider can reuse those credentials instead of forcing a second login.

Models

Family	Models	Context	Reasoning
Claude Opus 4.6	claude-opus-4-6, claude-opus-4-6-1m	200K / 1M	✓
Claude Sonnet 4.6	claude-sonnet-4-6, claude-sonnet-4-6-1m	200K / 1M	✓
Claude Opus 4.5	claude-opus-4-5	200K	✓
Claude Sonnet 4.5	claude-sonnet-4-5, claude-sonnet-4-5-1m	200K / 1M	✓
Claude Sonnet 4	claude-sonnet-4	200K	✓
Claude Haiku 4.5	claude-haiku-4-5	200K	✗
DeepSeek 3.2	deepseek-3-2	128K	✓
Kimi K2.5	kimi-k2-5	200K	✓
MiniMax	minimax-m2-1, minimax-m2-5	200K	✗
GLM 4.7	glm-4-7, glm-4-7-flash	128K	✓ / ✗
Qwen3 Coder	qwen3-coder-next, qwen3-coder-480b	256K / 128K	✓
AGI Nova	agi-nova-beta-1m	1M	✓
Auto	auto	200K	✓

All listed models are free to use through Kiro.

Usage

Once logged in, select any Kiro model in pi:

/model claude-sonnet-4-6

Or let Kiro pick automatically:

/model auto

Reasoning is automatically enabled for supported models. Use /reasoning to adjust the thinking budget.

Retry Behavior

Generic transient retries such as HTTP 429 and 5xx are handled by pi-coding-agent at the session layer.

This provider only keeps local recovery for Kiro-specific cases:

• 403 auth races, where it can refresh credentials from kiro-cli
• first-token / stalled-stream recovery
• empty-stream retries
• non-retryable Kiro body markers like MONTHLY_REQUEST_COUNT and INSUFFICIENT_MODEL_CAPACITY

Development

npm run build       # Compile TypeScript
npm run check       # Type check (no emit)
npm test            # Run the Vitest suite
npm run test:watch  # Watch mode

Architecture

The extension is organized as one feature per file:

src/
├── index.ts            # Extension registration
├── models.ts           # 19 model definitions + ID resolution
├── oauth.ts            # Multi-provider auth (Builder ID / Google / GitHub)
├── kiro-cli.ts         # kiro-cli credential sharing
├── transform.ts        # Message format conversion
├── history.ts          # Conversation history management
├── thinking-parser.ts  # Streaming <thinking> tag parser
├── event-parser.ts     # Kiro stream event parser
└── stream.ts           # Main streaming orchestrator

See AGENTS.md for detailed development guidance and .agents/summary/ for full architecture documentation.

License

MIT