Sandbox

<prefix>/
├── bin/                # Symlinked binaries (uv, rg, opencode)
├── cache/              # XDG_CACHE_HOME - caches for tools
├── config/             # XDG_CONFIG_HOME - configuration files
├── python/             # uv-managed Python installations
├── share/              # XDG_DATA_HOME - application data
├── state/              # XDG_STATE_HOME - state/logs
├── tools/              # Downloaded tool archives
├── uv-tools/           # CLI tools installed via `uv tool`
└── workspace/          # The uv workspace the agent maintains

function buildUvEnv(prefix: string): Record<string, string> {
  return {
    UV_PYTHON_INSTALL_DIR: join(prefix, "python"),
    UV_PYTHON_PREFERENCE: "only-managed",
  };
}

requires-python = ">=3.13"

# Add a package
uv add requests

# Add a dev dependency
uv add --dev pytest

# Sync environment (install all dependencies)
uv sync

# Run a command in the virtual environment
uv run python script.py
uv run pytest

const proc = Bun.spawn([uv, "tool", "install", "ty"], {
  env: {
    ...process.env,
    ...buildUvEnv(prefix),
    UV_TOOL_DIR: toolDir,
    UV_TOOL_BIN_DIR: toolBinDir,
  },
});

workspace/
├── .opencode/              # OpenCode configuration and skills
│   └── skills/             # Agent-created skill definitions (generated at boot)
│       └── <skill>/
│           └── SKILL.md
├── .venv/                  # Python virtual environment (managed by uv)
├── src/<library>/          # Library code the agent writes
│   ├── __init__.py
│   └── utils.py
├── tests/                  # Test suite
│   └── test_utils.py
├── AGENTS.md               # Agent instructions (generated at boot)
├── opencode.json           # OpenCode permission configuration
├── pyproject.toml          # Python project metadata
├── README.md               # Project documentation
└── uv.lock                 # Dependency lock file

nightshift run --sandbox