CLI Installation

Installation

Homebrew (macOS/Linux)

brew install aacworkflow-ai/tap/aacworkflow

Build from Source

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

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/aacworkflow-ai/aacworkflow/releases/latest \
  | grep -i '^location:' | sed 's/.*tag\///' | tr -d '\r\n')

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

Update

brew upgrade aacworkflow-ai/tap/aacworkflow

For install script or manual installs, use:

aacworkflow update

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

Quick Start

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

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

Verify

aacworkflow daemon status

Confirm:

Status is running
At least one agent is listed (e.g. claude, codex, opencode, openclaw, hermes, kiro, 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)
OpenCode (opencode)
OpenClaw (openclaw)
Hermes (hermes)
Kimi (kimi)
Kiro CLI (kiro-cli)
Pi (pi)
Cursor Agent (cursor-agent)
Copilot (copilot)
CodeBuddy (codebuddy)
Antigravity (agy)
Qoder (qodercli)
Trae (traecli)

Then restart the daemon:

aacworkflow daemon stop && aacworkflow daemon start