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