tmuxp search

Search workspace files by name, session, path, window, or pane content.

Field-scoped search:

tmuxp search window:editor tmuxp search pane:vim tmuxp search p:~/.tmuxp

Matching options:

tmuxp search -i DEV tmuxp search -S DevProject tmuxp search -F ‘my.project’ tmuxp search –word-regexp test

Multiple patterns:

tmuxp search dev production tmuxp search –any dev production tmuxp search -v staging

usage: tmuxp search [-h] [-f FIELD] [-i] [-S] [-F] [-w] [-v] [--any] [--json]
                    [--ndjson]
                    [PATTERN ...]

Examples

$ tmuxp search dev

$ tmuxp search "my.*project"

$ tmuxp search name:dev

$ tmuxp search s:development

Machine-Readable Output

$ tmuxp search --json dev

$ tmuxp search --ndjson dev | jq '.name'

Positional Arguments

PATTERN

search patterns (prefix with field: for field-scoped search)

Named Arguments

-f, --field

restrict search to field(s): name, session/s, path/p, window/w, pane

-i, --ignore-case

case-insensitive matching

Default: False

-S, --smart-case

case-insensitive unless pattern has uppercase

Default: False

-F, --fixed-strings

treat patterns as literal strings, not regex

Default: False

-w, --word-regexp

match whole words only

Default: False

-v, --invert-match

show workspaces that do NOT match

Default: False

--any

match ANY pattern (OR logic); default is ALL (AND logic)

Default: False

--json

output as JSON

Default: False

--ndjson

output as NDJSON (one JSON per line)

Default: False