snapshot-management

Snapshot Management

Quick Reference

Verify snapshot ready: ralph-town sandbox preflight Create snapshot: ralph-town sandbox snapshot create

sandbox preflight

Verify snapshot has required tools before spawning teammates.

# Check default snapshot (ralph-town-dev)
ralph-town sandbox preflight

# Check specific snapshot
ralph-town sandbox preflight --snapshot my-snapshot

# JSON output for scripts
ralph-town sandbox preflight --json

Flags:

• --snapshot <name> - Snapshot to test (default: ralph-town-dev)
• --json - Output as JSON

What it checks:

• /usr/bin/gh - GitHub CLI
• /usr/bin/git - Git
• /root/.bun/bin/bun - Bun runtime
• /usr/bin/curl - curl

sandbox snapshot create

Create a pre-baked snapshot with all required tools.

# Create default snapshot
ralph-town sandbox snapshot create

# Create with custom name
ralph-town sandbox snapshot create --name my-snapshot

# Force recreate existing
ralph-town sandbox snapshot create --force

# JSON output
ralph-town sandbox snapshot create --json

Flags:

• --name <name> - Snapshot name (default: ralph-town-dev)
• --force - Delete existing snapshot and recreate
• --json - Output as JSON

What snapshot includes:

• Base image: debian:bookworm-slim
• Tools: git, curl, gh CLI, bun
• SDK: @anthropic-ai/claude-agent-sdk
• Working dir: /home/daytona

Build time: ~2-3 minutes

When to Use

• Run preflight before spawning teammates
• Run snapshot create if preflight fails
• Use --force to rebuild after tool updates

SDK Usage

import { Daytona, Image } from '@daytonaio/sdk';

const daytona = new Daytona();

// Create snapshot
const image = Image.base('debian:bookworm-slim')
  .runCommands(
    'apt-get update && apt-get install -y curl git',
    'curl -fsSL https://bun.sh/install | bash',
  )
  .env({ PATH: '/root/.bun/bin:$PATH' })
  .workdir('/home/daytona');

await daytona.snapshot.create(
  { name: 'my-snapshot', image },
  { onLogs: console.log, timeout: 300 },
);

// List/check snapshots
const snapshots = await daytona.snapshot.list();
const snapshot = await daytona.snapshot.get('ralph-town-dev');

Known Limitation

executeCommand() returns exit code -1 on snapshot sandboxes. Use SSH instead. See daytonaio/daytona#2283