aws / aws/amazon-q-developer-cli

Bug Report: GNOME Extension Error when using Amazon Q on Ubuntu 25 + Wayland

Open
#2,190 0 comments 1 reaction 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.14.0-22-generic - Ubuntu 25.04

### Expected behaviour

I expected Amazon Q to start normally without any GNOME Shell Extension errors when running in a Wayland session on Ubuntu 25.04.

Specifically:

Running q from the terminal should start the CLI or the desktop app without error.

The GNOME extension should either work under Wayland or be safely skipped during installation when Wayland is detected.

The q doctor command should not report extension errors when running in a Wayland environment, or at least should provide clear instructions for Wayland users.

### Actual behaviour

## 🐞 Bug Report: GNOME Extension Error when using Amazon Q on Ubuntu 25 + Wayland

### 📋 Problem Description:

I’m using **Ubuntu 25.04** with **Wayland** as the default display server.

After installing Amazon Q, whenever I run the `q` command from the terminal or try to launch the app, I get the following error:

```
✘ GNOME Shell Extension Check: The Amazon Q GNOME extension is in an errored state. Please uninstall it and restart your current session.

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

---

### 🖥️ Environment Details:

* **OS:** Ubuntu 25.04 (Wayland session)
* **Amazon Q version:** (Latest stable from official website as of today, \[add version number if you have it])
* **Execution Mode:** Running from terminal (CLI)
* **GNOME Extension Installed:** Yes (auto-installed during Q setup)

### 📌 Additional Notes:

* If I log into an **X11 session**, Amazon Q runs without this issue.
* This seems to be related to **Wayland compatibility issues with the Amazon Q GNOME Shell Extension**, or with how the extension attempts to hook into GNOME Shell.

---

### 🧑‍💻 Suggestions for the Q Team:

* Please review Wayland compatibility for the GNOME extension.
* Consider adding an installer option to **skip installing the GNOME extension when running under Wayland**.
* Improve the `q doctor` output to better detect Wayland and provide more helpful guidance for users in Wayland sessions.

---

### 🙏 Thanks in advance for your support.

Happy to provide logs or further environment details if needed.

---

### Steps to reproduce

---

### ✅ Steps to Reproduce:

1. Install Amazon Q on Ubuntu 25.04
2. Run `q` from terminal
3. Result: Error related to the GNOME Shell Extension, Q GUI does not start properly.

---

### Environment

```yaml

[q-details]
version = "1.12.2"
hash = "b9100eb751546269f095585705a0e7fc3ea55419"
date = "2025-06-30T22:43:46.721054Z (8h ago)"
variant = "full"

[system-info]
chip = "Intel(R) Core(TM) i7-10850H CPU @ 2.70GHz"
total-cores = 6
memory = "30.33 GB"

[system-info.os.linux]
kernel_version = "6.14.0-22-generic"
id = "ubuntu"
name = "Ubuntu"
pretty_name = "Ubuntu 25.04"
version_id = "25.04"
version = "25.04 (Plucky Puffin)"

[environment]
cwd = "/home/USER"
cli-path = "/home/USER"
os = "Linux"
shell-path = "/usr/bin/zsh"
shell-version = "5.9"
terminal = "Gnome Terminal"
install-method = "unknown"

[env-vars]
DISPLAY = ":0"
GTK_IM_MODULE = "ibus"
PATH = "/home/USER/.nvm/versions/node/v24.3.0/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin:/usr/games:/usr/local/games:/snap/bin:/snap/bin:/home/USER/.local/bin:/home/USER/Android/Sdk/emulator:/home/USER/Android/Sdk/tools:/home/USER/Android/Sdk/tools/bin:/home/USER/Android/Sdk/platform-tools"
QTERM_SESSION_ID = "0a052c75393f4de4aaae5a35968be01c"
QT_IM_MODULE = "ibus"
Q_SET_PARENT_CHECK = "1"
Q_TERM = "1.12.2"
SHELL = "/usr/bin/zsh"
TERM = "xterm-256color"
XDG_CURRENT_DESKTOP = "ubuntu:GNOME"
XDG_SESSION_DESKTOP = "ubuntu"
XDG_SESSION_TYPE = "wayland"
XMODIFIERS = "@im=ibus"
```

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.