Guide agent

The Guide agent gives you instant, accurate answers about Kiro CLI — grounded in official documentation rather than general model knowledge. Ask about commands, tools, settings, or workflows, and it searches indexed docs to respond with information that matches your installed version.

Use the Guide agent when you need authoritative answers about Kiro CLI itself — how a command works, what settings are available, or how to configure a feature. Your main agent draws on general knowledge; the Guide agent draws exclusively on indexed CLI documentation, so its answers are current and version-specific.

Switch to the Guide agent:

> /guide

You'll see the agent switch indicator in your prompt, confirming you're now chatting with the Guide agent. Ask any question about Kiro CLI:

[guide] > How do I configure MCP servers?

The Guide agent has access to comprehensive, indexed documentation covering:

• Slash commands: /chat, /context, /agent, /model, /spawn, and all other in-session commands
• Built-in tools: read, write, shell, grep, glob, code, web_search, and their configuration options
• Settings: Every setting available via kiro-cli settings, including descriptions and valid values
• Features: MCP integration, hooks, steering, custom agents, subagents, code intelligence, knowledge management
• CLI commands: kiro-cli chat, kiro-cli settings, kiro-cli doctor, and other terminal commands
• Create Kiro project files: Generate agents, prompts, and steering files in .kiro/ based on documentation patterns

The Guide agent uses the introspect tool under the hood. When you ask a question, it:

1. Searches an indexed documentation corpus using hybrid search (semantic + BM25)
2. Retrieves the most relevant documentation sections
3. Synthesizes an answer grounded in official docs

Because answers come from documentation embedded at compile time rather than general model knowledge, they reflect the actual behavior of your installed Kiro CLI version.

[guide] > What does the code tool do?

The code tool provides code intelligence capabilities:

• search_symbols — Find symbol definitions by name
• lookup_symbols — Get details for specific symbols
• get_document_symbols — List all symbols in a file
• pattern_search — AST-based structural search

It uses AST parsing for accurate code understanding across languages.

[guide] > How do I change the default model?

Set your default model with:

kiro-cli settings chat.defaultModel claude-opus-4.7

Or use /model during a session to switch models interactively.
To save your current session model as the default:

/model set-current-as-default

[guide] > How do subagents work?

Subagents are specialized agents that run in parallel with isolated context.
The main agent spawns up to 4 subagents simultaneously for parallel task
execution. Each operates with its own context to prevent bloat in the main
conversation.

Monitor them with Ctrl+G to open the crew monitor. Configure which agents
can be spawned using the subagent tool's availableAgents setting.

[guide] > Create an agent for writing tests

✔ Created .kiro/agents/test-writer.yaml

I've created a test-writing agent. Switch to it with:
/agent swap test-writer

The Guide agent can create agents in .kiro/agents/, prompts in .kiro/prompts/, and steering files in .kiro/steering/.

In the terminal UI, /help opens a searchable command panel (an overlay listing all available commands). The /guide command switches you to an interactive agent that can have a conversation about Kiro CLI features, answer follow-up questions, and create project files for you.

• Slash commands - All available slash commands
• Custom agents - Create your own agents
• Settings reference - All configuration options
• Terminal UI - The default chat interface where /guide is available