ooda-cli

Design on your codebase in the cloud, no local setup required.

ooda.computer

Ooda launches Claude Code on cloud dev environments powered by Sprites.dev. Each project runs on its own isolated Linux VM with a public URL — no local dependencies, no Docker, no setup headaches.

Quick start

npx ooda-cli

On first run you'll be prompted for two keys:

1. Sprites API key — get one free at sprites.dev/settings/api-keys
2. Anthropic API key — get one at console.anthropic.com/settings/keys, or use Claude Code with OAuth

Both are saved to ~/.ooda/auth.json so you only need to do this once.

What it does

When you connect to a project, ooda automatically asks Claude to analyse your codebase, install dependencies, and start the dev server — no manual prompting needed. You're dropped into a full Claude Code session with syntax highlighting, tool use, and everything you'd get locally.

  Your projects:
    [1] new-nav             ● running
    [2] marketing-redesign  ○ stopped
    [3] shader-tool         ○ stopped

  [d] Deploy current directory
  [n] New project (opens dashboard)
  [q] Quit

  Select: _

• Pick a project — connects and launches Claude Code with full TTY pass-through
• Deploy current directory — uploads your local project to a new VM and starts Claude on it
• New project — opens the local web dashboard to create from a template

When you exit Claude (Ctrl+C), you're returned to the selector.

Dashboard

Ooda includes a local web dashboard at http://localhost:4444 for managing your projects visually. Browse existing projects, create new ones from templates, or deploy a local folder — all from your browser.

Parallel sessions

Work on multiple projects simultaneously by opening additional terminals:

# Terminal 1 — main menu + first project
npx ooda-cli

# Terminal 2 — connect directly to another project
npx ooda-cli connect marketing-redesign

# Terminal 3 — and another
npx ooda-cli connect shader-tool

ooda-cli connect <name> skips the dashboard and connects straight to the named project. It uses prefix matching, so ooda-cli connect market will match marketing-redesign-m3np.

Multi-language support

Each VM is a full Linux machine with root access. While ooda includes optimised support for JavaScript frameworks (Astro, Next.js, Vite), Claude can work with any language or framework — Ruby/Rails, Python/Django, PHP/Laravel, Go, Rust, and more. Claude analyses your codebase and figures out the right setup automatically.

Publishing

Tell Claude to publish your project and get a permanent shareable URL in seconds:

You: publish this
Claude: Building... uploading... done!
        Published: https://ooda.run/p/your-project

• Every publish creates a new version — previous versions stay accessible via ?v=N
• Published sites are static (HTML, CSS, JS) served from Cloudflare's edge
• Free, no limits on projects or versions

You can also use the /project:publish slash command in a Claude session.

Why not just use localhost?

• Consistent environments — every VM is identical, no "works on my machine" issues
• Safe by default — Claude runs with full permissions in a sandbox, no risk to your local filesystem
• Publish for free — tell Claude to publish and get a permanent URL at ooda.run/p/your-project
• Collaboration — share your sprites API key with teammates, every project gets a public URL
• Run anything, anywhere — full Linux VM from a laptop, tablet, or phone

Commands

npx ooda-cli                       # Interactive menu + dashboard
npx ooda-cli connect <name>        # Direct connect (for parallel sessions)
npx ooda-cli list                  # List your projects
npx ooda-cli --port 3000           # Custom dashboard port (default: 4444)

Auth options

| Method | Details | |--------|---------| | Interactive prompt | Paste keys on first run (saved to ~/.ooda/auth.json) | | Environment variables | SPRITES_TOKEN and ANTHROPIC_API_KEY | | Claude Code OAuth | If you have Claude Code installed on macOS, the OAuth token is read from your keychain automatically |

Requirements

• Node.js 20+
• A Sprites.dev account (free to start, pay-as-you-go)
• An Anthropic API key or a paid Claude subscription with OAuth

More info

• ooda.computer — marketing site
• ooda.computer/docs — documentation
• npm — package registry
• sprites.dev — cloud VM provider