Support and release stages

Menus and install pages label each product with a badge. This page says what the badges mean.

Concept and alpha

Concept is a support scope. The MCP servers and workspace builders for every language except Python are maintained examples of using libtmux in a real application. They carry no support or compatibility commitment, and their APIs, MCP tools, command output and workspace configuration can change. Pin an example and the core library together when you adapt one.

Alpha is a release stage. Publishing a package or adding commands does not change an example's concept scope, so an alpha core library can have concept examples beside it.

Release stages

A badge shows the stage that the package's registry declares, or the stage of the newest version the registry lists: pre-alpha, alpha, beta, rc or stable. When the registry lists no release at all, the badge shows the stage of the repository's newest release tag instead, and a tag that is exactly MAJOR.MINOR.PATCH, with an optional leading v or package label, such as v0.1.0, reads stable. A tag newer than the registry's newest version does not count: a registry that lists only 0.1.0-alpha.2 shows alpha even after the repository tags v0.1.0. A package with no release and no release tag shows unreleased. A language without an implementation has no badge.

Python's tmuxp workspace loader and Python MCP server show the stage their PyPI projects declare instead of concept.

Use an example

Open the MCP or Workspace Manager entry for your language. Its install page names the package or source build, the runtime it needs and the tmux endpoint it talks to.

An MCP tool can send shell input, and a workspace file can configure shell commands. Keep tmux access local or behind access controls you own. A concept badge adds no authentication, authorization or isolation. If you run an example in production, you own its configuration compatibility, upgrades, access controls and monitoring.

Report a failure

An example has to work at its documented revision. Load a workspace and inspect the session, or connect an MCP client and call a tool, against a separate tmux server so your own sessions stay untouched. A page that renders or a package that installs does not show that the example works.

Report the revision, the tmux version, the smallest input that fails and the error you saw. If the failure comes from the core library, reduce it to a core API call: an example's concept scope does not excuse a broken core contract.