Architecture

A server handle selects a tmux server. Object IDs select sessions, windows, and panes within it. For the object hierarchy and stable IDs, start with Server, session, window, pane.

Calling operations¶

Session, window, and pane handles carry their ID and server context. Call an operation on the object you want to change. The examples below send input and kill that pane.

pane->send_text("echo hi");
pane->kill();

Reading tmux fields¶

Object IDs become tmux targets (-t). Format variables (#{...}) provide the state returned by tmux.

Handles capture a fixed set of non-optional fields. Use mpane->expand("#{...}") for tokens outside those fields. Format-token fields covers their interpretation.

Source layout¶

include/libtmux/entities.hpp declares CSession, CWindow, and CPane. Their method bodies live in src/. include/libtmux/server.hpp, include/libtmux/options.hpp, and include/libtmux/capabilities.hpp define server operations, options, and capability checks.

The include/libtmux/testing/ component is separate from the library; Context managers explains its test-server ownership.