Get started

From zero to first agent session

Aiva is pre-alpha, and today you run it from source. You need the .NET 10 SDK, Docker, Git, and at least one agent CLI. Everything else is one script.

Clone and build

Clone the repository and build the full solution — agent, bridge, and cloud services in one go.

Start the stack

One script brings up the cloud services, seeds a workspace, and connects your local bridge.

Open the control plane

Build

Build the solution

The repository contains the local Agent API, the bridge, the cloud services, and this site. One build covers everything.

terminal

$ git clone https://github.com/moltenmouse/aiva
$ cd aiva
$ dotnet build Aiva.Agent.slnx

Run

Start the local validation stack

The script starts the cloud services in Docker, waits for health checks, seeds a workspace and instance, starts the local Agent API and bridge, and prints the URLs to use.

Cloud Web on http://127.0.0.1:7090
Local Agent API on http://127.0.0.1:5087
Optional public tunnel for browser validation

terminal

$ scripts/run-local-ui-validation-stack.sh

# With a public tunnel for remote browser access:
$ scripts/run-local-ui-validation-stack.sh --tunnel

Requirements

What you need on the machine

.NET SDK 10, Docker, and Git
At least one agent CLI — Claude, Codex (with codex app-server), Cursor, Grok, or OpenCode
A logged-in home for that agent, or Aiva-managed auth through the Agent API
Optional GitHub or Azure DevOps credentials for remote repository sessions

verify your machine

$ dotnet --version
10.0.100

$ codex --version
codex-cli 0.29.0

$ docker info --format '{{.ServerVersion}}'
27.x

Ready when you are

Open the control plane and start your first session — or read how the architecture fits together first.

Open the app How it works