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

Resolved 💬 3 comments Opened Jun 18, 2026 by rfulwell 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 ↗

This issue has 3 comments on GitHub. Read the full discussion on GitHub ↗