Pane / Session / Workspace Navigation

[Smithx10]

In tmux I frequently use:

'tmux display-panes' Which will number each pane so you can select it quickly and not have to cycle through them. Would be nice to have an option to select which keys are used for the quick switching. Numbers are useful but sometimes its easier to use letters closer to the home row.

'tmux choose-tree' Which will list out a tree with a preview window and available hotkeys for navigating to those session / workspace / pane. The tree is a nice way to navigate especially with the preview.

I've used this plugin in some cases when I have a lot of sessions / workspaces / panes to find a pane. While doing work on lots of servers you can sometimes be blocked and will come back to that work later. Often I forget to label so fzf'ing to find pane is useful.
https://github.com/Kristijan/fzf-pane-switch.tmux

Demo:
https://asciinema.org/a/5LYycJ0Z1jrb4Srf *old ascii video was broken.

[Gaurav-Gosain]

Thanks, these are both good. What tuios has today: select_window_1 to 9 for the panes on screen, switch_session_1 to 9 (just landed), and the session and workspace switchers (prefix S and prefix w). None of them does what you describe, so I am building both:

• Pane labels (like display-panes): a big label on every pane, press its key to jump. The keys are configurable, so you can use home-row letters, and with many panes the labels become two keys.
• A tree navigator (like choose-tree with fzf-pane-switch): sessions, workspaces and panes in one tree, including panes on your other machines, with a preview of the highlighted pane. Typing searches names, titles, folders, the running command and the text on each pane's screen, so you can find that server you forgot to label. Enter jumps there.

Both will also be reachable from the CLI with JSON output. I will post here when they are on main.

[Gaurav-Gosain]

Thanks for the detailed request. Both features are now on main.

Pane labels. Press Ctrl+B then Q. Each pane gets a large label, and typing it focuses that pane. The labels are digits by default, in the same order as select_window_1 to 9. For home-row letters, add this to config.toml:

[panes]
label_keys = "asdfghjkl"

With more panes than keys, labels take two keys. It also works when a pane is zoomed (the hidden panes are listed under the label) and with multifocus.

Pane navigator. Press Ctrl+B then /. You get a tree of sessions, workspaces and panes, including the machines in [hosts], with a preview of the highlighted pane. j/k move, h/l fold, and Enter goes to the session, workspace and pane. Press / to search by name, title, folder, running command, or the last 40 lines on each pane's screen, so you can find the server you forgot to label by what it printed.

For scripts, tuios list-windows --all --json prints the same rows. Add --all-hosts for your other machines and --text 20 for the last 20 lines of each screen.

Not built yet: renaming, closing and moving panes from inside the navigator. Docs: https://tuios.dev/docs/find-a-pane

Let us know how they work for you.

[Smithx10]

This is great!

Excellent!

[Gaurav-Gosain]

working on the ui for the Pane navigator a bit