Skip to content

Using presets ​

A preset bundles a populating command, column-splitting rules, preview layouts, and custom keybindings into a self-contained TUI workflow.

Downloading and listing presets ​

Fetch presets from the upstream repository into ~/.config/matchmaker/presets/ (or your platform's config directory) with mm --download:

shell
# Download a preset collection folder
mm --download git

# Download a single top-level preset file
mm --download rg.toml

# Download all top-level presets
mm --download
How mm --download handles platform files, permissions, and LFS assets

When downloading a folder or file, mm filters platform-prefixed files (linux., macos., unix., win.) to match your operating system and strips the prefix on disk. Helper scripts with a valid #! shebang and compiled helper binaries automatically receive executable permissions on Unix, and Git LFS data files (such as the compressed tables in dict and unicode) are fetched from the media endpoint.

List every installed preset on disk with mm --presets, or launch the interactive preset picker once presets.toml is downloaded:

shell
mm --presets
mm -o presets

Applying and layering presets ​

Pass -o (--override) to layer a preset onto your base config.toml. Relative names without a .toml extension resolve against your presets/ directory (<name>/main.toml, <name>.toml, or the OS-prefixed variant), or you can pass an explicit .toml path:

shell
mm -o rg
mm -o git/status
mm -o unicode

Multiple -o flags are applied in order from left to right, followed by any inline CLI overrides. Layering lets you combine a workflow preset with a patch preset (small partial overrides stored under patches/ that tweak matcher behavior or binds without duplicating the base preset) or a color theme:

shell
mm -o git/status -o patches/git-status
mm -o rg -o patches/frizbee

Launching a preset from mm -o presets also layers a matching patches/<name>.toml over it when one exists.

See Options for how overrides merge.

Shell aliases ​

For workflows you reach for often, wrap preset invocations (including layered patches and -- forwarding) in shell aliases:

shell
alias gl="mm -o git/restore --"
alias gs="mm -o git/status -o patches/git-status"

Passing arguments ​

Arguments placed after -- are forwarded as positional arguments ("$@", "$1", ...) to the preset's start.command and exposed to templates as {$0}, {$1}, and so on:

shell
mm -o git/restore -- src/
mm -o dict/en -- serendipity
mm -o bat_theme -- Cargo.toml

Trailing arguments take effect whenever mm executes start.command (when standard input is a terminal, or when --no-read is passed).

In-picker help and navigation ​

Presets document themselves at runtime through two help actions:

KeyActionOutput
F1@helpFullscreen preset README.md (or leading # comment block) and resolved keymap in the pager
alt-hHelpResolved keymap in the preview pane

Many multi-command and multi-preset workflows also bind @next (alt-]) and @prev (alt-[):

  • When a preset defines start.additional_commands (such as ps, which switches between processes and open network sockets), @next and @prev cycle through those commands via ReloadNext and ReloadPrev.
  • When a folder contains a ring of related pickers (such as git or zellij), @next and @prev transition between sibling presets in place via BecomeSilent.

The git collection below exercises custom workflow actions (staging, committing, restoring), autogenerated keybinding help, and @next / @prev switching across git/restore, git/status, and git/grep:

Preset catalogue ​

Folder collections ​

Download a collection with mm --download <folder> and run pickers with mm -o <folder>/<preset> (or mm -o <folder> when main.toml is present):

FolderPurpose
aiPi session resumer (pi_sessions), extension manager (pi_extensions), and llm model inspector
dictOffline Wiktionary English dictionary (dict/en) with definitions, inflections, and etymologies
dockerContainer, Compose project, image, volume, and network management for Docker and Podman
experimentalDesktop controls for BlueZ Bluetooth, Niri windows/workspaces, MPRIS players, and PipeWire audio
gitStaging (status), restoration (restore), branch/tag switching (switch), diff search (grep), and commits (browse)
kubeKubernetes pod inspector (kube/pods) with live log streaming and interactive shell exec
linuxXDG .desktop settings panel finder and launcher (linux/prefpanes)
macosmacOS System Settings launcher (prefpanes) and launchctl service controller (services)
miscModel, LoRA, and embedding switcher for Tabby LLM servers (misc/tabby-select)
mutagenMutagen sync session monitor and interactive conflict resolver
obsidianObsidian vault switcher (vaults) and inbox note browser (inboxnotes)
packagesPackage browser, dependency inspector, and installer/remover for pacman, apt, and dnf
psProcess and socket table (ps and lsof) with process tree, top, and signal actions
pwPassword, username, and TOTP copier for Bitwarden (rbw), 1Password (op), and Proton Pass (pass-cli)
sshSSH host connector, public key manager, known_hosts editor, and Tailscale peer picker
switcherOpen window switcher for macOS and Linux (X11 / wmctrl)
themesInteractive theme previewer and 22 color themes
unicodeOffline Unicode character and emoji picker searchable by name, LaTeX, HTML entity, or CLDR keyword
zellijZellij session switcher, active/other pane jumper, and layout launcher

Standalone presets ​

Download a single-file preset with mm --download <name>.toml and launch it with mm -o <name>:

FilePurpose
presets.tomlInteractive picker over installed presets (automatically layers matching patches/<name>.toml files)
rg.tomlFull-text search toggling live ripgrep queries (ctrl-r) and in-memory fuzzy filtering
csv.tomlRFC 4180 CSV and TSV viewer with a sticky header row and active-cell preview
cargo-rx.tomlRust Cargo.toml example, binary, and compiled target runner
man.tomlMan page browser (man -k) with batman or man previews
bat_theme.tomlInteractive bat syntax theme previewer and config updater
frizbee.tomlModifier preset switching the matcher backend to typo-tolerant frizbee (max_typos = 1)

Color themes ​

The themes preset collection provides purely UI customizations. You can preview and select themes interactively with mm -o themes, then copy the settings to your config.toml to apply.