Configuration

Configuration

Config file: ~/.config/tmux-quickselect/config.toml

On macOS, the app checks ~/.config/ (XDG) first, then ~/Library/Application Support/ (platform dir).

Full Example

sort = "label"
command = "nvim"
show_hidden = true
cache_dir = "~/.cache/tmux-quickselect"

[ui]
title = "Quick Select"
icon = "📂"
width = 25

[[directories]]
path = "~/Git/personal"
label = "jh"
color = "cyan"

[[directories]]
path = "~/Git/work"
label = "work"
color = "magenta"

Options Reference

Option	Type	Default	Description
sort	string or array	"recent"	Sort order: "recent", "alphabetical", "label", or ["label", "recent"]
command	string	""	Command to run in new tmux window after selection
show_hidden	bool	false	Show directories starting with .
cache_dir	string	"~/.cache/tmux-quickselect"	History storage location
ui.title	string	"Quick Select"	Header title
ui.icon	string	"📂"	Header icon
ui.width	int	25	Column width for directory names

Directory Entries

Each [[directories]] block defines a scan root:

Field	Required	Description
path	yes	Directory to scan (subdirectories become selectable)
label	yes	Short label shown in the list
color	yes	One of: cyan, magenta, green, yellow, blue, red, white

Migration from Nushell

If you have an old config.nuon, the app will print a migration hint. Convert manually to TOML format — the fields map 1:1.