A self-hosted control plane for AI-assisted development across your Macs.

Documentation · Quickstart · Local development · Issues

Documentation

Everything lives at ai-development-environment.mintlify.app.

Introduction	What the product does and how the pieces fit together
Quickstart	Install via Homebrew, npm, or from source, and enroll an agent
Local development	Running from source, the command list, and the screenshot pipeline
APIs	GraphQL, the codebase REST endpoints, and MCP
Database	Prisma, migrations, and reclaiming space
Hosting and networking	Public HTTPS, Cloudflare Access, and reverse proxies

Install

brew tap bludesign/ai-development-environment
brew install ai-development-environment
brew services start ai-development-environment

Or from npm:

npm install -g @ai-development-environment/server @ai-development-environment/control-agent
ai-development-environment

Or from docker:

docker run --name ai-development-environment \
  --publish 3090:3090 \
  --publish 3091:3091 \
  --volume ./data:/data \
  ghcr.io/bludesign/ai-development-environment:latest

The control agent is also available as a separate, outbound-only image. Persist both its enrollment and AI-provider credentials, and bind mount managed repositories at the paths registered with the server:

docker volume create ai-development-environment-agent-data
docker volume create ai-development-environment-agent-home

docker run --rm \
  --volume ai-development-environment-agent-data:/data \
  --volume ai-development-environment-agent-home:/home/node \
  ghcr.io/bludesign/ai-development-environment-control-agent:latest \
  enroll \
  --server https://aide.example.com \
  --websocket-server wss://aide.example.com/graphql \
  --enrollment-token <one-time-token>

docker run --detach --restart unless-stopped \
  --name ai-development-environment-control-agent \
  --volume ai-development-environment-agent-data:/data \
  --volume ai-development-environment-agent-home:/home/node \
  --volume /absolute/path/to/repositories:/absolute/path/to/repositories \
  ghcr.io/bludesign/ai-development-environment-control-agent:latest

The Linux image includes Git, SSH, Codex, OpenCode, and the Claude Agent SDK. Xcode, iOS build, build-data, and signing jobs require the macOS control agent installed through npm or Homebrew.

Full instructions, including enrolling a control agent, are in the Quickstart.

License

MIT. See LICENSE.md.