Skip to content

Add OSC 8 hyperlink passthrough to tmux#247

Merged
tamakiii merged 1 commit intomainfrom
add/tmux-osc8-hyperlink-passthrough
May 3, 2026
Merged

Add OSC 8 hyperlink passthrough to tmux#247
tamakiii merged 1 commit intomainfrom
add/tmux-osc8-hyperlink-passthrough

Conversation

@tamakiii-doppelganger
Copy link
Copy Markdown
Contributor

Summary

  • Add allow-passthrough on, terminal-features ',*:hyperlinks', and explicit Hls/Hlr overrides to .config/tmux/tmux.conf so Ghostty renders OSC 8 hyperlinks emitted by in-pane processes (Claude Code, statuslines, etc.) as Shift+Cmd+Click-able links.
  • Without these, tmux 3.5a + Ghostty 1.3.1 silently drops OSC 8 from in-pane processes even though raw printf in the same pane renders fine. Initially looked like an upstream Claude Code TUI bug (anthropics/claude-code#23438, #27047) — turned out to be config-side.

Test plan

  • tmux kill-server (or detach + reattach in a fresh Ghostty window) to pick up new client-side capability detection.
  • Run printf '\e]8;;https://example.com\e\\link\e]8;;\e\\\n' in a tmux pane → link is clickable with Shift+Cmd+Click.
  • Open Claude Code in a tmux pane; markdown links in its output are clickable with Shift+Cmd+Click.

Related to tamakiii/meta#773

🤖 Generated with Claude Code

Enables Ghostty to render OSC 8 hyperlinks emitted by in-pane processes
(Claude Code, statuslines, etc.) as Shift+Cmd+Click-able links.

Without these settings, tmux 3.5a + Ghostty 1.3.1 silently drops OSC 8
sequences from in-pane processes, even though raw printf in the same pane
renders fine. The fix is three lines: allow-passthrough on, advertise
hyperlink capability, and explicit Hls/Hlr terminfo overrides.

Verified by: detach + reattach (or kill-server), then
  printf '\e]8;;https://example.com\e\\link\e]8;;\e\\\n'
is clickable with Shift+Cmd+Click. Claude Code's emitted hyperlinks
likewise become clickable.

Related to tamakiii/meta#773

Co-Authored-By: Claude <noreply@anthropic.com>
@tamakiii-doppelganger tamakiii-doppelganger Bot requested a review from tamakiii May 3, 2026 03:40
@tamakiii tamakiii merged commit 0941efe into main May 3, 2026
1 check passed
@tamakiii tamakiii deleted the add/tmux-osc8-hyperlink-passthrough branch May 3, 2026 03:48
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

enhancement tamakiii/dotfiles From tamakiii/dotfiles

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants