aws / aws/amazon-q-developer-cli

q doctor return error message that qterm is not running on VSCode terminal

Open
#795 3 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

Linux 6.8.0-1024-aws - Ubuntu 24.04.2 LTS

### Expected behaviour

I'm able to see `q doctor` success without any error messages after all installation process of Amazon Q for command line in my remote Linux instance:

* Started installing the `q` command following [this doc](https://docs.aws.amazon.com/amazonq/latest/qdeveloper-ug/command-line-installing.html)
* At step 4, as the remote instance doesn't have desktop environment, I followed the steps navigated by `q doctor`.
* ran `q integrations install dotfiles`
* add a couple of `sshd_config`
* restarted the machine and reconnected with SSH

### Actual behaviour

I got the following after reconnecting to the remote machine

```
$ q doctor

✘ Amazon Q terminal integrations: qterm is not running in this terminal, please try restarting your terminal

Q_TERM=

✘ Doctor found errors. Please fix them and try again.

If you are not sure how to fix it, please open an issue with q issue to let us know!
```

### Steps to reproduce

Just I followed the steps "Expected behavior".

### Environment

```yaml
[q-details]
version = "1.7.0"
hash = "8885a6708f2f07d02d29460a96f9c422da095e49"
date = "2025-03-06T01:07:14.925938Z (5d ago)"
variant = "full"

[system-info]
chip = "Intel(R) Xeon(R) CPU E5-2686 v4 @ 2.30GHz"
total-cores = 2
memory = "3.82 GB"

[system-info.os.linux]
kernel_version = "6.8.0-1024-aws"
id = "ubuntu"
name = "Ubuntu"
pretty_name = "Ubuntu 24.04.2 LTS"
version_id = "24.04"
version = "24.04.2 LTS (Noble Numbat)"

[environment]
cwd = "/home/USER/repos/zenn.dev.draft"
cli-path = "/home/USER/repos/zenn.dev.draft"
os = "Linux"
shell-path = "/usr/bin/zsh"
shell-version = "5.9"
terminal = "VSCode"
install-method = "unknown"
in-ssh = true

[env-vars]
PATH = "/home/USER/bin:/home/USER/.nodenv/shims:/home/USER/.nodenv/shims:/home/USER/.nodenv/bin:/home/USER/.nodenv/plugins/node-build/bin:/bin:/home/USER/go/bin:/home/USER/bin:/home/USER/.nodenv/shims:/home/USER/.nodenv/shims:/home/USER/.nodenv/bin:/home/USER/.nodenv/plugins/node-build/bin:/bin:/home/USER/go/bin:/home/USER/.vscode-server/cli/servers/Stable-6609ac3d66f4eade5cf376d1cb76f13985724bcb/server/bin/remote-cli:/home/USER/bin:/home/USER/.nodenv/shims:/home/USER/.nodenv/shims:/home/USER/.nodenv/bin:/home/USER/.nodenv/plugins/node-build/bin:/bin:/home/USER/go/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin:/usr/games:/usr/local/games:/snap/bin:/home/USER/.local/bin:/Applications/Visual Studio Code.app/Contents/Resources/app/bin:/home/USER/.toolbox/bin:/Applications/Visual Studio Code.app/Contents/Resources/app/bin:/home/USER/.toolbox/bin:/Applications/Visual Studio Code.app/Contents/Resources/app/bin:/home/USER/.toolbox/bin"
QTERM_SESSION_ID = "ceb039b7e40e4fb78f6864312e96ec68"
Q_SET_PARENT_CHECK = "1"
Q_TERM = "1.7.0"
SHELL = "/usr/bin/zsh"
TERM = "xterm-256color"
XDG_SESSION_TYPE = "tty"
ZDOTDIR = "/home/USER"
```

Contributor guide

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.