Skip to content

README.md

Latest commit

 

History

History
97 lines (77 loc) · 4.42 KB

README.md

File metadata and controls

97 lines (77 loc) · 4.42 KB
Raw

AI Development Environment

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

Documentation · Quickstart · Local development · Issues

The Worktrees page

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.