tmuxp search

Search for workspace configurations by name or content across your tmuxp directories.

Command

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

Usage

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

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

Machine-Readable Output Examples

$ tmuxp search --json dev

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

Positional Arguments

query_terms PATTERN

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

Default

None

Options

-f, --field FIELD

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

Default

None

-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