Search workspaces

github.com/libtmux/libtmux-go/workspace · Source

Search the fields of discovered workspace documents. Use literal matching when the input should be treated as text rather than a regular expression.

Find a session name¶

$ tmux-workspace search \
    --json \
    --fixed-strings \
    --field session \
    workspace

Repeat --field to restrict additional fields. Query terms combine with AND; --any selects OR. --ignore-case, --smart-case, --word-regexp, and --invert-match control matching. Inspect the installed search --help for supported field names and aliases.

Regular expressions¶

The default engine uses Go regular expressions and ASCII word boundaries. Structured pane commands are searched as JSON text. Unsupported regex syntax fails; it does not start another runtime automatically.

--regex-engine python explicitly enables lookaround, backreferences and Unicode word boundaries through an installed Python 3.10 or newer interpreter. Ordinary searches do not need that optional runtime.

Check both the exit status and machine result. An empty successful search and a failed pattern are different outcomes.

CLI source.