aws / aws/amazon-q-developer-cli

Terminal rendering issues in DCV - unreadable characters displayed

Open
#2,412 2 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 5.10.239-216.958.amzn2int.x86_64 - Amazon Linux 2

### Expected behaviour

When Amazon Q CLI is installed, the terminal opened via DCV should render properly, with readable text and proper formatting.

### Actual behaviour

Amazon Q CLI causes terminal in DCV (NICE DCV) to render improperly, displaying unreadable characters that make the interface unusable.

```
[chat-transcript]
> amazon q causes terminal in DCV to render improperly, adding unreadable characters

I understand you're experiencing terminal rendering issues with Amazon Q in DCV (NICE DCV) where unreadable characters are being displayed. This is likely related to terminal escape sequences or character encoding issues when running the Q CLI in a remote desktop environment.

Here are some troubleshooting steps to resolve this:

## Check Terminal Settings

First, let's check your current terminal environment:
[Tool uses: execute_bash]

[Tool uses: execute_bash]

> y

## Potential Solutions

1. **Set a simpler terminal type**: Try setting TERM to a more basic value:
\```bash
export TERM=xterm
q chat
\```

2. **Disable color output**: Run Q with color disabled:
\```bash
NO_COLOR=1 q chat
\```

3. **Use a different terminal emulator**: If you're using the default DCV terminal, try:
- Opening a different terminal application (like gnome-terminal, xterm, or konsole)
- Using a terminal multiplexer like tmux or screen

4. **Check Q CLI version and update**:
\```bash
q --version
# Update if needed
pip install --upgrade amazon-q-cli
\```

5. **Force UTF-8 encoding**:
\```bash
export LC_ALL=en_US.UTF-8
export LANG=en_US.UTF-8
q chat
\```

6. **Run in plain text mode**: Some CLI tools have options to disable fancy formatting:
\```bash
q chat --no-color # if this option exists
\```

## Alternative Workaround

If the rendering issues persist, you can try running Q CLI through SSH instead of directly in the DCV session:
- SSH into your instance from your local machine
- Run `q chat` from the SSH session

This often resolves terminal compatibility issues since SSH handles terminal emulation differently than DCV's built-in terminal.

Would you like me to help you try any of these solutions, or do you have more details about the specific unreadable characters you're seeing?
[Tool uses: none]

> q issue

I'll help you report an issue with Amazon Q. Let me open the GitHub issue template for you:
[Tool uses: report_issue]
```

### Steps to reproduce

After q is installed,

1. Connect to an instance via NICE DCV
2. Open terminal in DCV session
3. Observe unreadable characters in the terminal output

### Environment

```yaml

[q-details]
version = "1.12.7"
hash = "ed77799a52644ba49a3ed76b15c25cd9334c4b8d"
date = "2025-07-22T17:40:04.719028Z (7d ago)"

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

[system-info.os.linux]
kernel_version = "5.10.239-216.958.amzn2int.x86_64"
id = "amzn"
name = "Amazon Linux"
pretty_name = "Amazon Linux 2"
version_id = "2"
version = "2"
variant = "internal"

[environment]
cwd = "/local/home/USER/Documents/eagleRay/gaze_data/EagleRay_data/In_lab_fixation_study"
cli-path = "/local/home/USER/Documents/eagleRay/gaze_data/EagleRay_data/In_lab_fixation_study"
install-method = "toolbox"
in-ssh = true

[env-vars]
PATH = "/local/home/USER/git/sam2/sam2/.sam2_venv/bin:/home/USER/.local/share/mise/installs/node/18.20.2/bin:/home/USER/.local/share/mise/installs/python/3.12.11/bin:/home/USER/.local/share/mise/installs/python/3.11.13/bin:/home/USER/.local/share/mise/installs/python/3.10.18/bin:/home/USER/.local/share/mise/installs/python/3.9.23/bin:/home/USER/.local/share/mise/installs/python/3.8.20/bin:/home/USER/.toolbox/bin:/home/USER/.cargo/bin:/usr/local/bin:/usr/bin:/home/USER/bin:/usr/local/sbin:/usr/sbin:/home/USER/.local/bin:/apollo/env/DevEnv/bin"
Q_SET_PARENT_CHECK = "1"
SHELL = "/bin/zsh"
TERM = "xterm-256color"

[chat-settings]

[chat-trusted_tools]

[chat-failed_request_ids]
none

[chat-context]
current_profile=default
profiles=
default

global_context=
.amazonq/rules/**/*.md
README.md
AmazonQ.md

profile_context=none

files=none
```

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.