Local Development - Army of Agents

Run AoA locally with zero external dependencies.

Prerequisites

pnpm install
pnpm dev

This starts:

No Docker or external database required. AoA uses embedded PostgreSQL automatically.

For a first-time install:

pnpm aoa run

This does:

To run in authenticated/private mode for network access:

pnpm dev --tailscale-auth

This binds the server to 0.0.0.0 for private-network access. Alias:

pnpm dev --authenticated-private

Allow additional private hostnames:

pnpm aoa allowed-hostname dotta-macbook-pro

For full setup and troubleshooting, see Tailscale Private Access.

curl http://localhost:3100/api/health
# -> {"status":"ok"}

curl http://localhost:3100/api/companies
# -> []

To wipe local data and start fresh:

rm -rf ~/.aoa/instances/default/db
pnpm dev

Data	Path
Config	`~/.aoa/instances/default/config.json`
Database	`~/.aoa/instances/default/db`
Storage	`~/.aoa/instances/default/data/storage`
Secrets key	`~/.aoa/instances/default/secrets/master.key`
Logs	`~/.aoa/instances/default/logs`

Override with environment variables:

AOA_HOME=/custom/path AOA_INSTANCE_ID=dev pnpm aoa run