@oodarun/cli

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

ooda.run

Ooda launches Claude Code on cloud sandboxes. Each project runs in its own isolated cloud environment with a public URL — no local dependencies, no Docker, no setup headaches.

Quick start

npx @oodarun/cli

Or install globally for a shorter command:

npm install -g @oodarun/cli
ooda

On first run you'll be prompted to sign in with your email. If your org is already set up, you'll be connected to it automatically. Otherwise an org admin can invite you.

Your credentials 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 sandbox 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 @oodarun/cli

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

# Terminal 3 — and another
ooda connect shader-tool

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

Multi-language support

Each sandbox is a full Linux environment 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 sandbox 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 — every project gets a public URL, visible to all org members in the dashboard
• Run anything, anywhere — full cloud sandbox from a laptop, tablet, or phone

Commands

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

Auth options

| Method | Details | |--------|---------| | Interactive prompt | Sign in with email on first run (saved to ~/.ooda/auth.json) | | Environment variables | OODA_ACCESS_TOKEN and OODA_ORG_ID | | Claude Code OAuth | If you have Claude Code installed on macOS, the OAuth token is read from your keychain automatically |

Requirements

• Node.js 20+
• An ooda account — org admins invite members, or sign up at ooda.run
• An Anthropic API key or a paid Claude subscription with OAuth

More info

• ooda.run — marketing site
• ooda.run/docs — documentation
• npm — package registry