Quickstart

Once you have the CLI installed (or signed up for AACWorkflow Cloud), follow these steps to assign your first task to an agent.

1. Set up and start the daemon

aacworkflow setup           # Configure, authenticate, and start the daemon

This configures the CLI, opens your browser for login, discovers your workspaces, and starts the agent daemon in the background. It auto-detects agent CLIs (claude, codex, cursor, openclaw, opencode, hermes, pi) available on your PATH.

2. 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.

3. 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.

4. 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.