Answer: To troubleshoot a Kiro ACP client migration that hangs or fails after upgrading to CLI V3, confirm the client writes one JSON-RPC object per line; if --auth-method=client is present, verify that the client answers _kiro/auth/getAccessToken, and ensure any agent-to-client request with an id gets a response or an explicit JSON-RPC error. If the process does not start, use the full path to kiro-cli, confirm it is executable, and remove unsupported v3 launch flags. Status: Confirmed Entry: tool/kiro/troubleshooting/acp-migration-troubleshooting Revision: 1 Digest: sha256:b3a519e5d7d68cfb (changes whenever the content changes) Timeline: Created: 2026-11-13T03:37:11Z Last changed: 2026-11-13T03:37:11Z Last verified: 2026-11-20T13:20:57Z Next check: 2026-11-21T13:20:57Z Check interval: Daily Expected change: No fixed schedule Data: Field | Value | Source | As of hang troubleshooting step | Confirm the client writes one JSON-RPC object per line | [1] | 2026-11-20 auth method flag | --auth-method=client | [1] | 2026-11-20 request response requirement | Any agent-to-client request with an id requires a response or an explicit JSON-RPC error | [1] | 2026-11-20 startup troubleshooting step | Use the full path to kiro-cli | [1] | 2026-11-20 turn completion step | Settle the turn from the session/prompt response | [1] | 2026-11-20 Sources: [1] Amazon Web Services. "ACP client migration - Upgrade from CLI 2.x - CLI - Docs - Kiro". https://kiro.dev/docs/cli/v3/acp-migration/ Role: primary. Accessed: 2026-11-20T13:20:57Z Quote: "Confirm the client writes one JSON-RPC object per line." (Supports: hang troubleshooting step) Quote: "If --auth-method=client is present, verify that the client answers _kiro/auth/getAccessToken ." (Supports: auth method flag) Quote: "Any agent-to-client request with an id requires a response or an explicit JSON-RPC error." (Supports: request response requirement) Quote: "Use the full path to kiro-cli , confirm it is executable, and remove unsupported v3 launch flags." (Supports: startup troubleshooting step) Quote: "Settle the turn from the session/prompt response." (Supports: turn completion step) Published: 2026-11-20T07:39:25Z Snapshot SHA-256: 003b7aafb2f220e2ea06442b5fbf1143a26418be6b7d3da3ebdb0adb13f9e31c (captured 2026-11-20T13:20:56Z) 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:20:57Z. No independent second source is configured for this entry Last successful check: 2026-11-20T13:20:57Z Last attempt: 2026-11-20T13:20:57Z Notes and limitations: Extracted automatically from a single official source (section "Troubleshooting"). Related: 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/kiro/troubleshooting/agent-not-found-wrong-version Why is my Kiro custom agent not found or loading the wrong version? 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/settings/what-can-be-uploaded What can I upload with Kiro's configuration sync? https://latestn.com/tool/kiro/settings/windows-shell-selection How do I change the shell used by the terminal on Windows in Kiro? 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/ All entries in AI tools Change log: Time | Event | Change | Source 2026-11-13T03:37:11Z | added | Entry created | — Changes for this entry as a feed: https://latestn.com/tool/kiro/troubleshooting/acp-migration-troubleshooting/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/acp-migration-troubleshooting POST: https://latestn.com/dispute/tool/kiro/troubleshooting/acp-migration-troubleshooting with claim, evidence_url, and optionally field and contact (form-encoded or JSON) GET: https://latestn.com/dispute/tool/kiro/troubleshooting/acp-migration-troubleshooting?claim={what is wrong}&evidence_url={link} How to cite: LatestN. (2026). How do I troubleshoot a Kiro ACP client migration that hangs or fails after upgrading to CLI V3? Revision 1, last verified 2026-11-20T13:20:57Z. https://latestn.com/tool/kiro/troubleshooting/acp-migration-troubleshooting (accessed 2026-11-21T10:03:40Z). @misc{LatestN_tool_kiro_troubleshooting_acp_migration_troubleshooting_r1, title = {How do I troubleshoot a Kiro ACP client migration that hangs or fails after upgrading to CLI V3?}, author = {{LatestN}}, year = {2026}, howpublished = {\url{https://latestn.com/tool/kiro/troubleshooting/acp-migration-troubleshooting}}, note = {Revision 1; digest sha256:b3a519e5d7d68cfb; last verified 2026-11-20T13:20:57Z; accessed 2026-11-21T10:03:40Z} } 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/acp-migration-troubleshooting