aibox.toml is the source of truth for the workspace: base image, container identity, addons, AI harnesses, theme, layout, runtime thresholds, and processkit source/version.
aibox generates Dockerfile, Compose, override, and devcontainer JSON files. The output is managed, but it remains readable and compatible with Docker, Podman, OrbStack, and VS Code Dev Containers.
Language runtimes, AI CLIs, git tools, preview utilities, documentation frameworks, and infrastructure tools are selected through addons instead of being forced into every running container.
processkit owns skills, processes, schemas, state machines, packages, and the canonical AGENTS.md template. aibox pins, installs, and updates that content under context/.
Claude Code, Codex/OpenAI, Aider, Gemini, Mistral, GitHub Copilot, Continue, Cursor registration, and related MCP configuration are selected declaratively. Provider-specific files stay thin.
aibox get runtime --resources and aibox doctor report memory pressure, OOM kill counters, process counts, generated Compose posture, and selected runtime settings.
When generated content changes, aibox preserves local edits, keeps upstream snapshots, and emits migration documents for changes that need human or agent review.