Core LibraryGuides

Choose documentation 1

latest

Current version

latest
English

Prerelease This site documents an alpha of libtmux. Its structure, URLs and APIs are subject to change.

Query fields

LibTmux.FSharp.Filter creates version-two QueryDocument values. These are the descriptors it exposes. Query.matching is local and materialized; it does not send a native tmux filter.

The fields below are checked against documents generated by the F# descriptors and the optional LibTmux.Query.Json serializer. Parent links, such as a pane’s window, and placement keys remain native captured-object properties. They have no portable descriptor.

Sessions

SessionFields.name

SessionFields.id

SessionFields.attached

SessionFields.windowCount

SessionFields.windows

  • Core property: Session.Windows
  • Wire name: session_windows
  • Value type: Relation<Session, Window>
  • Operators: any, all, none
  • Required depth: Windows
  • Schema version: 2

Windows

WindowFields.name

WindowFields.id

WindowFields.index

WindowFields.width

WindowFields.height

WindowFields.active

WindowFields.zoomed

WindowFields.bellAlert

WindowFields.activityAlert

WindowFields.silenceAlert

WindowFields.layout

WindowFields.flags

WindowFields.paneCount

WindowFields.panes

  • Core property: Window.Panes
  • Wire name: window_panes
  • Value type: Relation<Window, Pane>
  • Operators: any, all, none
  • Required depth: Panes
  • Schema version: 2

Panes

PaneFields.currentCommand

PaneFields.id

PaneFields.index

PaneFields.title

PaneFields.currentPath

PaneFields.width

PaneFields.height

PaneFields.left

PaneFields.top

PaneFields.atTop

PaneFields.atBottom

PaneFields.atLeft

PaneFields.atRight

PaneFields.active

PaneFields.dead

PaneFields.inMode

PaneFields.processId

PaneFields.synchronized

PaneFields.historySize

PaneFields.deadStatus

PaneFields.tty

PaneFields.startCommand

Clients

ClientFields.name

ClientFields.controlMode

Limits

The core wire catalog also reserves client_id. The core client model has no typed client ID, so the F# façade does not invent one. session_windows and window_panes each appear twice: as counts, SessionFields.windowCount and WindowFields.paneCount, and as the relations SessionFields.windows and WindowFields.panes that Filter.any and Filter.all walk.

A tmux format outside this catalog, such as session_created or pane_dead_signal, filters through Query.whereUnsafe, which hands tmux a raw filter such as UnsafeTmuxFilter "#{e|>|:#{session_created},1700000000}". tmux evaluates it and nothing rechecks it, so it has none of the typed fields’ guarantees, and a malformed or unknown token keeps no rows rather than raising.

allOf [] matches everything, and anyOf [], oneOf [] match nothing; notOneOf [] matches everything. Each is a Boolean constant predicate, which serializes and travels like any other document.

Esc

Type to search.