{"slug": "show-hn-kodama-a-multi-agent-pack-for-kiro", "title": "Show HN: Kodama – a multi-agent pack for Kiro", "summary": "Developer amergrgic released Kodama, an independent community multi-agent pack for the Kiro IDE and Kiro CLI, installing 9 agents and 3 skills via a clone-and-install script or a curl one-liner. The pack's primary entrypoint agent, kodama, plans work and delegates to eight prefixed specialists — kodama-scout, kodama-scholar, kodama-sage, kodama-artist, kodama-smith, kodama-critic, kodama-forge and kodama-scribe — with write and shell access approval-gated for implementation agents. The installer requires kiro-cli and python3, validates every generated agent configuration before writing, and refuses to overwrite existing kodama or kodama-* agent files; a Kiro Crew App Store listing is pending review.", "body_md": "**Note:** kodama is an independent community project. It is not officially affiliated with, endorsed by, or officially connected to Amazon Web Services (AWS), the Kiro IDE, or the Kiro CLI team. \"Kiro\" is a trademark of Amazon.com, Inc. or its affiliates.\n\n**New:** Kodama is a [Kiro Crew App](https://kiro.dev/crew/). App Store listing pending review — install by cloning the repo locally.\n\n| Agent | Role | Default access | \n|---|---|---|\n| **kodama** | Plans work, delegates specialists, reconciles results, and verifies completion | Delegation plus approval-gated implementation tools | \n| **kodama-scout** | Read-only codebase reconnaissance | Read/search; readonly shell commands only | \n| **kodama-scholar** | External API, library, and documentation research | Web research only | \n| **kodama-sage** | Architecture, hard debugging, and consequential tradeoffs | Read-only analysis and research | \n| **kodama-artist** | UI, UX, accessibility, and interaction implementation | Write/shell require approval | \n| **kodama-smith** | Bounded implementation, tests, and straightforward refactors | Write/shell require approval | \n| **kodama-critic** | Independent diff review before non-trivial work is complete | Read-only; Git inspection shell commands only | \n| **kodama-forge** | Infrastructure, CI/CD, containerization, and deployment | Write/shell require approval | \n| **kodama-scribe** | Documentation, changelogs, ADRs, and technical writing | Write/shell require approval | \n\nThe `kodama-` prefix keeps companion agents distinct from generic names that may already be installed by another pack. Only the primary entrypoint is unprefixed:\n\n```\nkodama\n```\n\nOr equivalently, without the shell alias:\n\n```\nkiro-cli chat --agent kodama\n```\n\nIf you use [Kiro Crew](https://kiro.dev/crew/), install by cloning the repo:\n\n```\ngit clone https://github.com/amergrgic/kodama.git\nkirocrew app install ./kodama\nkirocrew app enable kodama\n```\n\nThis installs all 9 agents and 3 skills. No setup script needed.\n\nApp Store listing is pending review. Once approved, install with: `kirocrew app install kodama`\n\nOne-liner (no clone needed):\n\n```\ncurl -fsSL https://dl.getkodama.dev | bash\n```\n\nOr directly from GitHub:\n\n```\ncurl -fsSL https://raw.githubusercontent.com/amergrgic/kodama/main/install-remote.sh | bash\n```\n\nOr clone and run locally:\n\n```\ngit clone https://github.com/amergrgic/kodama.git\ncd kodama && ./setup.sh\n```\n\nThe installer requires `kiro-cli` and `python3`. It validates every generated agent configuration before writing it, adds a `kodama` shell alias by default, and installs only these files:\n\n```\n~/.kiro/agents/kodama.json\n~/.kiro/agents/kodama-*.json\n~/.kiro/skills/kodama-*/SKILL.md\n~/.kiro/kodama/manifest.json\n~/.kiro/kodama/setup.sh\n~/.kiro/kodama/kodama.sh\n~/.kiro/kodama/kodama-memory.py\n~/.kiro/kodama/kodama-doctor.sh\n~/.kiro/kodama/check-update.sh\n~/.kiro/kodama/update.sh\n~/.kiro/kodama/backups/<timestamp>/  # on update\n```\n\nIt does **not** modify:\n\n- other agent packs or their configuration\n- global MCP settings\n- your Kiro default agent, unless requested explicitly\n\nUse the optional lifecycle commands:\n\n```\n./setup.sh --dry-run       # preview without writes\n./setup.sh --set-default   # set chat.defaultAgent to kodama\n./setup.sh --no-alias      # skip adding shell alias (added by default on fresh install)\n./setup.sh --uninstall     # remove only unmodified files owned by this pack\n```\n\nA first install refuses to overwrite an existing `kodama` or `kodama-*` agent file. Uninstall preserves an agent config that was changed after installation, so customizations are not silently deleted.\n\nA copy of `setup.sh` is installed to `~/.kiro/kodama/` so lifecycle commands work without keeping the clone:\n\n```\n~/.kiro/kodama/setup.sh --uninstall\n```\n\nThe installer adds a `kodama` alias to your shell by default. Use it as a unified entrypoint:\n\n```\nkodama                    # start a chat session\nkodama memory             # view project memory\nkodama doctor             # check installation health\nkodama update             # self-update\nkodama uninstall          # remove kodama\nkodama version            # print version\nkodama help               # show subcommands\n```\n\nTo skip the alias on install, use `--no-alias`. If you installed before v0.6.0, run `~/.kiro/kodama/setup.sh --alias` to migrate your existing alias.\n\nKodama checks for updates when a session starts. To update manually:\n\n```\nkodama update\n```\n\nThis downloads the latest release, backs up your current installation, and re-runs setup. Check your installed version with:\n\n```\nkodama version\n```\n\nKodama remembers what it learns about your project across sessions. Facts about your stack, decisions made, failed approaches, and team conventions accumulate in `.kiro/kodama/memory/` and are loaded automatically at session start.\n\nMemory is written by agents during sessions — no manual setup needed. After a few sessions, Kodama knows your test runner, build tool, architecture boundaries, and past mistakes without re-discovering them.\n\nView what's stored:\n\n```\nkodama memory\n```\n\nReset if needed:\n\n```\nkodama memory reset\n```\n\nCheck for accidentally stored secrets:\n\n```\nkodama memory audit\n```\n\nMemory files can be committed to your repo (shared team knowledge) or added to `.gitignore` (personal). Only concise natural-language descriptions are stored — never code, file contents, or credentials.\n\nEach file under `agents/` is a self-contained Kiro JSON configuration with an inline prompt. This keeps installation portable: no prompt-file path rendering, package manager, cloud credential, or provider-specific model is required.\n\nAll agents default to `model: \"auto\"`. Change an installed agent's `model` field to any model ID supported by your Kiro setup. Recommended profiles for users who want to tune:\n\n**Tip:** Instead of editing installed agent configs (which get overwritten on update), create a project-level override in `.kiro/agents/` — see the [project-local customization guide](https://github.com/amergrgic/kodama/blob/main/docs/project-customization.md).\n\n| Agent | Profile | Why | \n|---|---|---|\n| kodama | Strong reasoning (Opus, GPT-5.6 Sol) | Multi-step planning and reconciliation | \n| kodama-sage | Strong reasoning (Opus, GPT-5.6 Sol) | Architecture and deep tradeoff analysis | \n| kodama-critic | Fast + precise (Sonnet, GPT-5.6 Terra) | Pattern-matching over diffs | \n| kodama-scout | Fast (Haiku, GPT-5.6 Luna) | Bulk reads and symbol lookups | \n| kodama-scholar | Fast (Sonnet, GPT-5.6 Luna) | Research synthesis | \n| kodama-smith | Balanced (Sonnet, GPT-5.6 Terra) | Implementation | \n| kodama-artist | Balanced (Sonnet, GPT-5.6 Terra) | UI implementation | \n| kodama-forge | Balanced (Sonnet, GPT-5.6 Terra) | Infrastructure and pipeline work | \n| kodama-scribe | Fast (Sonnet, GPT-5.6 Luna) | Documentation generation | \n\nThe pack intentionally ships no global MCP preset. Add MCP servers through Kiro's normal configuration or customize individual agent configs after installation. Keep credentials and environment-specific integrations outside this repository.\n\nThe installer adds three namespaced, on-demand playbooks under `~/.kiro/skills/`. Agent configurations reference their installed paths explicitly, so the skills remain available even when Kiro's default skill inheritance is disabled.\n\n| Skill | Purpose | Used by | \n|---|---|---|\n| **kodama-behavior** | Task classification, codebase assessment, delegation, parallel work, and failure recovery | kodama, kodama-scout, kodama-scholar, kodama-sage | \n| **kodama-verification** | Success criteria, targeted validation, and evidence-based completion reports | kodama, kodama-sage, kodama-artist, kodama-smith, kodama-critic, kodama-forge, kodama-scribe | \n| **kodama-constraints** | Scope, security, destructive-action confirmation, and completion guardrails | all agents | \n\nSkills are the only workflow Markdown shipped by the pack. Agent prompts remain self-contained inside their JSON configurations.\n\nKeep repository-specific rules and workflows in the repository instead of editing installed pack files. See the [project-local customization guide](https://github.com/amergrgic/kodama/blob/main/docs/project-customization.md) and copy [`examples/project-customization/`](https://github.com/amergrgic/kodama/blob/main/examples/project-customization) as a starting point.\n\nRun the full portable validation suite before sharing a change or wiring up CI:\n\n```\n./scripts/validate.sh\n```\n\nIt requires only `bash` and `python3`; the installer lifecycle suite uses an isolated temporary home and a stub Kiro CLI. To run individual checks while developing:\n\n```\nbash tests/test_install.sh\nbash tests/test_project_customization.sh\nbash -n setup.sh\npython3 -m json.tool agents/kodama.json\n```\n\nThe test suite uses a temporary home and stub Kiro CLI. It verifies dry-run behavior, coexistence with a foreign agent, ownership-aware updates and uninstall, explicit default-agent changes, and collision protection.\n\n- **Portable:** no provider-specific or cloud-vendor dependencies.\n- **Safe by default:** implementation tools are available but not auto-approved.\n- **Small roster:** Kodama delegates to purpose-built companions instead of accumulating broad privileges.\n- **Evidence-based:** non-trivial work is reviewed and validated before it is declared complete.\n\nKodama is inspired by the \"oh-my\" family of agent packs — [oh-my-claudecode](https://github.com/yeachan-heo/oh-my-claudecode), [oh-my-opencode-slim](https://github.com/alvinunreal/oh-my-opencode-slim), and similar projects that bring structured multi-agent workflows to CLI coding tools. Kodama adapts this pattern for the Kiro CLI ecosystem with a focus on portability and provider neutrality.", "url": "https://wpnews.pro/news/show-hn-kodama-a-multi-agent-pack-for-kiro", "canonical_source": "https://github.com/amergrgic/kodama", "published_at": "2026-10-02 10:08:09+00:00", "updated_at": "2026-10-02 10:37:11.948320+00:00", "lang": "en", "topics": ["ai-agents", "ai-tools", "developer-tools", "ai-products"], "entities": ["Kodama", "Kiro", "Kiro CLI", "Kiro Crew", "amergrgic", "Amazon Web Services", "GitHub"], "also_reported_by": [], "alternates": {"html": "https://wpnews.pro/news/show-hn-kodama-a-multi-agent-pack-for-kiro", "markdown": "https://wpnews.pro/news/show-hn-kodama-a-multi-agent-pack-for-kiro.md", "text": "https://wpnews.pro/news/show-hn-kodama-a-multi-agent-pack-for-kiro.txt", "jsonld": "https://wpnews.pro/news/show-hn-kodama-a-multi-agent-pack-for-kiro.jsonld"}}