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, codebuddy, opencode, openclaw, hermes, kiro-cli, qodercli, or traecli)
At least one workspace is being watched

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

Claude Code (claude)
Antigravity (agy)
CodeBuddy (codebuddy)
Codex (codex)
Copilot (copilot)
Cursor Agent (cursor-agent)
OpenCode (opencode)
OpenClaw (openclaw)
Hermes (hermes)
Kimi (kimi)
Kiro CLI (kiro-cli)
Pi (pi)
Qoder (qodercli)
Trae CLI (traecli)

Then restart the daemon:

multica daemon stop && multica daemon start