Use DevCapsule
On this page
DevCapsule runs a desktop IDE and coding agents inside a capsule: a container that mounts your project folder, keeps its own per-checkout persistent state, and leaves your host home directory and desktop unmounted by default. The capsule has outbound network access; The boundary explains its limits and the access you can grant. These pages describe v0.3.0; use the version switcher to inspect another release.
Start in one of three places
| You want to | Read |
|---|---|
| See it work in fifteen minutes, with no AI account | Your first session |
| Open a repository you already have | An existing repository |
| Run a coding agent at full speed inside a clear boundary | Choose an agent |
Everything else, by the question you have
| Question | Section |
|---|---|
| How quickly can I install and try it? | Getting started: install, first session, stop and come back |
| How do I bring or create a project? | Your project: existing repositories, new projects, manifest declarations, services and ports |
| How do I work effectively with coding agents? | Working with AI: choosing agents, sign-in, instructions, models, reviewing agent work |
| Can I do my normal day-to-day coding? | Everyday development: clipboard and browser, IDEs and terminals, Git, run/debug/test, previews and ports |
| How do I configure the project, checkout, and home? | Configuration: project versus personal, configuration home, inspection, IDE preferences, resource limits, local base, vendor trust, capabilities |
| What can the capsule and its agents reach? | Containment: the default boundary, granting and withdrawing access |
| How do sessions, persistence, and parallel checkouts work? | Sessions: start/stop/reconnect, web console, what persists, several projects, moving machines |
| How do people and agents share one repository? | Collaboration: working in workstreams |
| How do launcher and component updates work? | Updates: supported versions, launcher updates, component upgrades, component freshness |
| What if something fails or I want to clean up? | Troubleshooting: first-session checks, diagnostics and logs, cleanup and uninstall |
| Does it run on my operating system? | Platforms: Linux, Windows via WSL2, macOS |
| What are the exact commands, nodes, and JSON fields? | Reference: CLI reference, configuration nodes, project info |
Developing DevCapsule
To contribute to DevCapsule itself, read For developers and the repository documentation index.