Amazon Q Developer CLI known issues

Known breaks in Amazon Q Developer CLI from github.com/aws/amazon-q-developer-cli, with quoted workarounds and fixed-in versions where they exist.

Before you upgrade Amazon Q Developer CLI

Type the version you're about to install (or just upgraded to). Lists tracked issues that mention it. Same data as /api/issues/amazon-q-cli.json.

Mentioned in open issues:

Pulled from public GitHub issues updated in the last 45 days and filtered for always-on problems: install and update breakage, crashes and hangs, gateway/daemon trouble, auth, and headless setups. Ranked by engagement, weighted toward always-on, self-hosting, install/update, crash, auth, MCP and daemon problems (cosmetic desktop-UI issues are down-weighted). Workarounds and "fixed in" versions are quoted only when the issue or its top comments state them. Severity is an automatic estimate from labels, keywords, and engagement, not an official rating. Last refresh: Oct 26, 2026 6:18 AM ET.

Amazon Q Developer CLI medium open auth/session

Social login (Google) has no profileArn; chat fails with "profileArn is required but no profiles are available

I have run q doctor in the affected terminal session I have run q restart and replicated the issue again macOS 26.3.1 (25D771280a) After logging in with Google (SocialGoogle), kiro-cli whoami should include a resolved Profile section…

aws/amazon-q-developer-cli#3695versions 1.28.2, 48.00, 5.9 1 thumbs up · 7 comments opened 2026-03-27 · updated 2026-10-22
Amazon Q Developer CLI medium fixed install/update

bug: acp integration with intellij no longer works since update to kiro-cli 1.28.1

I have run q doctor in the affected terminal session I have run q restart and replicated the issue again https://kiro.dev/docs/cli/acp/ acp integration used to work as per above instructions until update this week get an error in intellij…

aws/amazon-q-developer-cli#3684versions 1.28.1 11 thumbs up · 3 comments opened 2026-03-25 · updated 2026-10-05
Amazon Q Developer CLI medium closed self-host/headless

Amazon Q CLI not loading MCP servers despite correct configuration

Can't use MCP anymore. Tool Permission executebash trust read-only commands fsread trusted fswrite not trusted introspect trusted reportissue trusted useaws trust read-only commands Servers still loading version = "1.15.0" hash =…

aws/amazon-q-developer-cli#2768versions 1.15.0, 16.00, 5.9 4 thumbs up · 0 comments opened 2025-09-03 · updated 2026-09-29
Amazon Q Developer CLI medium open install/update

Kiro CLI 2.33.1 on macOS bundles Node.js 22.22.2. Node.js 22.23.4 includes security fixes released October 21, 2026. Please update the bundled runtime.

I have run q doctor in the affected terminal session I have run q restart and replicated the issue again macOS 26.7.1 (25G313) Kiro points to the updated Version of note Kiro points to the unsafe Version of note

aws/amazon-q-developer-cli#3932versions 2.33.1, 36.00, 5.9 0 thumbs up · 0 comments opened 2026-10-23 · updated 2026-10-23
Amazon Q Developer CLI medium open install/update

macOS leaves Kiro CLI HFS+ installer volumes mounted after updates

I have run q doctor in the affected terminal session I have run q restart and replicated the issue again macOS 26.5.2 (25F84) Installer / updater image disks are unmounted after an update. I get a growing list of mounted disk images over…

aws/amazon-q-developer-cli#3923versions 2.0, 1.9, 1.4 0 thumbs up · 1 comments opened 2026-10-04 · updated 2026-10-04
Amazon Q Developer CLI medium fixed auth/session

Login is not persistant

I have run q doctor in the affected terminal session I have run q restart and replicated the issue again macOS 15.3.2 (24D81) look like the last release introduced a bug in login session not being persisted. i keep getting asked about to…

aws/amazon-q-developer-cli#829versions 1.7.0, 64.00, 5.9 2 thumbs up · 0 comments opened 2025-03-14 · updated 2026-10-22
Amazon Q Developer CLI medium open mcp/tools

● failed to retrieve governance settings — MCP and web tools disabled

I have run q doctor in the affected terminal session I have run q restart and replicated the issue again Linux 6.6.87.2-microsoft-standard-WSL2 - Ubuntu 20.04.6 LTS kiro cli should start ● failed to retrieve governance settings — MCP and…

aws/amazon-q-developer-cli#3915versions 2.23.1, 31.15, 20.04 0 thumbs up · 1 comments opened 2026-09-23 · updated 2026-10-09
Amazon Q Developer CLI medium open self-host/headless

远程 SSH 连接 macOS (darwin-arm64)失败

I have run q doctor in the affected terminal session I have run q restart and replicated the issue again macOS 26.4.0 (25E246) Windows 客户端升级至 commit a9f293869e317e8f9e195227dffceb57fe52a847 后,远程 SSH 连接 macOS (darwin-arm64) 下载缺失…

aws/amazon-q-developer-cli#3929versions 2.30.0, 32.00, 5.9 0 thumbs up · 0 comments opened 2026-10-13 · updated 2026-10-13
Amazon Q Developer CLI medium fixed auth/session

bug: q login ignoring identity-provider/region flags

I have run q doctor in the affected terminal session I have run q restart and replicated the issue again macOS 15.6.1 If I pass in the --identity-provider or --region flag, I'd expect a browser window or automatic login. If I pass in the…

aws/amazon-q-developer-cli#3358versions 1.19.3, 36.00, 4.1.2 0 thumbs up · 0 comments opened 2025-11-04 · updated 2026-10-22
Amazon Q Developer CLI medium open mcp/tools

failed to retrieve governance settings — MCP and web tools disabled

I have run q doctor in the affected terminal session I have run q restart and replicated the issue again macOS 15.7.9 (24G830) which kiro-cli kiro-cli 2.29.0 /Users/username/.local/bin/kiro-cli it should properly start with connecting mcp…

aws/amazon-q-developer-cli#3926versions 2.29.0, 24.00, 5.9 0 thumbs up · 0 comments opened 2026-10-10 · updated 2026-10-10
Amazon Q Developer CLI medium fixed self-host/headless

Auth refresh fails with "ACP connection closed" — dispatch failure on every request (CLI 2.23.0, WSL)

I have run q doctor in the affected terminal session I have run q restart and replicated the issue again Linux 6.6.87.2-microsoft-standard-WSL2 - Ubuntu 24.04.4 LTS kiro-cli 2.23.0 WSL2 (Ubuntu) on a corporate/enterprise network (MDLZ)…

aws/amazon-q-developer-cli#3914versions 2.23.0, 1.28.1, 7.47 0 thumbs up · 1 comments opened 2026-09-22 · updated 2026-09-23
Amazon Q Developer CLI low open install/update

Startup stalls ~2s before first frame: shim walks all of /proc, cost scales with machine thread count

I have run q doctor in the affected terminal session I have run q restart and replicated the issue again Linux Red Hat Enterprise Linux 8.10 (Ootpa) kiro-cli chat launch doesn't take super long kiro-cli chat launch takes super long and is…

aws/amazon-q-developer-cli#3921versions 2.21.0, 2.21.4, 2.23.0 0 thumbs up · 0 comments opened 2026-10-02 · updated 2026-10-02
Amazon Q Developer CLI medium open install/update

cloudConfig.getManifest and ActivityLogPublisher return 401 Unable to resolve user ID after upgrade to 2.21.4

I have run q doctor in the affected terminal session I have run q restart and replicated the issue again Linux 6.18.33.2-microsoft-standard-WSL2 - Debian GNU/Linux 13 (trixie) Description: After upgrading kiro-cli to 2.21.4, every session…

aws/amazon-q-developer-cli#3911versions 2.21.4 0 thumbs up · 0 comments opened 2026-09-16 · updated 2026-09-16