tmux-grip

A tmux plugin inspired by harpoon.nvim that pins sessions into numbered slots for key-based jumps and fast cycling via a lightweight simple popup.

Quick Start

• prefix + G: add current session to grip
• prefix + g: open the grip viewer
• Optional direct slot keys: prefix + y/u/i/o

Install (TPM)

In your tmux.conf

set -g @plugin 'tmux-plugins/tpm'
set -g @plugin 'leohenon/tmux-grip'

run '~/.tmux/plugins/tpm/tpm'

Reload tmux and press prefix + I to install plugins.

Install (Manual)

git clone https://github.com/leohenon/tmux-grip ~/.tmux/plugins/tmux-grip

Add to your tmux.conf:

run-shell ~/.tmux/plugins/tmux-grip/tmux-grip.tmux

Reload with tmux source-file ~/.tmux.conf.

Viewer controls

• 1..9: jump directly to slot
• Configured direct slot keys
• j / k: move selection down/up
• Tab: toggle between session list and panes for the selected session
• J / K: reorder selected session
• x: remove selected session
• X: clear all sessions
• Enter: jump to selected session
• Esc: close

Options

set -g @tmux_grip_max_slots 4
set -g @tmux_grip_bind_open 'g'
set -g @tmux_grip_bind_add 'G'
set -g @tmux_grip_enable_slot_binds 'on'
set -g @tmux_grip_show_popup_slot_labels 'on'

# Direct jump keys
set -g @tmux_grip_bind_slot_1 'y'
set -g @tmux_grip_bind_slot_2 'u'
set -g @tmux_grip_bind_slot_3 'i'
set -g @tmux_grip_bind_slot_4 'o'

Requirements

• tmux 3.2+

License

MIT