Answer: In CLI 2.x, custom agent configs are JSON-only with embedded toolsSettings and hooks, stored as .kiro/agents/my-agent.json with fields like name, description, prompt, model, tools, toolsSettings, resources, hooks, and welcomeMessage. Built-in names that CLI 2.x custom agent configs can use include kiro_default or kiro_planner. Status: Confirmed Entry: tool/kiro/agents-and-automation/cli-custom-agent-config Revision: 1 Digest: sha256:86ae1b8c39d09ab0 (changes whenever the content changes) Timeline: Created: 2026-11-13T03:36:03Z Last changed: 2026-11-13T03:36:03Z Last verified: 2026-11-20T13:19:12Z Next check: 2026-11-21T13:19:12Z Check interval: Daily Expected change: No fixed schedule Data: Field | Value | Source | As of config format | JSON-only with embedded toolsSettings and hooks | [1] | 2026-11-20 config file path | .kiro/agents/my-agent.json | [1] | 2026-11-20 built-in name example 1 | kiro_default | [1] | 2026-11-20 built-in name example 2 | kiro_planner | [1] | 2026-11-20 page updated | November 3, 2026 | [1] | 2026-11-20 Sources: [1] Amazon Web Services. "2.x reference - CLI - Docs - Kiro". https://kiro.dev/docs/cli/2x-reference/ Role: primary. Accessed: 2026-11-20T13:19:12Z Quote: "In CLI 2.x, agent configs were JSON-only with embedded toolsSettings and hooks ." (Supports: config format) Quote: "Format .kiro/agents/my-agent.json :" (Supports: config file path) Quote: "CLI 2.x custom agent configs can use built-in names such as kiro_default or kiro_planner ." (Supports: built-in name example 1, built-in name example 2) Quote: "Page updated: November 3, 2026" (Supports: page updated) Published: 2026-11-20T07:39:25Z Snapshot SHA-256: ab3c2fd4f3930e9d5bc77abf8828704b7d82aeed870a07c64709dc423f6a9548 (captured 2026-11-20T13:19:09Z) Verification: Method: Automated extraction from [1] with deepseek-flash (JSON output, thinking disabled). Every value was checked by code to appear verbatim in a quoted passage of [1]. Cross-check: not-available at 2026-11-20T13:19:12Z. No independent second source is configured for this entry Last successful check: 2026-11-20T13:19:12Z Last attempt: 2026-11-20T13:19:12Z Notes and limitations: Extracted automatically from a single official source (section "Custom agent config"). Related: https://latestn.com/tool/kiro/agents-and-automation/cli-hook-triggers What triggers can I use in a Kiro CLI 2.x hook? https://latestn.com/tool/kiro/agents-and-automation/configure-subagent-tool-access How do I configure which tools a Kiro sub-agent can access? https://latestn.com/tool/kiro/agents-and-automation/create-agent-from-template How do I create an agent from a template in Kiro Crew? https://latestn.com/tool/kiro/agents-and-automation/change-bot-model-reasoning-effort How do I change a Kiro Crew bot's model and reasoning effort? https://latestn.com/tool/kiro/agents-and-automation/chat-with-agent How do I chat with the agent in Kiro Web? https://latestn.com/tool/kiro/agents-and-automation/choose-agent-backend How do I choose an agent backend in Kiro Crew? https://latestn.com/tool/ All entries in AI tools Change log: Time | Event | Change | Source 2026-11-13T03:36:03Z | added | Entry created | — Changes for this entry as a feed: https://latestn.com/tool/kiro/agents-and-automation/cli-custom-agent-config/latest Challenge this entry: Open challenges: None How: If a value here is wrong or out of date, send what is wrong and a link to evidence. Challenges are queued and checked against the evidence; they do not change the entry by themselves. If the entry changes as a result, the change log says so. Form: https://latestn.com/dispute/tool/kiro/agents-and-automation/cli-custom-agent-config POST: https://latestn.com/dispute/tool/kiro/agents-and-automation/cli-custom-agent-config with claim, evidence_url, and optionally field and contact (form-encoded or JSON) GET: https://latestn.com/dispute/tool/kiro/agents-and-automation/cli-custom-agent-config?claim={what is wrong}&evidence_url={link} How to cite: LatestN. (2026). How do I write a custom agent config in Kiro CLI 2.x and what built-in agent names exist? Revision 1, last verified 2026-11-20T13:19:12Z. https://latestn.com/tool/kiro/agents-and-automation/cli-custom-agent-config (accessed 2026-11-21T10:04:15Z). @misc{LatestN_tool_kiro_agents_and_automation_cli_custom_agent_config_r1, title = {How do I write a custom agent config in Kiro CLI 2.x and what built-in agent names exist?}, author = {{LatestN}}, year = {2026}, howpublished = {\url{https://latestn.com/tool/kiro/agents-and-automation/cli-custom-agent-config}}, note = {Revision 1; digest sha256:86ae1b8c39d09ab0; last verified 2026-11-20T13:19:12Z; accessed 2026-11-21T10:04:15Z} } Reuse: License: CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/) Attribution: Copying and adapting are allowed, including commercially, if you credit LatestN and link to the entry you used. Each entry ends with a ready-made citation. URL: https://latestn.com/tool/kiro/agents-and-automation/cli-custom-agent-config