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

Source: https://libtmux.org/en/lisp/latest/workspace/

> Validate, plan, and explicitly apply bounded JSON workspaces with the native Common Lisp engine.

**Workspace Manager concept example** A working example of the core library. It can change without notice. Build `mise` from the source revision in the installation guide. Follow the workspace guide for its configuration format.

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`:

```console
$ 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](https://libtmux.org/en/lisp/latest/workspace/source-guide/) for the file
format, validation limits, planning output, apply behavior, and exit status.
Use the [core guides](https://libtmux.org/en/lisp/latest/guides/) for snapshot ownership, explicit operations,
and private tmux fixtures.
