Ghostty TUI: opening URLs needs Shift+⌘+click or Ctrl+click, not the documented ⌘-click (v2.1.181)

Status Fixed / completed
Reported on v2.1.181
Maintainer reply None cached
Activity 4 comments · opened Jun 18, 2026 · closed Jun 23, 2026

What happened

On Ghostty, opening a URL from Claude Code's fullscreen TUI requires Shift+⌘+click or Ctrl+click. The simpler/documented gestures don't work:

  • plain click — nothing
  • ⌘-click — nothing (even though the v2.1.181 changelog says "Fullscreen URL opening: Now requires Cmd+click (macOS) / Ctrl+click, matching native terminal behavior")
  • Shift+click — nothing
  • Shift+⌘+click — opens the URL
  • Ctrl+click — opens the URL

Mechanics: since v2.1.89 Claude Code uses the alternate screen + mouse reporting, so Ghostty forwards mouse events (including ⌘-click) into the application instead of acting on them. The gestures that work are the ones that reach Ghostty's own link handler: Shift bypasses the app's mouse capture (so Shift+⌘+click = bypass + Ghostty's open modifier), and Ctrl+click likewise reaches the handler. The documented macOS ⌘-click gesture by itself never reaches the terminal's link handler under Ghostty.

Steps to reproduce

  1. macOS, Ghostty 1.3.1, Claude Code 2.1.181, default browser set.
  2. In a Claude Code session, produce output containing a URL (bare URL or markdown link).
  3. Try plain click, ⌘-click, Shift+click — none open the URL.
  4. Shift+⌘+click or Ctrl+click — opens it in the default browser.

Expected

The documented macOS ⌘-click gesture opens the URL in Ghostty as it does in a plain (non-Claude) shell — without needing Shift or Ctrl.

Confirmed NOT a macOS/browser-handler problem

  • open <url> from a plain shell routes correctly to the default browser.
  • ⌘-click on a URL works in a plain (non-Claude) Ghostty shell tab.
  • Only inside Claude Code's TUI is Shift+⌘+click / Ctrl+click required. This isolates it to Claude Code's mouse-reporting interaction with Ghostty.

Environment

  • Claude Code: 2.1.181
  • Terminal: Ghostty 1.3.1 (stable)
  • OS: macOS (Darwin 25.5.0)

Notes / workarounds

  • Working gestures: Shift+⌘+click or Ctrl+click.
  • CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN=1 restores plain click-to-open but disables the fullscreen TUI; it's undocumented (#56881).
  • Possibly related mouse-reporting issues: #61936 (right-click/selection), #66056 (right-click paste; Shift+right-click bypass).

View original on GitHub ↗

3 Comments

github-actions[bot] · 2 months ago

Found 3 possible duplicate issues:

  1. https://github.com/anthropics/claude-code/issues/58960
  2. https://github.com/anthropics/claude-code/issues/58985
  3. https://github.com/anthropics/claude-code/issues/29901

This issue will be automatically closed as a duplicate in 3 days.

  • If your issue is a duplicate, please close it and 👍 the existing issue instead
  • To prevent auto-closure, add a comment or 👎 this comment

🤖 Generated with Claude Code

rfulwell · 2 months ago

Correction to the original report: the working gesture is Shift+⌘+click, not Shift+click alone. Plain click, ⌘-click, and Shift+click all fail; only Shift+⌘+click opens the URL under Ghostty. Title/body updated accordingly.

rfulwell · 2 months ago

Additional working gesture: Ctrl+click also opens the URL on macOS under Ghostty (notable, since the changelog lists Ctrl+click as the non-macOS variant). So the full picture: plain click / ⌘-click / Shift+click all fail; Shift+⌘+click and Ctrl+click both work. Body updated.

Showing cached comments. Read the full discussion on GitHub ↗