Skip to content

Reference ​

Exact, complete descriptions of every command, option, protocol and API. The reference says what each thing is. For how to use it, with steps and examples, see the Guide.

The command-line pages and the socket and plugin protocols are built from the repository's docs/ each time the site is built, so they always match the code on main. The C ABI and Node.js pages are checked against the build's list of public symbols (api/*.txt).

Command line ​

PageWhat it covers
CommandsEvery command and option, grouped as sessions, sending keys, reading the screen, waiting and searching, buffers, viewing, environment, server, plugins and diagnostics.
Keys, formats and exit codesKey names for send-keys, format variables for -F and display-message, and exit codes.
Environment variablesEvery variable zeropty reads, with its default.
tmux compatibilityWhat zeropty does and does not do compared with tmux.

From programs ​

PageWhat it covers
Socket protocolThe JSON lines on the server's socket, and moving sessions between servers.
C ABIEvery function, type and macro of libzeropty_c.dylib and zeropty.h.
Node.js APIEvery export of client/zeropty.mjs, client/embedded.mjs and zeropty.node.
Rust APIThe Rust crate: the engine in your process, the server-plugin variant, plugins in Rust, and how to build the rustdoc.
Plugin APIAccess rules, the plugin socket protocol, events, commands and the Rust API of zeropty::plugin.

Elsewhere ​

WhereWhat
GuideConcepts and task guides.
BenchmarksEvery measurement and how it was taken.
ChangelogChanges, release by release.
llms.txt, llms-full.txtThis site as plain text, for tools.
zeropty --help, zeropty help COMMANDThe same command reference, offline.

Released under the MIT or Apache-2.0 license.