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:
# 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 --downloadHow 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:
mm --presets
mm -o presetsApplying 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:
mm -o rg
mm -o git/status
mm -o unicodeMultiple -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:
mm -o git/status -o patches/git-status
mm -o rg -o patches/frizbeeLaunching 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:
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:
mm -o git/restore -- src/
mm -o dict/en -- serendipity
mm -o bat_theme -- Cargo.tomlTrailing 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:
| Key | Action | Output |
|---|---|---|
F1 | @help | Fullscreen preset README.md (or leading # comment block) and resolved keymap in the pager |
alt-h | Help | Resolved 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 asps, which switches between processes and open network sockets),@nextand@prevcycle through those commands viaReloadNextandReloadPrev. - When a folder contains a ring of related pickers (such as
gitorzellij),@nextand@prevtransition between sibling presets in place viaBecomeSilent.
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):
| Folder | Purpose |
|---|---|
ai | Pi session resumer (pi_sessions), extension manager (pi_extensions), and llm model inspector |
dict | Offline Wiktionary English dictionary (dict/en) with definitions, inflections, and etymologies |
docker | Container, Compose project, image, volume, and network management for Docker and Podman |
experimental | Desktop controls for BlueZ Bluetooth, Niri windows/workspaces, MPRIS players, and PipeWire audio |
git | Staging (status), restoration (restore), branch/tag switching (switch), diff search (grep), and commits (browse) |
kube | Kubernetes pod inspector (kube/pods) with live log streaming and interactive shell exec |
linux | XDG .desktop settings panel finder and launcher (linux/prefpanes) |
macos | macOS System Settings launcher (prefpanes) and launchctl service controller (services) |
misc | Model, LoRA, and embedding switcher for Tabby LLM servers (misc/tabby-select) |
mutagen | Mutagen sync session monitor and interactive conflict resolver |
obsidian | Obsidian vault switcher (vaults) and inbox note browser (inboxnotes) |
packages | Package browser, dependency inspector, and installer/remover for pacman, apt, and dnf |
ps | Process and socket table (ps and lsof) with process tree, top, and signal actions |
pw | Password, username, and TOTP copier for Bitwarden (rbw), 1Password (op), and Proton Pass (pass-cli) |
ssh | SSH host connector, public key manager, known_hosts editor, and Tailscale peer picker |
switcher | Open window switcher for macOS and Linux (X11 / wmctrl) |
themes | Interactive theme previewer and 22 color themes |
unicode | Offline Unicode character and emoji picker searchable by name, LaTeX, HTML entity, or CLDR keyword |
zellij | Zellij 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>:
| File | Purpose |
|---|---|
presets.toml | Interactive picker over installed presets (automatically layers matching patches/<name>.toml files) |
rg.toml | Full-text search toggling live ripgrep queries (ctrl-r) and in-memory fuzzy filtering |
csv.toml | RFC 4180 CSV and TSV viewer with a sticky header row and active-cell preview |
cargo-rx.toml | Rust Cargo.toml example, binary, and compiled target runner |
man.toml | Man page browser (man -k) with batman or man previews |
bat_theme.toml | Interactive bat syntax theme previewer and config updater |
frizbee.toml | Modifier 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.