ralph-town

CLI for disposable Daytona sandbox orchestration.

Use it to run LLM evals, package smoke tests, and arbitrary tooling commands in clean remote environments without touching your local machine.

Install

npm install -g ralph-town
# or
npx ralph-town --help

One-shot runs

# Run a command in a fresh sandbox and delete it afterwards
ralph-town run -- pnpx my-pi@latest --help

# Keep the sandbox for debugging
ralph-town run --keep -- pnpx my-pi@latest --help

# Clone a repo before running
ralph-town run \
	--repo https://github.com/user/project \
	--branch main \
	-- pnpm test

# Emit machine-readable output
ralph-town run --json -- pnpx my-pi@latest --help

Sandbox commands

• sandbox create - Create a Daytona sandbox
• sandbox list - List active sandboxes
• sandbox ssh - Get SSH credentials
• sandbox exec - Execute a command in an existing sandbox
• sandbox health - Check sandbox status and optional SSH ping
• sandbox delete - Delete a sandbox
• sandbox env - Manage sandbox environment variables
• sandbox snapshot - Create/preflight reusable snapshots

Environment Variables

| Variable | Context | Description | | --------------------------- | ------------------ | ------------------------------------------------------- | | DAYTONA_API_KEY | local orchestrator | Daytona API key | | GH_TOKEN | local orchestrator | Optional GitHub token for local commands | | ANTHROPIC_API_KEY | local orchestrator | Optional Anthropic key for local commands | | SANDBOX_GH_TOKEN | sandbox | Optional GitHub token forwarded as GH_TOKEN | | SANDBOX_ANTHROPIC_API_KEY | sandbox | Optional Anthropic key forwarded as ANTHROPIC_API_KEY |

GITHUB_PAT remains supported as a deprecated alias for SANDBOX_GH_TOKEN.

Development

pnpm dev
pnpm run check
pnpm run test
pnpm run build
pnpm start

Research

See docs/RESEARCH.md for architecture notes.