kiro-agents
Theadd · Theadd/kiro-agents
Installs an agent system into Kiro IDE for creating custom agents, switching between vibe and spec modes, and keeping persistent memory across sessions.
Advanced AI agent system for Kiro IDE - Create specialized agents, switch interaction modes (vibe/spec), and enhance development workflows with minimal cognitive overhead
Preview
What you can do with it
- Create a custom agent for a role using templates or plain language
- Switch between conversational and structured spec workflows
- Let agents learn from past sessions with persistent memory
Safety check
Usable, but read the notes first.
- ●No clear license: check with the author before using it in a commercial product.
Automated scan of the repo files. Always review code you run.
From the README
kiro-agents
AI agent system for Kiro IDE. Create custom AI agents tailored to your exact needs—easily and interactively, with minimal prompt writing.
Build agents for any domain: development, design, business, research, or anything else. Choose from templates, explore role libraries, describe what you need in plain language, or craft agents step-by-step. Once created, refine them to perfection through kiro-master, the management agent created automatically on first use.
Features
Core Capabilities:
- 🎯 Guided Agent Creation - Multiple creation methods: templates, role explorer, natural language, or step-by-step wizard
- 🔧 Powerful Refinement - Modify and perfect agents through kiro-master, the auto-created management agent
- 💬 Interactive by Default - Guided workflows with minimal prompt writing for both creating and using agents
- 🌐 Unlimited Domains - Build agents for any field: development, design, business, research, or anything else
- 📦 Minimal Footprint - 1.35K base context (<0.7% of Kiro's 200K), protocols load on-demand
Additional Features:
- 🔄 Flexible Modes - Switch between vibe (conversational) and spec (structured) workflows
- 🎯 Strict Mode - Precision mode that blocks execution on ambiguous input
- 🧠 Reflection System - Agents learn from experience with persistent memory across sessions
Installation
npx kiro-agents
Installs kiro-agents and the kiro-protocols Power. Run the same command to update to the latest version.
Quick Start
1. Start Agent System
/agents
On first run, this automatically creates kiro-master (your Kiro management agent) and shows you the agent menu.
2. Create Your First Custom Agent
From the agent menu, choose "Create new agent" and pick a creation method:
- Quick Start - Choose from templates
- Explore Roles - Browse agents by domain
- Natural Language - Just describe what you need
- Project-Specific - AI analyzes your codebase
- Guided Wizard - Step-by-step customization
3. Activate Any Agent
/agents {name}
Example:
/agents kiro-master- Activate the Kiro management agent
The agent stays active until you switch to another or end the session.
Demo
Watch demo (3:52) — Custom agent optimizing steering document instructions
How It Works
Simple Markdown Files kiro-agents uses plain markdown files with AI instructions—no code to run, no dependencies to install. These files guide how Kiro IDE responds to your commands.
kiro-protocols Power Automatically installed alongside kiro-agents, this Power provides protocols (agent creation, mode switching, strict mode) that load on-demand when needed.
On-Demand Loading Protocols load only when needed, keeping your context clean. Base system uses just 1.35K tokens.
Your Agents, Your Files
Agents you create are saved as .md files in .kiro/kiro-agents/. Edit them like any document, version control them with git, reuse them across projects.
Documentation
- Getting Started - Step-by-step onboarding guide
- Architecture Overview - System design and component relationships
- Creating Powerful Agents - Layered architecture guide
- Reflection System - Persistent memory for agents
- Design Rationale - Protocol system, interaction patterns, neurodivergent accessibility
- Contributing - Development workflow, build system, testing, versioning
Contributing
Contributions welcome! See CONTRIBUTING.md for guidelines.