Custom agents provide a way to customize Kiro behavior by defining specific configurations for different use cases. Each custom agent is defined by a JSON configuration file that specifies which tools the agent can access, what permissions it has, and what context it should include.
Important: Custom agent management primarily involves creating and editing configuration files. While some commands are available during chat sessions (like /agent list and /agent create), switching between custom agents requires starting a new chat session with kiro-cli --agent [name].
How custom agents differ from the default experience
By default, Kiro CLI provides access to all available tools but requires user confirmation for most operations. This approach prioritizes security but can interrupt your workflow with frequent permission prompts.
Custom agents solve this by allowing you to:
Custom agents work with both built-in tools and external tools provided through the Model Context Protocol (MCP). This gives you flexibility to:
Custom agents