tmcp is a command palette for tmux. It is designed to run inside tmux display-popup -E and make tmux commands faster to discover, complete, and execute.

• Fuzzy command search for tmux commands and aliases
• Positional and flag-value completion for common tmux targets such as sessions, windows, panes, layouts, options, hooks, and key tables
• User-defined tmux command templates loaded from $XDG_CONFIG_HOME/tmcp/config.toml or ~/.config/tmcp/config.toml
• History search backed by a persistent history file at $XDG_STATE_HOME/tmcp/history or ~/.local/state/tmcp/history
• Inline ghost-text previews that show the currently selected completion without committing it into the input
• Popup-friendly candidate navigation with line-by-line and half-page movement

• Enter: execute the typed tmux command
• Tab: accept the currently selected completion
• Right: accept the current ghost-text completion
• Up / Down: move through the candidate list
• Ctrl-P / Ctrl-N: move through the candidate list
• Ctrl-U / Ctrl-D: scroll half a page up or down
• PageUp / PageDown: scroll half a page up or down
• Ctrl-R: toggle history search mode
• Esc / Ctrl-C: close the palette

go install github.com/gh-liu/tmcp@latest

Add this to ~/.tmux.conf:

bind-key C-p display-popup -E -w 80% -h 70% tmcp

Reload tmux config:

tmux source-file ~/.tmux.conf

Create config.toml at $XDG_CONFIG_HOME/tmcp/config.toml or ~/.config/tmcp/config.toml:

[[commands]]
name = "swap-left"
note = "swap current pane with the left pane"
run = ["swap-pane", "-t", "{left}"]

Custom commands are shown alongside built-in tmux commands in the palette. Any extra arguments you type after the custom command name are appended to the configured run array.

TODO: add a screenshot of the popup UI.