sandbox - Joggr

The sandbox key controls what happens when you run jog sandbox create. It defines sandbox-type-specific configuration for local worktrees, containers, and remote cloud environments.

Properties

sandbox.local

LocalSandbox

Configuration for local sandboxes — git worktree-based environments on your machine.

Show properties

copy

string[]

default:"[]"

Files and directories to copy into new sandboxes. Paths are relative to the repo root. Directories are copied recursively.

run

string[]

default:"[]"

Commands to run sequentially after sandbox creation. Each command runs inside the new sandbox directory.

command

string

Default command to launch in a new sandbox (e.g. claude, cursor, code).

sandbox.container

ContainerSandbox

Coming soon. Configuration for container sandboxes — OCI-compatible environments with filesystem and network isolation.

Show properties

image

string

Public base image (e.g. node:22, python:3.12). Ignored if dockerfile is set. Private registries are not supported.

dockerfile

string

Path to a Dockerfile, relative to repo root. Takes precedence over image.

ports

string[]

default:"[]"

Port mappings in host:container format.

volumes

string[]

default:"[]"

Additional volume mounts in host:container format. The project is always mounted automatically.

env

string[]

default:"[]"

Environment variables in KEY=value format.

memory

string

Memory limit (e.g. 4g, 512m).

cpus

number

CPU limit (e.g. 2, 0.5).

copy

string[]

default:"[]"

Files and directories to copy into the container sandbox.

run

string[]

default:"[]"

Commands to run after container creation.

command

string

Default command to launch in the container.

sandbox.remote

RemoteSandbox

Coming soon. Configuration for remote sandboxes — cloud-hosted environments that run while your laptop sleeps.

Show properties

provider

string

required

Cloud sandbox provider (e.g. blaxel).

timeout

string

default:"1h"

Maximum lifetime for the sandbox (e.g. 4h, 30m). Auto-expires after this duration.

size

string

default:"medium"

Machine size: small, medium, large.

image

string

Public base image. Same as container.image.

dockerfile

string

Path to a Dockerfile. Same as container.dockerfile.

ports

string[]

default:"[]"

Exposed ports in host:container format.

env

string[]

default:"[]"

Environment variables in KEY=value format.

copy

string[]

default:"[]"

Files and directories to copy into the remote sandbox.

run

string[]

default:"[]"

Commands to run after remote sandbox creation.

command

string

Default command to launch in the remote sandbox.

Examples

Local sandbox

{
  "$schema": "https://raw.githubusercontent.com/joggrdocs/home/refs/heads/main/schema.json",
  "sandbox": {
    "local": {
      "copy": [".env", ".env.local", ".turbo"],
      "run": ["pnpm install", "pnpm build"],
      "command": "claude"
    }
  }
}

​Properties

​Examples

​Local sandbox

Properties

Examples

Local sandbox