eduwass/tmux-palette

tmux-palette is a command palette for tmux, the terminal multiplexer that lets you split your terminal into multiple panes and manage sessions. Think of it like a Spotlight or Raycast-style search bar, but for tmux actions: you press a keyboard shortcut, a popup appears, you type a few letters to filter commands, and hit enter to execute. This replaces the need to remember tmux keyboard shortcuts for common tasks like splitting panes, switching windows, or detaching sessions. Beyond built-in tmux commands, it lets you define your own custom palettes as simple JSON files. These custom commands can open tools like system monitors or code viewers in a floating popup, or run any shell command and display its output as a list of options to pick from. For example, you could create a palette that lists your open pull requests and opens the selected one in a browser, all from within your terminal session. A built-in theme picker lets you change tmux's color scheme with live preview, and includes twelve curated themes. You would use this if you spend a lot of time in the terminal and find yourself frequently running tmux commands, wanting a faster and more discoverable way to navigate your terminal sessions. The project notes it is currently in beta and stable for daily use, but the feature set is still settling. It is written in TypeScript and runs on the Bun JavaScript runtime with no other runtime dependencies. Installation can be done manually by cloning the repository, through the Tmux Plugin Manager, or with a guided setup flow where you paste a prepared prompt into an AI coding agent to walk through installing the tool, binding a key, and picking a theme. The codebase is intentionally kept small, at roughly two thousand lines, which the README says makes it easy to audit, fork, or patch. Example custom palettes are included in the repository so users can copy ready-made configurations instead of writing their own from scratch.