tmux Cheat Sheet (Alfred Workflow)

Quickly look up tmux commands, key bindings, and practical examples directly from Alfred.

Install

1. Build the workflow:

   bash build/build_workflow.sh
   

2. Open dist/tmux-command-search.alfredworkflow — Alfred imports it automatically.

Usage

1. Open Alfred and type tmux followed by your query.
2. Results are ranked by how commonly they are needed.
3. Press Enter to copy the result to clipboard.
4. Press Cmd+L for a large type view.

Examples

Query	Finds
tmux new session name	tmux new -s mysession
tmux split	Key bindings (Ctrl+b %, Ctrl+b ") and commands
tmux attach	All ways to attach to a session
tmux copy	Copy mode shortcuts and buffer commands
tmux mouse	tmux set -g mouse on

Configuration

Open Alfred → Workflows → tmux Cheat Sheet → Configure Workflow to change the prefix key (default: Ctrl+b).

Data Sources

• Key bindings are parsed from your local man tmux (always matches your installed version).
• Practical examples are curated in data/examples.tsv — add your own by appending a line: command-name\tdescription\ttmux command.
• Tier ordering controls result priority in data/tiers.tsv (1 = essential, 4 = rare).

To regenerate the cheat sheet after a tmux update:

bash scripts/parse_manual.sh
bash build/build_workflow.sh

Development

Run tests:

bash tests/test_tmux_search.sh

Project Structure

data/
  examples.tsv        Curated practical examples
  tiers.tsv           Usage frequency ranking (1–4)
  tmux_commands.tsv   Generated cheat sheet (do not edit)
scripts/
  parse_manual.sh     Parses man page + examples into tmux_commands.tsv
  tmux_search.sh      Alfred script filter (awk-based, <15 ms)
build/
  build_workflow.sh   Packages .alfredworkflow
tests/
  test_tmux_search.sh Basic search tests
icon.png              Workflow icon
info.plist            Alfred workflow definition