Workspace ManagerconceptHome

Choose documentation 2

latest

Current version

latest
English

Unreleased libtmux has not been released. Its API may change during development. This site's structure and URLs may change too.

Edit this page on GitHub

tmux workspace manager, built in Common Lisp, is source-only

Install

Install the workspace package separately from the core library.

$ git clone https://github.com/libtmux/libtmux-lisp.git
cd libtmux-lisp
mise trust
mise install
mise run setup

Loads the workspace ASDF systems and command from the same locked source checkout as the core library.

The Common Lisp workspace manager is implemented and tested from the same source checkout as the core library. It is not published as a separate system or executable. Build the pinned toolchain and run it through mise:

Terminal window
$ mise exec -- tools/lisp.sh tools/workspace-cli.lisp -h

The command validates a bounded JSON document before it contacts tmux. Planning is local. Applying a plan uses the native client and returns a JSON summary. An application failure reports the retained step outcomes and dispatch status; it does not claim transactional rollback.

Read the source installation and command guide for the file format, validation limits, planning output, apply behavior, and exit status. Use the core guides for snapshot ownership, explicit operations, and private tmux fixtures.

Esc

Type to search.

Reference previewOpen reference