aws / aws/amazon-q-developer-cli

Terminal support: kiro-cli doctor fails in Kiro's integrated terminal (dev.kiro.desktop)

Open Beginner friendly
#3,898 0 comments 0 reactions 0 assignees View on GitHub
Dominant language
Rust
Stars
2k
Forks
439
PR merge metrics
No merged PRs in 30d

Description

### Checks

- [x] I have searched [github.com/aws/amazon-q-developer-cli/issues](https://github.com/aws/amazon-q-developer-cli/issues?q=) and there are no duplicates of my issue
- [x] I have run `q doctor` in the affected terminal session
- [x] I have run `q restart` and replicated the issue again

### Operating system

macOS 26.5.2 (25F84)

### Expected behaviour

`kiro-cli doctor` échoue avec "Unsupported terminal" quand il est lancé depuis le terminal intégré de l'app Kiro (bundle identifier: dev.kiro.desktop).

La commande fonctionne correctement dans un terminal externe (Terminal.app), confirmant que le blocage vient spécifiquement de la détection du terminal intégré.

Erreur :
✘ Terminal support: Unsupported terminal, if you believe this is a mistake or would like to see support for your terminal, run kiro-cli issue
__CFBundleIdentifier: dev.kiro.desktop

### Actual behaviour

`kiro-cli doctor` échoue avec "Unsupported terminal" quand il est lancé depuis le terminal intégré de l'app Kiro (bundle identifier: dev.kiro.desktop).

La commande fonctionne correctement dans un terminal externe (Terminal.app), confirmant que le blocage vient spécifiquement de la détection du terminal intégré.

Erreur :
✘ Terminal support: Unsupported terminal, if you believe this is a mistake or would like to see support for your terminal, run kiro-cli issue
__CFBundleIdentifier: dev.kiro.desktop

### Steps to reproduce

_No response_

### Environment

```yaml

[q-details]
version = "2.18.1"
hash = "74b78bb5a369788e393b06654b2b213d937a41d2"
date = "2026-08-13T23:20:56.707604Z (6d ago)"
variant = "full"

[system-info]
os = "macOS 26.5.2 (25F84)"
chip = "Apple M4"
total-cores = 10
memory = "16.00 GB"

[environment]
cwd = "/Users/nicolas.moebs@cacd2.fr/cacd2/cacd2/cast/medicalib-app"
cli-path = "/Users/nicolas.moebs@cacd2.fr/cacd2/cacd2/cast/medicalib-app"
os = "Mac"
shell-path = "/opt/homebrew/Cellar/bash/5.3.15/bin/bash"
shell-version = "5.3.15"
install-method = "unknown"

[env-vars]
PATH = "/Users/USER/.nvm/versions/node/v22.23.1/bin:/Users/USER/.nvm/versions/node/v22.23.1/bin:/usr/local/bin:/System/Cryptexes/App/usr/bin:/usr/bin:/bin:/usr/sbin:/sbin:/var/run/com.apple.security.cryptexd/codex.system/bootstrap/usr/local/bin:/var/run/com.apple.security.cryptexd/codex.system/bootstrap/usr/bin:/var/run/com.apple.security.cryptexd/codex.system/bootstrap/usr/appleinternal/bin:/pkg/env/global/bin:/Library/Apple/usr/bin:/opt/homebrew/bin:/Users/USER/.bun/bin:/Users/USER/.pulumi/bin:/opt/homebrew/opt/openjdk@21/libexec/openjdk.jdk/Contents/Home/bin:/opt/anaconda3/bin:/opt/anaconda3/condabin:/Users/USER/.nvm/versions/node/v22.23.1/bin:/opt/homebrew/sbin:/Users/USER/.local/bin"
QTERM_SESSION_ID = "3dc7ff3d02bb40038708eff32e9fb9a7"
Q_SET_PARENT_CHECK = "1"
Q_TERM = "2.18.1"
SHELL = "/bin/zsh"
TERM = "xterm-256color"
__CFBundleIdentifier = "dev.kiro.desktop"
```

Contributor guide

Open the contributing guide

Research direction

Start by locating the terminal-support detection that reports "Unsupported terminal" and inspect how terminal bundle identifiers are recognized. Reproduce with `kiro-cli doctor` in Kiro's integrated terminal and an external Terminal.app session; done means the Kiro session is accepted while existing terminal behavior remains unchanged.

Written by the indexing model from the issue text.

Assessment

Tech stack
macos, rust
Domain
cli, operating-systems
Issue type
Bug
Difficulty
2/5
Estimated time
1-3 hours
Activity status
Active
Clarity
Mostly clear
Newbie friendliness
72/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.