# ooda

> Publish prototypes, tools, and sites to the web — safely, from any agent.

ooda lets teams publish prototypes, tools, and sites to the web safely, from any agent — login-protected by default and under your org. No rogue deploys, no lost prototypes. Admins keep control of access and what gets published.

## Quick start

Install globally and run `ooda` (the CLI nudges you when a newer version ships):

```
npm install -g @oodarun/cli
ooda
```

You can also run it without installing via `npx @oodarun/cli@latest`.

On first run you'll be prompted to sign in with your email. If you're part of an organization, you'll join your team's org automatically. From a built site, run `ooda publish` to ship it to a private URL.

## Publishing

Publish a built static site to a permanent shareable URL with one command:

1. Build your site (e.g. `npm run build`)
2. `ooda publish` detects the build output directory (`dist`, `build`, `out`, etc.) and uploads it
3. Your site is available at a `*.ooda.run` URL, gated by your access policy

Every publish creates a new version — previous versions stay accessible. Published sites are static (HTML, CSS, JS) and served from Cloudflare's edge network.

## Access control

Every site is gated. By default a site requires a team login; you can make any site public or password-protected, per site or as an org-wide default. Manage access from the dashboard or with `ooda sites access`.

## For teams

ooda is built for teams. Admins can:

- Invite members by email
- Control access with roles and permissions
- See all published sites and members from one dashboard
- Set env vars and secrets for published sites

## Auth options

- **Email code**: `ooda login` emails you a sign-in code (`--email`/`--code` for agents and CI)
- **Organization**: Join your team's org automatically via email invite

## Commands

```
ooda publish [path]                      # Publish a built static site to {slug}.ooda.run
ooda sites [list|access|password|delete] # Manage published sites
ooda secrets [set|list|rm]               # Env vars & secrets for your sites
ooda login | whoami | logout             # Sign in (email code), check session, sign out
```

## Agent skill

Teach a coding agent (Claude Code, Cursor, etc.) to use ooda — authenticate, publish static sites, and manage published sites non-interactively. No install is needed — tell the agent:

```
Fetch https://ooda.run/skill.md and follow its instructions.
```

To install it into the agent's skills directory instead: `npx skills add toy-studio/ooda-skills -g`

Source: https://github.com/toy-studio/ooda-skills

## Requirements

- Node.js 20+

## More info

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