A portable, provider-neutral agent pack for the Kiro CLI.
One orchestrator. Eight specialists. Zero lock-in.
A single AI agent juggling planning, coding, reviewing, and deploying loses context, makes sloppy mistakes, and has way too many permissions. You end up babysitting it.
Kodama fixes this by splitting the work across specialists — the scout can only read, the smith can only write with approval, the critic only reviews. Each agent does one job well, with the minimum permissions needed.
You describe what you want. Kodama figures out who does what.
No provider lock-in. Works with any model supported by Kiro CLI.
Implementation tools require approval. Read-only agents stay read-only.
Persistent memory across sessions. No repeated discovery.
Work is reviewed and validated before completion.
Kodama delegates to purpose-built specialists. Each has clear boundaries and minimal permissions.
Orchestrator
Plans, delegates, reconciles, verifies
Reconnaissance
Read-only codebase exploration
Research
External docs, APIs, libraries
Reasoning
Architecture, debugging, tradeoffs
UI/UX
Components, styling, accessibility
Implementation
Code, tests, refactors
Review
Independent diff review
Infrastructure
CI/CD, Docker, IaC, deploy
Documentation
READMEs, ADRs, changelogs
One command. Requires kiro-cli and python3.
One-liner install
curl -fsSL https://dl.getkodama.dev | bashOr directly from GitHub
curl -fsSL https://raw.githubusercontent.com/amergrgic/kodama/main/install-remote.sh | bashOr clone and run locally
git clone https://github.com/amergrgic/kodama.git
cd kodama && ./setup.shThen start a session:
kodamaThe alias is added by default. Use --no-alias to skip it.
The kodama command is a unified entrypoint.
Kodama remembers what it learns. Build tools, architecture decisions, failed approaches, and team conventions persist across sessions automatically.
Session 1
Scout discovers: vitest, pnpm, React 18, tRPC. Facts are saved automatically.
Session 2+
Kodama already knows your stack. No re-discovery, no wasted context. Faster and more accurate.
Same prompt. Different approach.
Default Kiro agent
Kodama