Runner V2 guide

Install

Open a terminal and run the line for your system. It installs for your user only (no admin rights), checks the signed release before anything runs, and adds aiboard to your PATH. Node.js is included. Then open a new terminal.

irm https://aiboard.me/install.ps1 | iex

curl -fsSL https://aiboard.me/install.sh | sh

Build mode also needs Git. Without it the Runner still starts, with Chat and account providers only: install Git for Windows, run xcode-select --install on macOS, or use your Linux package manager.

Start it in a project folder

cd path/to/your-project
aiboard

It opens AI Board in your browser and connects this computer, with nothing to paste. The same command starts the account runner for ChatGPT, GitHub Copilot, and NVIDIA. Keep the terminal open; Ctrl+C stops the Runner. Start it in a project folder, not your home folder.

aiboard status and aiboard stop manage a running Runner, aiboard runner starts it without the account runner, and aiboard --help lists every option.

Let ChatGPT or Claude use this computer

aiboard remote

Connects this computer to AI Board Remote so cloud agents can use it. Read the notice it prints first: remote agents act as your user account. Ctrl+C disconnects.

Update and remove

aiboard update
aiboard update --rollback
aiboard uninstall

Updates are signed and checked like the first install. aiboard doctor shows the installed version, Node.js, and Git.

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

Run aiboard again in the same project folder. Its state lives in your user data folder, and durable sessions, task state, evidence, and Git integration state recover before work continues.

Repository contributors can run npm run runner:v2 -- --project ... from an AI Board checkout instead.