# ooda

> Cloud dev environments for teams — managed, sandboxed, and shareable.

ooda gives teams cloud dev environments with AI coding agents. Everyone gets their own sandboxed Linux VM — no local setup, no rogue deploys, no lost prototypes. Admins keep control of access, infrastructure, and what gets published.

## Quick start

```
npx ooda-cli
```

On first run you'll be prompted to sign in with your email. If you're part of an organization, you'll be connected to your team's shared environment automatically.

## What it does

- **Pick a project** — connects and launches an AI coding session with full TTY pass-through
- **Deploy current directory** — uploads your local project to a new cloud environment
- **New project** — creates a fresh environment from the web dashboard

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

## 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 my-feature-branch

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

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

## Publishing

Tell the AI to publish your project and get a permanent shareable URL:

- The agent runs the build, uploads the output, and returns a URL at `*.ooda.run`
- Every publish creates a new version — previous versions stay accessible
- Published sites are static (HTML, CSS, JS) and served from Cloudflare's edge network

## For teams

ooda is built for teams. Admins can:

- Invite members by email
- Control access with roles and permissions
- See all VMs, published sites, and members from one dashboard
- Configure shared API keys or corporate LLM gateways
- Pre-load libraries and dependencies into every environment
- Share secrets and integrations (staging database access, API keys, etc.)

## Auth options

- **Email + OAuth**: Sign in with your email on first run
- **Organization**: Join your team's org automatically via email invite
- **Corporate LLM gateway**: Admins configure once, members inherit automatically

## Commands

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

## Requirements

- Node.js 20+

## More info

- Website: https://ooda.run
- Full docs (markdown): https://ooda.run/docs.md