Documentation Index Fetch the complete documentation index at: https://docs.joggr.ai/llms.txt
Use this file to discover all available pages before exploring further.
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
Configuration for local sandboxes — git worktree-based environments on your
machine. Files and directories to copy into new sandboxes. Paths are relative to the repo root.
Directories are copied recursively.
Commands to run sequentially after sandbox creation. Each command runs inside the new sandbox
directory.
Default command to launch in a new sandbox (e.g. claude, cursor, code).
Coming soon. Configuration for container sandboxes — OCI-compatible
environments with filesystem and network isolation.Public base image (e.g. node:22, python:3.12). Ignored if dockerfile is set. Private
registries are not supported.
Path to a Dockerfile, relative to repo root. Takes precedence over image.
Port mappings in host:container format.
Additional volume mounts in host:container format. The project is always mounted
automatically.
Environment variables in KEY=value format.
Memory limit (e.g. 4g, 512m).
Files and directories to copy into the container sandbox.
Commands to run after container creation.
Default command to launch in the container.
Coming soon. Configuration for remote sandboxes — cloud-hosted environments
that run while your laptop sleeps.Cloud sandbox provider (e.g. blaxel).
Maximum lifetime for the sandbox (e.g. 4h, 30m). Auto-expires after this duration.
Machine size: small, medium, large.
Public base image. Same as container.image.
Path to a Dockerfile. Same as container.dockerfile.
Exposed ports in host:container format.
Environment variables in KEY=value format.
Files and directories to copy into the remote sandbox.
Commands to run after remote sandbox creation.
Default command to launch in the remote sandbox.
Examples
Local sandbox
.joggr/config.json
.joggr/config.yaml
{
"$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"
}
}
}