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.

Links

• npm Package
• GitHub Repository
• Kiro IDE