# Installation

Source: https://libtmux.org/en/julia/latest/guides/installation/

> Installation: LibTmux documentation.

`v0.1.0-alpha.1` is an unregistered source release. Install it from the
public Git tag in the Julia project that will use it. `Manifest.toml` records
the requested revision and package tree hashes.

## Core

From the consumer project directory:

```console
$ julia \
    --startup-file=no \
    -e 'using Pkg; Pkg.activate("."); Pkg.add(Pkg.PackageSpec(url="https://github.com/libtmux/libtmux-julia.git", rev="v0.1.0-alpha.1"))'
```

Have [`tmux`](<https://libtmux.org/en/julia/latest/reference/libtmux-server-tmux/>) on `PATH`. Julia 1.10+ and tmux 3.2a+ are the compatibility
targets; [Compatibility](https://libtmux.org/en/julia/latest/guides/compatibility/) records the exact tested cells.

## MCP application

Add the core and MCP adapter together. Both specifications name the same tag:

```console
$ julia \
    --startup-file=no \
    -e 'using Pkg; Pkg.activate("."); repo="https://github.com/libtmux/libtmux-julia.git"; tag="v0.1.0-alpha.1"; Pkg.add([Pkg.PackageSpec(url=repo, rev=tag), Pkg.PackageSpec(url=repo, rev=tag, subdir="packages/LibTmuxMCP")])'
```

Install the local launcher after resolution:

```console
$ julia \
    --startup-file=no \
    --project=. \
    -e 'using LibTmuxMCP; println(install_cli("bin"))'
```

```console
$ bin/libtmux-mcp --help
```

[Connect an MCP client](https://libtmux.org/en/julia/latest/mcp/source-guide/) explains targets, policy and the explicit
socket selector.

## Workspace loader

Add the core and workspace adapter together:

```console
$ julia \
    --startup-file=no \
    -e 'using Pkg; Pkg.activate("."); repo="https://github.com/libtmux/libtmux-julia.git"; tag="v0.1.0-alpha.1"; Pkg.add([Pkg.PackageSpec(url=repo, rev=tag), Pkg.PackageSpec(url=repo, rev=tag, subdir="packages/LibTmuxWorkspace")])'
```

Install the local launcher after resolution:

```console
$ julia \
    --startup-file=no \
    --project=. \
    -e 'using LibTmuxWorkspace; println(install_cli("bin"))'
```

```console
$ bin/libtmux-workspace --help
```

[Load a workspace](https://libtmux.org/en/julia/latest/workspace/source-guide/) describes validation, planning, loading and
freezing.

The alpha is not in the General registry. Registry registration is a later
maintainer action.