CLI Installation

Installation

Homebrew (macOS/Linux)

brew install multica-ai/tap/multica

Build from Source

git clone https://github.com/multica-ai/multica.git
cd multica
make build
cp server/bin/multica /usr/local/bin/multica

Download from GitHub Releases

If Homebrew is not available, download the binary directly:

OS=$(uname -s | tr '[:upper:]' '[:lower:]')   # "darwin" or "linux"
ARCH=$(uname -m)                                # "x86_64" or "arm64"

# Normalize architecture name
if [ "$ARCH" = "x86_64" ]; then
  ARCH="amd64"
fi

# Get the latest release tag from GitHub
LATEST=$(curl -sI https://github.com/multica-ai/multica/releases/latest \
  | grep -i '^location:' | sed 's/.*tag\///' | tr -d '\r\n')

# Download and extract
curl -sL "https://github.com/multica-ai/multica/releases/download/${LATEST}/multica_${OS}_${ARCH}.tar.gz" \
  -o /tmp/multica.tar.gz
tar -xzf /tmp/multica.tar.gz -C /tmp multica
sudo mv /tmp/multica /usr/local/bin/multica
rm /tmp/multica.tar.gz

Update

brew upgrade multica-ai/tap/multica

For install script or manual installs, use:

multica update

multica update auto-detects your installation method and upgrades accordingly.

Quick Start

# One command: configure, authenticate, and start the daemon
multica setup

This configures the CLI for Multica Cloud, opens your browser for login, discovers your workspaces, and starts the agent daemon.

For self-hosted servers, use multica setup self-host instead. See Self-Hosting for details.

Verify

multica daemon status

Confirm:

Status is running
At least one agent is listed (e.g. claude, codex, gemini, opencode, openclaw, hermes, or pi)
At least one workspace is being watched

If the agents list is empty, install at least one supported AI agent CLI:

Claude Code (claude)
Codex (codex)
Gemini CLI (gemini)
OpenCode (opencode)
OpenClaw (openclaw)
Hermes (hermes)

Then restart the daemon:

multica daemon stop && multica daemon start