API Reference

This is the internal Python API — the modules tmuxp’s CLI is built from, documented for contributors and plugin authors. Everyday use goes through the CLI; to drive tmux from Python directly, reach for libtmux instead.

See also

See libtmux’s API and Quickstart to see how you can control tmux via python API calls.

Workspace

Finding, loading, building, and freezing sessions.

Workspace
CLI modules

The argparse commands behind each subcommand.

CLI
Plugin API

The TmuxpPlugin base class and its hooks.

Plugin - tmuxp.plugin
Internal helpers

Config reader, colors, and private path helpers.

Internal Modules
Exceptions

The TmuxpException hierarchy.

Exceptions - tmuxp.exc
Logging

Loggers and user-facing echo helpers.

Logging - tmuxp.log
Shell

Internals of the interactive shell launcher.

Shell - tmuxp.shell
Utilities

Assorted helpers used across tmuxp.

Utilities - tmuxp.util
Types

Shared type definitions.

Typings - tmuxp.types