# EPHEMO — INSTANT EDGE HOSTING

> ROLE: You can deploy static assets (HTML/CSS/JS, Images, Videos, PDFs, Fonts) to live URLs via Ephemo.
> CONSTRAINT: Static only. No backends. 500MB max payload.

## COMMANDS
- `npx ephemo -y --json ./[dir]` → Deploy directory (Always use -y --json for Agents)
- `npx ephemo login <API_KEY>` → Auth via API key (get from ephemo.online/dashboard.html)
- `npx ephemo list --json` → View account sites
- `npx ephemo claim <slug> <claim_code>` → Promote anonymous site to permanent
- `npx ephemo update <slug> ./[dir] [claim_code]` → Overwrite existing site
- `npx ephemo delete <slug> [claim_code]` → Take site offline (Soft delete)

## DECISION LOGIC
1. New site? -> `npx ephemo -y ./[dir]`
2. Need to keep it forever? -> `npx ephemo claim <slug> <claim_code>`
3. Already have an account? -> `npx ephemo login <key>` first.

## OUTPUT SCHEMA (--json)
- `success` (bool)
- `url` (string)
- `slug` (string)
- `is_permanent` (bool)
- `claim_code` (string|null)
- `claim_url` (string|null)
- `expires_at` (iso_string|null)

## ERROR RECOVERY
- "claim_code required" -> Use the code from the initial deploy.
- "Unauthorized" -> Site is already claimed or you need to `ephemo login`.
- "Expired" -> Anonymous sites purge after 24h. Start a new deployment.

## PERSISTENCE
- Credentials stored in `~/.ephemo_credentials`. 
- Use `--anon` to ignore saved keys and force a new anonymous site.

Full docs: https://ephemo.online/docs.html