New to devsandbox? Read in this order:
- Sandboxing -- understand what's isolated and what's accessible
- Tools -- see how your development tools work inside the sandbox
- Use Cases -- set up shell aliases, autocompletion, and common workflows
Want to inspect network traffic?
- Proxy Mode -- enable the MITM proxy, view logs, set up HTTP filtering and content redaction
Configuring for your team or project?
- Configuration -- config file reference, per-project overrides, credential injection, remote logging
| Task | Where to Look |
|---|---|
| Understand the security model | Sandboxing: Security Model |
| Enable proxy mode | Proxy: Enabling Proxy Mode |
| View proxy traffic logs | Proxy: Viewing Logs |
| Set up HTTP filtering | Proxy: HTTP Filtering |
| Scan requests for secrets | Proxy: Content Redaction |
| Inject credentials without exposing tokens | Proxy: Credential Injection |
| Configure git access | Tools: Git |
| Set up AI assistants | Tools: AI Coding Assistants |
| AI agent recommended config | Configuration: Complete Example |
| Run Claude Code autonomously | Use Cases: Claude Code |
| Enable Docker socket access | Tools: Docker |
| Desktop notifications in sandbox | Tools: XDG Portal |
| Per-project config files | Configuration: Per-Project |
| Remote logging (syslog, OTLP) | Configuration: Remote Logging |
| Port forwarding | Configuration: Port Forwarding |
| Shell aliases and autocompletion | Use Cases: Shell Autocompletion |
| Custom mount rules | Sandboxing: Custom Mounts |
| Overlay filesystem | Sandboxing: Overlay Filesystem |
| Migrate overlay data to host | Sandboxing: Migrating Overlay Data |
| Avoid GitHub API rate limits | Use Cases: GitHub Rate Limits |
| Docker backend details | Sandboxing: Docker Backend |
| Troubleshooting | Sandboxing: Troubleshooting |
| Page | Description |
|---|---|
| Sandboxing | How isolation works on each platform, filesystem layout, security model, overlay mounts, custom mounts, data locations, Docker backend internals |
| Proxy Mode | MITM proxy setup, traffic inspection, log viewing and filtering, HTTP request filtering with ask mode, content redaction, credential injection, remote logging destinations |
| Tools | mise integration, shell and editor configuration, prompt indicators, AI assistant setup, Git modes, Docker socket proxy, language-specific notes |
| Configuration | TOML config reference, proxy settings, credential injection, isolation backend, custom mounts, port forwarding, overlay settings, per-project configs, conditional includes |
| Use Cases | AI assistant workflows, shell autocompletion (bash/zsh/fish), aliases, development workflows by language, security monitoring scripts |