devsandboxesDOCS · v0.8.0

// EXAMPLES · 10 RECIPES

Start from a recipe

Each example is one use case, end to end: the whole config, the commands to try it, what happens underneath, and a prompt that has your coding agent set it up in your own config.

  1. 01A complete devsandboxes.toml
  2. 02Commands to try it
  3. 03How it works
  4. 04A prompt for your agent
01 / 10

Parallel coding agents

Several coding agents on one repo, fully isolated from one another.

  • agents
  • worktrees
  • git
Open the recipe
02 / 10

One shared Postgres

One development database for all your sandboxes and their instances.

  • services
  • databases
Open the recipe
03 / 10

Private services per instance

Every instance gets its own Postgres and Redis, so agents never touch each other's data.

  • services
  • networking
  • agents
Open the recipe
04 / 10

Shared package caches

New sandboxes stop downloading the same packages again.

  • caches
  • performance
Open the recipe
05 / 10

ssh-agent and git push

Agents push over ssh with your host's keys, which never enter the container.

  • git
  • ssh
  • agents
Open the recipe
06 / 10

Port forwarding on demand

Open a sandbox's dev server or database from your host, without restarting anything.

  • networking
  • services
Open the recipe
07 / 10

Attach VS Code

Open any instance in VS Code with one key.

  • editors
  • devcontainers
Open the recipe
08 / 10

devcontainer Features

Add Node, Rust or the GitHub CLI to any image, in TOML.

  • devcontainers
  • images
Open the recipe
09 / 10

Babysit pull requests

An agent keeps your open PRs merged with their base, and pings you when it can't.

  • automations
  • agents
  • git
Open the recipe
10 / 10

Port a devcontainer.json

Turn an existing devcontainer.json into a devsandbox config.

  • devcontainers
  • migration
Open the recipe
MENU /
View on GitHub
EXAMPLES
All examplesEvery recipe on one page.Parallel coding agentsSeveral coding agents on one repo, fully isolated from one another.One shared PostgresOne development database for all your sandboxes and their instances.Private services per instanceEvery instance gets its own Postgres and Redis, so agents never touch each other's data.Shared package cachesNew sandboxes stop downloading the same packages again.ssh-agent and git pushAgents push over ssh with your host's keys, which never enter the container.Port forwarding on demandOpen a sandbox's dev server or database from your host, without restarting anything.Attach VS CodeOpen any instance in VS Code with one key.devcontainer FeaturesAdd Node, Rust or the GitHub CLI to any image, in TOML.Babysit pull requestsAn agent keeps your open PRs merged with their base, and pings you when it can't.Port a devcontainer.jsonTurn an existing devcontainer.json into a devsandbox config.