Answer: Your custom agent may not be found because the file is in the wrong location, lacks a .json extension, has incorrect permissions, or the filename doesn't match the agent name; a wrong version may load due to name conflicts between local and global directories, since local custom agents take precedence over global ones. Status: Confirmed Entry: tool/kiro/troubleshooting/agent-not-found-wrong-version Revision: 2 Digest: sha256:b19daffb0cdfe3a0 (changes whenever the content changes) Timeline: Created: 2026-11-13T03:39:55Z Last changed: 2026-11-20T13:25:03Z (List command: — → /agent list) Last verified: 2026-11-20T13:25:03Z Next check: 2026-11-21T13:25:03Z Check interval: Daily Expected change: No fixed schedule Data: Field | Value | Source | As of Global agent path | ~/.kiro/agents/[name].json | [1] | 2026-11-20 Workspace agent path | .kiro/agents/[name].json | [1] | 2026-11-20 Required extension | .json | [1] | 2026-11-20 Precedence rule | local custom agents take precedence over global custom agents | [1] | 2026-11-20 List command | /agent list | [1] | 2026-11-20 Sources: [1] Amazon Web Services. "Troubleshooting - Custom agents - Features - Docs - Kiro". https://kiro.dev/docs/custom-agents/troubleshooting/ Role: primary. Accessed: 2026-11-20T13:25:03Z Quote: "Global: ~/.kiro/agents/[name].json" (Supports: Global agent path) Quote: "Workspace: .kiro/agents/[name].json" (Supports: Workspace agent path) Quote: "Ensure the file has a .json extension" (Supports: Required extension) Quote: "Remember that local custom agents take precedence over global custom agents" (Supports: Precedence rule) Quote: "Use /agent list to see which version is being loaded" (Supports: List command) Published: 2026-11-20T07:39:25Z Snapshot SHA-256: 0a96825622ee1af1cfe19ea51440f391320678a8f2aa26be1a6419b712c07955 (captured 2026-11-20T13:25:03Z) 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:25:03Z. No independent second source is configured for this entry Last successful check: 2026-11-20T13:25:03Z Last attempt: 2026-11-20T13:25:03Z Notes and limitations: Extracted automatically from a single official source (section "Agent loading issues"). Related: https://latestn.com/tool/kiro/troubleshooting/change-requirements-after-design How do I change Kiro spec requirements after the design phase is done? https://latestn.com/tool/kiro/troubleshooting/check-mcp-logs How do I check MCP logs in Kiro to troubleshoot a server? https://latestn.com/tool/kiro/troubleshooting/check-tls-inspection-affected How do I check whether Kiro is affected by TLS inspection issues? https://latestn.com/tool/kiro/troubleshooting/access-denied-after-sign-in How do I fix Kiro Web showing access denied after IAM Identity Center sign-in? https://latestn.com/tool/kiro/troubleshooting/acp-migration-troubleshooting How do I troubleshoot a Kiro ACP client migration that hangs or fails after upgrading to CLI V3? https://latestn.com/tool/kiro/troubleshooting/acp-timeout-error How do I resolve the AcpTimeoutError when the ACP prompt times out in Kiro Crew? https://latestn.com/tool/ All entries in AI tools Change log: Time | Event | Change | Source 2026-11-20T13:25:03Z | changed | List command: — → /agent list | [1] 2026-11-20T13:25:03Z | changed | Version check command: /agent list → — | [1] 2026-11-13T03:39:55Z | added | Entry created | — Changes for this entry as a feed: https://latestn.com/tool/kiro/troubleshooting/agent-not-found-wrong-version/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/troubleshooting/agent-not-found-wrong-version POST: https://latestn.com/dispute/tool/kiro/troubleshooting/agent-not-found-wrong-version with claim, evidence_url, and optionally field and contact (form-encoded or JSON) GET: https://latestn.com/dispute/tool/kiro/troubleshooting/agent-not-found-wrong-version?claim={what is wrong}&evidence_url={link} How to cite: LatestN. (2026). Why is my Kiro custom agent not found or loading the wrong version? Revision 2, last verified 2026-11-20T13:25:03Z. https://latestn.com/tool/kiro/troubleshooting/agent-not-found-wrong-version (accessed 2026-11-21T09:57:46Z). @misc{LatestN_tool_kiro_troubleshooting_agent_not_found_wrong_version_r2, title = {Why is my Kiro custom agent not found or loading the wrong version?}, author = {{LatestN}}, year = {2026}, howpublished = {\url{https://latestn.com/tool/kiro/troubleshooting/agent-not-found-wrong-version}}, note = {Revision 2; digest sha256:b19daffb0cdfe3a0; last verified 2026-11-20T13:25:03Z; accessed 2026-11-21T09:57:46Z} } 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/troubleshooting/agent-not-found-wrong-version