Recipes

Minimal Ctrl-R

[ui]
history_columns = []
preview = false

[keys]
accept = "enter"
quit = ["esc", "ctrl-c"]

Power-user metadata

[ui.columns]
date = true
pwd = true
exit = true
duration = true
order = ["date", "pwd", "duration", "exit"]

[ui.column.pwd]
width = 34
truncation = "start"
priority = 20

Project-focused search

[pwd]
mode = "subdirs"

[keys]
git_root = "ctrl-r"
pwd = "ctrl-p"
global = "ctrl-g"

Nested inspection

[ui.menus.actions]
[[ui.menus.actions.items]]
label = "Inspect →"
action = "menu:inspect"

[ui.menus.inspect]
[[ui.menus.inspect.items]]
label = "Location"
action = "window:location"
[[ui.menus.inspect.items]]
label = "Timeline"
action = "window:timeline"

Safe command decoration

[ui.wraps.stderr]
template = "{command} 2>&1"

[ui.wraps.pipe]
template = "{command} | tee -a {query}"

These wrappers produce text for shell insertion. Keep execution outside cmdscope so the picker remains a selection/composition layer rather than an executor.