/terminal-setup does not support GNOME Terminal
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.
10 Comments
Also add Warp Terminal and
footterminal 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? 🤔also konsole please.
And terminals in Jetbrains IDEs. I've tried IDEA and Fleet.
How's it going?
Also see this issue on Ptyxis which is now the default terminal on many GNOME distributions. #14939
---
Ptyxis is the default terminal for:
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.
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.2it seems to incorrectly identify the terminal as PyCharm.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
GNOME Terminal doesn't support the Kitty keyboard protocol, which is what
/terminal-setupconfigures for enhanced key handling (Shift+Enter, etc.). But you can get most of the functionality manually:Manual setup for GNOME Terminal:
Escape, Enteras an alternative (press Escape then Enter to insert a newline).``
bash
``sudo apt install fonts-firacode # or
sudo dnf install fira-code-fonts
Then: GNOME Terminal → Preferences → Profile → Custom font → "FiraCode Nerd Font"
``
bash
`bash -c "$(wget -qO- https://git.io/vQgMr)"
sudo apt install kitty**Better alternative — switch to a supported terminal:**
If you need full Claude Code keyboard support:
| Terminal | Install | Kitty Protocol | Notes |
|----------|---------|---------------|-------|
| **Kitty** |
| Yes | Best Linux terminal for Claude Code |cargo install alacritty| **Ghostty** | Download from ghostty.org | Yes | Modern, fast |
| **Alacritty** |
| Partial | GPU-accelerated |/terminal-setup| **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
out of the box.Ctrl+Shift+V`) for multi-line prompts instead.**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-j works for newlines as well.
Also ttyd