Installation

You can run MUTX as local binaries or as containers.

Components

• mutx: interactive terminal application; this is the authority process
• mutx-link: MCP server + CLI; this is the agent-facing process

In normal use, you run both.

Binary install

MUTX

Linux x86_64:

curl -LO https://download.mutx.net/mutx/latest/mutx-linux-x86_64
chmod +x mutx-linux-x86_64
sudo mv mutx-linux-x86_64 /usr/local/bin/mutx

macOS Intel:

curl -LO https://download.mutx.net/mutx/latest/mutx-macos-intel
chmod +x mutx-macos-intel
sudo mv mutx-macos-intel /usr/local/bin/mutx

macOS Apple Silicon:

curl -LO https://download.mutx.net/mutx/latest/mutx-macos-arm
chmod +x mutx-macos-arm
sudo mv mutx-macos-arm /usr/local/bin/mutx

Link (MCP server + CLI)

Linux x86_64:

curl -LO https://download.mutx.net/link/latest/mutx-link-linux-x86_64
chmod +x mutx-link-linux-x86_64
sudo mv mutx-link-linux-x86_64 /usr/local/bin/mutx-link

macOS Intel:

curl -LO https://download.mutx.net/link/latest/mutx-link-macos-intel
chmod +x mutx-link-macos-intel
sudo mv mutx-link-macos-intel /usr/local/bin/mutx-link

macOS Apple Silicon:

curl -LO https://download.mutx.net/link/latest/mutx-link-macos-arm
chmod +x mutx-link-macos-arm
sudo mv mutx-link-macos-arm /usr/local/bin/mutx-link

Verify

mutx --version
mutx-link --version

Container images

Published images:

• ghcr.io/mutx-net/mutx:latest
• ghcr.io/mutx-net/mutx-link:latest

Run MUTX interactively:

docker run --rm -it \
  -v "$HOME/.config/mutx:/home/mutx/.config/mutx" \
  -v "$HOME/.local/share/mutx:/home/mutx/.local/share/mutx" \
  -v /tmp/mutx:/tmp/mutx \
  ghcr.io/mutx-net/mutx:latest

Run Link in HTTP mode:

docker run --rm \
  -p 8000:8000 \
  -v /tmp/mutx:/tmp/mutx \
  ghcr.io/mutx-net/mutx-link:latest

The shared /tmp/mutx mount is mandatory. Without it, the Link container cannot reach the MUTX socket and the two processes will not communicate.

Common deployment shapes

Host MUTX plus containerized Link:

mutx

docker run --rm \
  -p 8000:8000 \
  -v /tmp/mutx:/tmp/mutx \
  ghcr.io/mutx-net/mutx-link:latest

Containerized MUTX plus containerized Link:

docker run --rm -it \
  -v "$HOME/.config/mutx:/home/mutx/.config/mutx" \
  -v "$HOME/.local/share/mutx:/home/mutx/.local/share/mutx" \
  -v /tmp/mutx:/tmp/mutx \
  ghcr.io/mutx-net/mutx:latest

docker run --rm \
  -p 8000:8000 \
  -v /tmp/mutx:/tmp/mutx \
  ghcr.io/mutx-net/mutx-link:latest

Quick binary start

If you want the shortest local path, run the binaries directly:

mutx
mutx-link

Requirements

• A terminal with TTY support for mutx
• MUTX must be running before mutx-link
• Solana RPC access for wallet and swap operations

Continue to Quick Start.