/terminal-setup does not support GNOME Terminal

Status Open
Maintainer reply None cached
Activity 10 comments · opened Sep 22, 2025

Description

The /terminal-setup command explicitly rejects GNOME Terminal with the message:

Terminal setup cannot be run from gnome-terminal.

GNOME Terminal is one of the most widely used terminal emulators on Linux systems, being the default terminal for GNOME desktop environments (used by Ubuntu, Fedora, and many other major distributions).

Current Behavior

When running /terminal-setup from GNOME Terminal, it fails with the above error message and only lists these supported terminals:

  • macOS: iTerm2, Apple Terminal
  • IDE: VSCode, Cursor, Windsurf
  • Other: Ghostty

Expected Behavior

GNOME Terminal should be supported alongside other common Linux terminals like:

  • GNOME Terminal
  • Konsole (KDE)
  • xterm
  • Alacritty
  • kitty
  • Terminator

Environment

GNOME Terminal can be detected via environment variables:

GNOME_TERMINAL_SERVICE=:1.1619
GNOME_TERMINAL_SCREEN=/org/gnome/Terminal/screen/...
COLORTERM=truecolor
TERM=xterm-256color

Impact

This limitation prevents Linux users on GNOME-based distributions from accessing Claude Code's terminal integration features, affecting a significant portion of the Linux user base.

Suggested Solution

Add detection and support for GNOME Terminal (and ideally other common Linux terminals) to the /terminal-setup command.

View original on GitHub ↗

10 Comments

tukusejssirs · 11 months ago

Also add Warp Terminal and foot terminal to the list.

Anyway, I presume that the limitation of the feature is caused by some requirements—what are the requirements of /terminal-setup? Can’t you just test for individual requirements instead of the terminal app? 🤔

grocon · 11 months ago

also konsole please.


> /terminal-setup 
  ⎿  Terminal setup cannot be run from konsole.
lxdraw · 9 months ago

And terminals in Jetbrains IDEs. I've tried IDEA and Fleet.

Saigut · 8 months ago

How's it going?

StudioLE · 7 months ago

Also see this issue on Ptyxis which is now the default terminal on many GNOME distributions. #14939

---

Ptyxis is the default terminal for:

  • Fedora Workstation/Silverblue/Kinoite 41+ source
  • Project Bluefin and other Universal Blue immutable distributions source
  • Ubuntu 25.10+ source

This makes the lack of Shift+Enter support a significant usability issue for a growing portion of Linux users. Multi-line prompts are essential for providing context to Claude.

The workaround of using "quick escape" workaround (\ + Enter, source) is clunky.

As I understand it, the underlying issue is that VTE sends the same byte sequence for Enter and Shift+Enter. Related: https://gitlab.gnome.org/GNOME/vte/-/merge_requests/14

I searched the Ptyxis issue tracker but found no existing issues for shift+enter or kitty keyboard protocol the work is happening upstream in VTE itself.

I'm on Bluefin DX 43 (based on Fedora Silverblue) running GNOME 49 with Ptyxis as the terminal.

$ gnome-shell --version
GNOME Shell 49.2
$ cat /etc/os-release
NAME="Bluefin"
VERSION="latest-43.20260122.1 (Silverblue)"
RELEASE_TYPE=stable
ID=bluefin
ID_LIKE="fedora"
VERSION_ID=43
VERSION_CODENAME="Deinonychus"
PRETTY_NAME="Bluefin (Version: latest-43.20260122.1)"
...
$ ptyxis --version
Ptyxis 49.2

  GTK: 4.20.3 (Compiled against 4.20.2)
  VTE: 0.82.2 (Compiled against 0.82.1)
...
mattnelsonuk · 7 months ago

It's wild that I still can't shift+enter in gnome terminal or any of the Intellij IDE's. In IntelliJ IDEA 2025.3.2 it seems to incorrectly identify the terminal as PyCharm.

  ↑ Install the PyCharm plugin from the JetBrains Marketplace: https://docs.claude.com/s/claude-code-jetbrains                                                                                                                                                               
                                                                                                                                                                                                                                                                             
❯ /terminal-setup                                                                                                                                                                                                                                                            
  ⎿  Terminal setup cannot be run from pycharm.
gorban · 5 months ago

I fixed this by rebuilding Ptyxis with a branch of VTE dependency from:
https://gitlab.gnome.org/unxed/vte/-/tree/kitty

Now I can use the Gnome default terminal and CLI tools can multiline text without submitting

yurukusa · 5 months ago

GNOME Terminal doesn't support the Kitty keyboard protocol, which is what /terminal-setup configures for enhanced key handling (Shift+Enter, etc.). But you can get most of the functionality manually:
Manual setup for GNOME Terminal:

  1. Shift+Enter for newlines — GNOME Terminal doesn't support sending custom escape sequences for Shift+Enter natively. Use Escape, Enter as an alternative (press Escape then Enter to insert a newline).
  2. Font setup — Install a Nerd Font for proper icon rendering:

``bash
sudo apt install fonts-firacode # or
sudo dnf install fira-code-fonts
``
Then: GNOME Terminal → Preferences → Profile → Custom font → "FiraCode Nerd Font"

  1. Color scheme — GNOME Terminal themes can be set via:

``bash
bash -c "$(wget -qO- https://git.io/vQgMr)"
`
**Better alternative — switch to a supported terminal:**
If you need full Claude Code keyboard support:
| Terminal | Install | Kitty Protocol | Notes |
|----------|---------|---------------|-------|
| **Kitty** |
sudo apt install kitty | Yes | Best Linux terminal for Claude Code |
| **Ghostty** | Download from ghostty.org | Yes | Modern, fast |
| **Alacritty** |
cargo install alacritty | Partial | GPU-accelerated |
| **WezTerm** | Download from wezfurlong.org | Yes | Cross-platform |
Kitty is the recommended choice on Linux — it supports the full keyboard protocol that Claude Code uses and works with
/terminal-setup out of the box.
**Workaround for the missing Shift+Enter:**
If you stay on GNOME Terminal, you can still use Claude Code — you just can't insert newlines with Shift+Enter. Use paste (
Ctrl+Shift+V`) for multi-line prompts instead.

kenberland · 4 months ago

ctrl-j works for newlines as well.

GlennLeBlanc-at · 2 months ago

Also ttyd