Alpha Preview — This software is under active development. Expect rough edges and breaking changes.
Macula
Back

Detailed Guide

macula-cli, macula-mcp, macula-station — install, verify, uninstall.

macula-cli

Linux / macOS: 

curl -fsSL https://raw.githubusercontent.com/macula-io/macula-cli/master/install.sh | bash

Windows (PowerShell):

irm https://raw.githubusercontent.com/macula-io/macula-cli/master/install.ps1 | iex

Verify it works:

macula-cli connect station-de-frankfurt.macula.io

To remove it again:

curl -fsSL https://raw.githubusercontent.com/macula-io/macula-cli/master/uninstall.sh | bash

Leaves your persisted identity alone by default; add --purge to remove that too.

Already have Go 1.27+? go install github.com/macula-io/macula-cli/cmd/macula-cli@latest works too. Full command/flag reference: HOW-TO guide .

macula-mcp

Node 20+. Installs both macula-mcp and the bundled macula-cli it wraps: 

npm install -g --allow-scripts=@macula-io/mcp @macula-io/mcp

Add it to your agent harness's MCP config: 

{
  "mcpServers": {
    "macula": { "command": "macula-mcp" }
  }
}

Works with Claude Code, Cursor, Cline, Continue, and anything else that speaks MCP.

macula-station

Only if you're operating relay infrastructure — not needed to use the mesh yourself. 

docker pull ghcr.io/macula-io/macula-station:latest

A station needs a config file, a certificate derived from its own identity, and a place to persist state: 

docker run --network=host \\\n  -e MACULA_STATION_CONFIG=/etc/macula-station/config.json \\\n  -v ./config.json:/etc/macula-station/config.json:ro \\\n  -v ./certs:/certs:ro \\\n  -v station_data:/var/lib/macula/station \\\n  ghcr.io/macula-io/macula-station:latest
The certificate has to be self-signed from the station's own Ed25519 key — the wrong kind boots fine and then silently fails every connection. Read the Deployment Guide before running this for real — it covers the config schema, the identity bootstrap sequence, docker-compose + watchtower, Podman + Quadlet, and a Kubernetes manifest.

Requirements

macula-cli: Linux / macOS / Windows macula-mcp: Node 20+ macula-station: Docker (or Podman)