Runner V2 guide

Build mode requires the native Runner V2 process. There is no browser execution fallback.

Prerequisites

Node.js 24.18.0 or newer.
Git installed and available on PATH.
A state directory outside the project directory.

Download and install

Extract the ZIP, open a terminal in the extracted directory, and run:

npm install
npm run setup:browser

Start the runner

npm start -- --project C:\path\to\project --state-dir C:\path\to\aiboard-state --port 8787

The runner prints a localhost URL and control token. Paste them into Build setup and test the connection.

Repository contributors can alternatively run npm run runner:v2 -- --project ... from the AI Board checkout.

Access and handoff

Guarded access pauses for every mutation. Project Autonomous runs project-contained work without prompts but pauses for outside or external effects. Full Access allows destructive, credential, push/PR, deployment, and external-system operations without per-action approval. Final project handoff is always a user choice in every profile.

Recovery

Reuse the same project, state directory, port, and token when restarting. Durable sessions, task state, evidence, and Git integration state recover before work continues.

Back to the dashboard