Cannot use Q because qterm is not running in terminal on ubuntu linux

[gkodali-zededa]

Checks

• I ran q doctor in the affected command line session and it didn't resolve my issue
• I ran q restart and it didn't resolve my issue
• I searched the discussions in this repo and there are no duplicates of my issue

Expected behaviour

I expected the auto complete suggestions to work.

Actual behaviour

q doctor dumped the following error text

✘ 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!

I tried q restart and it dumped the following error
error: Please restart Amazon Q from your host machine

Steps to reproduce

Installed Q following the instructions on Ubuntu 22.04. Tried using autocomplete but the feature did not work.
https://docs.aws.amazon.com/amazonq/latest/qdeveloper-ug/command-line-autocomplete-ssh.html

Environment

[q-details]
version = "1.3.3"
hash = "d6f7500447e6a60baec72c2ca6d695a27c73f977"
date = "2024-07-30T00:28:33.163505Z (10d ago)"

[system-info]
chip = "Intel(R) Xeon(R) E-2224 CPU @ 3.40GHz"
total-cores = 4
memory = "62.65 GB"

[system-info.os.linux]
kernel_version = "5.15.0-117-generic"
id = "ubuntu"
name = "Ubuntu"
pretty_name = "Ubuntu 22.04.4 LTS"
version_id = "22.04"
version = "22.04.4 LTS (Jammy Jellyfish)"

[environment]
cwd = "/home/USER"
cli-path = "/home/USER/.local/bin/q"
shell-path = "/usr/bin/bash"
shell-version = "5.1.16"
install-method = "unknown"

[env-vars]
PATH = "/home/USER/.local/bin:/home/USER/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin:/usr/games:/usr/local/games:/snap/bin:/home/USER/.local/bin:/home/USER/bin:/home/USER/.nvm:/usr/local/go/bin:/home/USER/go/bin/:/usr/local/go/bin"
Q_SET_PARENT_CHECK = "1"
SHELL = "/bin/bash"
TERM = "xterm-256color"
XDG_SESSION_TYPE = "tty"

[mirorac]

I have the same issue.

[wzaldivar]

same error with Ghostty, working on GNOME Terminal

[alanwilter]

Well, what happened for me is this:

• If ssh from my Mac to my remote server (Linux), Q works fine
• If I use the terminal on vscode-remote for this remote server, I need to manually run qterm.

However, even after qterm, if I do git push (on vscode-remote terminal) I get:

error: Q_PARENT env variable not set

[allamand]

I added this in my setup : export Q_PARENT="q chat", and the error disappear..

[deepaknegi41]

I was able to do a quick fix of this by running the qterm manually.

Steps

1. Check where the qterm is present. In mac, its present at "/Applications/Amazon Q.app/Contents/MacOS/qterm"
2. Create a symbolic link for qterm: sudo ln -s "/Applications/Amazon Q.app/Contents/MacOS/qterm" "/Users/<username>/.local/bin/qterm"

Run the command qterm before starting q chat

q doctor output

% q doctor

✔ Everything looks good!

  Amazon Q still not working? Run q issue to let us know!

[setheliot]

This is the answer! Thank you!

Would still like to understand why the install fails for so many in the first place.

[robcolburn]

Q worked well, but then stopped working a week or so ago (mac update maybe?). I think my path got messed up, so I cleaned up my ~/.zshrc , then I got the error described in the thread. I looked for the symlink that @deepaknegi41 mentioned, but it was already there. So, I just I just ran it, it worked, and now every new terminal session also works. I guess it fixes itself?