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

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