A fast Zig utility that scans your tmux pane for URLs and file paths, displays them with keyboard hints, and lets you quickly open or paste selections.
- Scans tmux pane content for URLs (
http://,https://) and file paths (/,~/) - Displays matches in a popup with single-key hints (home-row keys first for ergonomics)
- Opens URLs in your default browser
- Pastes file paths directly into your pane
- Deduplicates matches automatically
- Supports up to 26 matches per scan
- Zig 0.15 or later
- tmux
git clone https://github.com/michelboaventura/tmux-hints.git
cd tmux-hints
zig build -Doptimize=ReleaseFastThe binary will be at zig-out/bin/tmux_hints.
Run inside a tmux session:
tmux_hintsA popup will appear showing all detected URLs and paths with hint characters. Press the corresponding key to:
- URLs: Open in your default browser
- Paths: Paste the path into the current pane
Press q or Esc to cancel.
Add to your ~/.tmux.conf:
bind-key f run-shell "/path/to/tmux_hints"Then press prefix + f to invoke tmux-hints.
zig build # Build (output: zig-out/bin/tmux_hints)
zig build run # Build and run
zig build test # Run tests- Captures the last 100 lines from your current tmux pane
- Scans for URLs and file paths using pattern matching
- Assigns hint characters (a-z, home-row first)
- Shows a tmux popup with the matches
- On selection, opens URLs with your system opener or pastes paths to the pane
MIT