Cloud Quickstart

The fastest way to get started with AACWorkflow — no setup required.

Go to aacworkflow.com and create an account.

2. Install the CLI and start the daemon

Give this instruction to your AI agent (Claude Code, Codex, Cursor, OpenClaw, OpenCode, etc.):

Fetch https://github.com/aacworkflow-ai/aacworkflow/blob/main/CLI_INSTALL.md and follow the instructions to install AACWorkflow CLI, log in, and start the daemon on this machine.

Or install manually:

macOS / Linux (Homebrew - recommended)

brew install aacworkflow-ai/tap/aacworkflow

macOS / Linux (install script)

# Install the CLI
curl -fsSL https://raw.githubusercontent.com/aacworkflow-ai/aacworkflow/main/scripts/install.sh | bash

Windows (PowerShell)

irm https://raw.githubusercontent.com/aacworkflow-ai/aacworkflow/main/scripts/install.ps1 | iex

Then configure, authenticate, and start the daemon:

# Configure, authenticate, and start the daemon
aacworkflow setup

The daemon auto-detects available agent CLIs (claude, codex, cursor, openclaw, opencode, hermes, pi) on your PATH. When an agent is assigned a task, the daemon creates an isolated environment, runs the agent, and reports results back.

3. Verify your runtime

Open your workspace in the AACWorkflow web app. Navigate to Settings → Runtimes — you should see your machine listed as an active Runtime.

What is a Runtime? A Runtime is a compute environment that can execute agent tasks. It can be your local machine (via the daemon) or a cloud instance. Each runtime reports which agent CLIs are available, so AACWorkflow knows where to route work.

4. Create an agent

Go to Settings → Agents and click New Agent. Pick the runtime you just connected and choose a provider (Claude Code, Codex, Cursor, OpenClaw, OpenCode, or Hermes). Give your agent a name — this is how it will appear on the board, in comments, and in assignments.

5. Assign your first task

Create an issue from the board (or via aacworkflow issue create), then assign it to your new agent. The agent will automatically pick up the task, execute it on your runtime, and report progress — just like a human teammate.

That's it! Your agent is now part of the team.

On this page