Skip to content

Conversation

@garbas
Copy link
Owner

@garbas garbas commented Jan 12, 2026

Summary

  • Enable OSC 8 hyperlink passthrough so Cmd+click on URLs works in Ghostty/iTerm2 inside tmux
  • Add allow-passthrough on setting to tmux config
  • Add test for the new setting

Test plan

  • Pre-commit checks pass (markdownlint, nixfmt)
  • All 35 tmux tests pass including new allow-passthrough test
  • Manual test: Cmd+Shift+click on URLs in tmux works in Ghostty

Enable OSC 8 hyperlink passthrough so Cmd+click on URLs works in
terminals like Ghostty and iTerm2 when running inside tmux.

Changes:
- Add allow-passthrough on setting to tmux config
- Add test for allow-passthrough option
- Fix flaky E2E resurrect test (simplify to just test save works)
- Document how to rebuild and reload config in CLAUDE.md
The allow-passthrough setting alone wasn't enough. tmux needs
terminal-features with hyperlinks enabled to properly handle
OSC 8 sequences.

Key findings:
- terminal-features ",*:hyperlinks" enables OSC 8 support (tmux 3.4+)
- Requires full server restart (tmux kill-server) to take effect
- With mouse mode on, use Cmd+Shift+click (not just Cmd+click)
@garbas garbas enabled auto-merge (rebase) January 12, 2026 12:54
@garbas garbas merged commit e2c07cd into main Jan 12, 2026
3 checks passed
@garbas garbas deleted the tmux-clickable-links branch January 12, 2026 12:57
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants