# ooda

> Run and build with real codebases in the cloud with one command.

ooda is a CLI tool that launches Claude Code on cloud dev environments powered by Sprites.dev. No more fighting localhost — you and Claude can develop and share apps on little computers, from anywhere.

## Quick start

```
npx ooda-cli
```

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

1. **Sprites API key** — get one at https://sprites.dev/settings/api-keys
2. **Anthropic API key** — get one at https://console.anthropic.com/settings/keys

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

## What it does

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

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

## Parallel sessions

Work on multiple sprites simultaneously by opening additional terminals:

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

# Terminal 2 — connect directly to another sprite
npx ooda-cli connect my-feature-branch

# Terminal 3 — and another
npx ooda-cli connect my-bugfix
```

`ooda-cli connect <sprite-name>` skips the dashboard and connects straight to the named sprite. It uses fuzzy prefix matching, so `ooda-cli connect my-proj` will match `my-proj-ab3f`.

## Auth options

- **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

## Commands

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

## Requirements

- Node.js 20+
- A Sprites.dev account (https://sprites.dev)
- An Anthropic API key (https://console.anthropic.com/settings/keys) or Claude Code with OAuth

## More info

https://ooda.computer