Answer: Yes, in Kiro CLI 2.37 or later a V3 session automatically upgrades pending V2-format agents when it starts, without asking. It is designed to be safe: each rewritten file first gets a .json.bak backup so you can revert an upgrade, though it follows symlinks and rewrites linked targets in place, even outside the scanned directory. Status: Confirmed Entry: tool/kiro/agents-and-automation/automatic-agent-upgrade-on-start Revision: 1 Digest: sha256:4dfd7da15f4776c2 (changes whenever the content changes) Timeline: Created: 2026-11-13T03:37:20Z Last changed: 2026-11-13T03:37:20Z Last verified: 2026-11-20T13:21:10Z Next check: 2026-11-21T13:21:10Z Check interval: Daily Expected change: No fixed schedule Data: Field | Value | Source | As of automatic upgrade version | 2.37 | [1] | 2026-11-20 backup file suffix | .json.bak | [1] | 2026-11-20 setting to disable | chat.enableAutoAgentUpgrade | [1] | 2026-11-20 default workspace scan directory | .kiro/agents/ | [1] | 2026-11-20 global scan directory | ~/.kiro/agents/ | [1] | 2026-11-20 override directory variable | KIRO_AGENT_CONFIG_DIR | [1] | 2026-11-20 Sources: [1] Amazon Web Services. "Upgrading agent configs - Upgrade from CLI 2.x - CLI - Docs - Kiro". https://kiro.dev/docs/cli/v3/upgrade-agent/ Role: primary. Accessed: 2026-11-20T13:21:10Z Quote: "In Kiro CLI 2.37 or later, a V3 session upgrades pending V2-format agents when it starts" (Supports: automatic upgrade version) Quote: "Each rewritten file first gets a .json.bak backup." (Supports: backup file suffix) Quote: "To turn the automatic upgrade off: bash kiro-cli settings chat.enableAutoAgentUpgrade false" (Supports: setting to disable) Quote: "by default, .kiro/agents/ in your workspace and ~/.kiro/agents/ globally" (Supports: default workspace scan directory, global scan directory) Quote: "When KIRO_AGENT_CONFIG_DIR is set, Kiro scans that directory instead of the global directory and skips the workspace scan." (Supports: override directory variable) Published: 2026-11-20T07:39:25Z Snapshot SHA-256: 66e36a12849e0ae401eeb02dad86ed913621bf244ec09230363cfbc9baa182cb (captured 2026-11-20T13:21:11Z) 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:21:10Z. No independent second source is configured for this entry Last successful check: 2026-11-20T13:21:10Z Last attempt: 2026-11-20T13:21:10Z Notes and limitations: Extracted automatically from a single official source (section "Automatic upgrade when V3 starts"). Related: https://latestn.com/tool/kiro/agents-and-automation/available-agent-backends Which agent backends are available in Kiro Crew? https://latestn.com/tool/kiro/agents-and-automation/background-delegation-sub-agents How do background delegation and sub-agents work in Kiro workflows? https://latestn.com/tool/kiro/agents-and-automation/before-creating-task What should I do before creating a task when chatting with the Kiro agent? https://latestn.com/tool/kiro/agents-and-automation/agent-prompt-action How do I configure an Agent Prompt action in a Kiro hook? https://latestn.com/tool/kiro/agents-and-automation/ask-kiro-investigate-physics-bug How do I ask Kiro to investigate a subtle physics bug? https://latestn.com/tool/kiro/agents-and-automation/assign-tasks-from-github-issues How do I assign tasks to Kiro from GitHub issues? https://latestn.com/tool/ All entries in AI tools Change log: Time | Event | Change | Source 2026-11-13T03:37:20Z | added | Entry created | — Changes for this entry as a feed: https://latestn.com/tool/kiro/agents-and-automation/automatic-agent-upgrade-on-start/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/automatic-agent-upgrade-on-start POST: https://latestn.com/dispute/tool/kiro/agents-and-automation/automatic-agent-upgrade-on-start with claim, evidence_url, and optionally field and contact (form-encoded or JSON) GET: https://latestn.com/dispute/tool/kiro/agents-and-automation/automatic-agent-upgrade-on-start?claim={what is wrong}&evidence_url={link} How to cite: LatestN. (2026). Does Kiro CLI V3 automatically upgrade agent configs when it starts, and is that safe? Revision 1, last verified 2026-11-20T13:21:10Z. https://latestn.com/tool/kiro/agents-and-automation/automatic-agent-upgrade-on-start (accessed 2026-11-21T10:07:59Z). @misc{LatestN_tool_kiro_agents_and_automation_automatic_agent_upgrade_on_start_r1, title = {Does Kiro CLI V3 automatically upgrade agent configs when it starts, and is that safe?}, author = {{LatestN}}, year = {2026}, howpublished = {\url{https://latestn.com/tool/kiro/agents-and-automation/automatic-agent-upgrade-on-start}}, note = {Revision 1; digest sha256:4dfd7da15f4776c2; last verified 2026-11-20T13:21:10Z; accessed 2026-11-21T10:07:59Z} } 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/automatic-agent-upgrade-on-start