Guide for using Kiro CLI custom agents, when to use each agent, how to create new agents, and MCP server configuration. Use when switching agents, adding new agents, configuring MCP servers, or understanding agent architecture.
Peer agent model:
/agent swapWhy peer agents?
Use for:
Switch to default:
/agent swap default
Use for:
Switch to github:
/agent swap github
Use for:
Switch to jira:
/agent swap jira
See references/agent-configuration.md for detailed configuration fields and examples.
Quick steps:
~/.dotfiles/etc/kiro-cli/cli-agents/./install/kiro-cli.sh to linkkiro-cli chat --agent myagentSee references/mcp-servers.md for installation and configuration details.
Quick reference:
~/.kiro/settings/mcp.jsonmcpServers fieldincludeMcpJson: true to include bothSee references/security.md for detailed security patterns.
Key principles:
Commands:
/agent swap default # General development
/agent swap github # GitHub operations
/agent swap jira # JIRA operations
/agent status # Check current agent
/agent list # List available agents
Agent not found:
ls ~/.kiro/agents/
./install/kiro-cli.sh
MCP server not working:
/tools # Check server status in chat
Tool permission denied:
allowedTools in agent JSONtoolsSettings for path/command restrictionsConfiguration locations:
~/.kiro/agents/ # Agent definitions
~/.kiro/settings/mcp.json # Global MCP servers
~/.kiro/logs/ # Audit logs
~/.dotfiles/etc/kiro-cli/ # Source configs
Common tasks:
# Create new agent
vim ~/.dotfiles/etc/kiro-cli/cli-agents/myagent.json
./install/kiro-cli.sh
# View audit logs
tail -f ~/.kiro/logs/aws-audit.jsonl | jq
references/agent-configuration.md - Detailed configuration fields and examplesreferences/mcp-servers.md - MCP server installation and setupreferences/security.md - Security patterns and restrictions