@easybits.cloud/cli 0.16.0 → 0.17.1

package/README.md

@@ -44,6 +44,18 @@ easybits sandboxes files ls sb_abc123 /data/work
 easybits sandboxes files read sb_abc123 /etc/os-release
 easybits sandboxes files read sb_abc123 /data/app.db --out app.db   # tope 8 MB: más grande sale con código 1 ("truncated")
 easybits sandboxes files write sb_abc123 /data/work/app.js ./app.js
+easybits sandboxes files mkdir sb_abc123 /data/work/out
+easybits sandboxes files mv sb_abc123 /data/work/a.txt /data/work/out/a.txt
+easybits sandboxes files rm sb_abc123 /data/work/tmp -r --yes
+easybits sandboxes bg start sb_abc123 --cwd /data/work -- npm run dev   # prints an execId
+easybits sandboxes bg ls sb_abc123
+easybits sandboxes bg status sb_abc123 exec_123    # status, exit code, its stdout/stderr
+easybits sandboxes bg kill sb_abc123 exec_123      # the whole process group
+easybits sandboxes git clone sb_abc123 --repo https://github.com/you/app.git --dir /data/work/app --git-token '$secret:GITHUB_TOKEN'
+easybits sandboxes git status sb_abc123 --dir /data/work/app
+easybits sandboxes git commit sb_abc123 --dir /data/work/app --all -m "fix: checkout"
+easybits sandboxes git push sb_abc123 --dir /data/work/app --git-token '$secret:GITHUB_TOKEN'
+easybits sandboxes git pull|checkout|log sb_abc123 --dir /data/work/app …
 easybits sandboxes suspend sb_abc123
 easybits sandboxes resume sb_abc123
 easybits sandboxes snapshot sb_abc123 --name before-upgrade
@@ -53,20 +65,70 @@ easybits sandboxes destroy sb_abc123 --yes
 easybits machines ls
 easybits machines launch --repo https://github.com/you/shop.git --tier micro --domain shop.example.com
 easybits machines launch --machine shop --archive ./build.tgz --prebuilt -m v2   # redeploy
-easybits deploy sb_abc123 -m "v1.2"   # = machines deploy
+easybits machines deploy sb_abc123 -m "v1.2"   # publish a release of the current code
+easybits deploy sb_abc123 -m "v1.2"            # same thing, shorter
 easybits machines releases sb_abc123 --limit 5
 easybits machines logs sb_abc123 --lines 100 --grep ERROR
 easybits machines rollback sb_abc123 rel_789
 easybits machines secrets ls sb_abc123
 easybits machines secrets set sb_abc123 --dotenv .env.production   # - reads stdin
 easybits machines secrets unset sb_abc123 DATABASE_URL
+easybits machines restart shop       # restart the app with the current secrets/runspec (no build)
+easybits machines get shop           # tier, size, MXN/month, whether it sleeps
+easybits machines tiers              # the catalog: sizes and prices in MXN
+easybits machines runspec get shop
+easybits machines runspec set shop --data /app/data --start 'node server.js' --port 8080   # merges
+easybits machines backups shop       # daily data backups (7 days)
+easybits machines backup shop        # one now
+easybits machines redeploy shop --tier focus --replace   # resize: new machine from the newest release
+easybits machines rm shop --yes      # release: stops billing, last backup, destroys the box
 easybits init --port 3000            # GitHub Actions workflow that deploys on every push
 
-# Domains
-easybits domains ls sb_abc123
-easybits domains add sb_abc123 shop.example.com --port 3000
-easybits domains verify sb_abc123 shop.example.com
-easybits domains rm sb_abc123 shop.example.com --yes
+# Domains of your account (serve your websites at <slug>.example.com and the root)
+easybits domains ls
+easybits domains add example.com             # prints the DNS records to create
+easybits domains verify example.com          # TXT found → certificate issued
+easybits domains dns-auto example.com        # DNS in Mailmask? writes the records for you (--undo restores)
+easybits domains apex example.com mi-tienda  # serve a website at example.com and www (--clear removes it)
+easybits domains rm example.com --yes
+
+# Domains on a sandbox or machine port (was `easybits domains … <sandbox>`; that still works)
+easybits sandboxes domains ls sb_abc123
+easybits sandboxes domains add sb_abc123 shop.example.com --port 3000
+easybits sandboxes domains verify sb_abc123 shop.example.com   # exit 1 until it is ready
+easybits sandboxes domains rm sb_abc123 shop.example.com --yes
+
+# Web (metered in web queries; out of them → exit 1 with the link to buy a pack)
+easybits web search dentista polanco --country mx            # organic results: # / title / url
+easybits web fetch https://example.com --markdown --main      # body to stdout (--out page.md to save it)
+easybits web extract google_maps --input '[{"keyword":"dentista Polanco CDMX","country":"MX"}]' --limit 50 --wait
+easybits web extract instagram_profiles --url https://instagram.com/easybits   # async: prints the jobId
+easybits web extract-status j_abc123                          # records as JSON lines once done
+easybits web crawl https://docs.example.com --max-pages 5 --main
+
+# Webhooks (HMAC-signed POSTs when your files, websites or forms change)
+easybits webhooks ls
+easybits webhooks create https://example.com/hook --event file.created --event form.submitted   # secret shown ONCE
+easybits webhooks update 66f0c2a1b2c3d4e5f6a7b8c9 --event file.created,file.deleted   # --pause / --resume / --url
+easybits webhooks rm 66f0c2a1b2c3d4e5f6a7b8c9 --yes
+
+# API keys
+easybits keys ls                                    # prefix only
+easybits keys create ci-deploy --scopes READ,WRITE --expires 2027-01-31   # prints the key ONCE
+easybits keys revoke ci-deploy --yes                # by id, name or prefix
+
+# Account secrets vault (values never come back; used by name: $secret:NAME, --secret NAME)
+easybits secrets ls
+easybits secrets set --dotenv .env.production   # KEY=VALUE lines; - reads stdin
+printf '%s' "$TOKEN" | easybits secrets set GITHUB_TOKEN   # one value from stdin
+easybits secrets rm GITHUB_TOKEN --yes
+
+# Platform crons (platform admins only; key with the ADMIN scope)
+easybits crons ls
+easybits crons runs backup-machines
+easybits crons run purge-notifications
+easybits crons pause check-hosting
+easybits crons resume check-hosting
 
 # Databases
 easybits db ls
@@ -93,7 +155,7 @@ easybits agents set helper --prompt-file PROMPT.md [--prompt-mode append|replace
 easybits agents files ls|get|put|rm helper [path|local-files…] [--to DIR] [--out FILE]
 easybits agents skills ls|get|add|rm helper [slug…] [--dir FOLDER | --file SKILL.md] [--restart]
 easybits agents mcp get|set helper [--file servers.json|-]   # set replaces the list and restarts
-easybits agents restart helper
+easybits agents restart helper                  # restart its runtime (new session; skills and MCP load)
 easybits agents try helper "who are you?"      # one full turn as text: verify what you set up
 easybits agents logs helper --since "10 min ago"
 easybits agents doctor helper                   # exits 1 on a problem; status "error" shows why it did not start
@@ -103,18 +165,65 @@ easybits apply ./helper --create --name helper-2  # a new agent from the folder
 easybits agents create --like helper --name helper-2 [--copy-files] --dry-run   # clone its setup, never its env
 easybits agents create --from helper.json --name helper-3
 
+# Fleet agents (one agent, many conversations: WhatsApp, WABA, Teams, web)
+easybits fleet ls
+easybits fleet get soporte                          # engine, model, effort, channels, prompt
+easybits fleet capabilities soporte --json          # engines, models, tool buckets, MCPs, skills, channels
+easybits fleet configure soporte --prompt-file PROMPT.md --model claude-sonnet-5-5 --recycle
+easybits fleet message soporte "¿qué horarios tienen?" --config-group web   # prints the reply
+
 # Files, websites, account
 easybits files ls
 easybits files upload ./report.pdf
 easybits files upload ./logo.png --public   # open CDN URL; private by default
 easybits files rm FILE_ID --yes
 easybits sites ls                    # your site-builder sites (/dash/sitios): kind, engine, URL
+easybits sites create --prompt "Landing for my dental clinic"   # web app (TanStack) in its own machine
+easybits sites create --prompt "Task tracker with login" --stack next --json
+easybits sites create --name "Promo" --kind static              # CDN website instead of a machine
+easybits sites theme get my-clinic                              # site by name or id
+easybits sites theme set my-clinic --theme dracula              # or --colors theme.json (every token)
 easybits websites ls                 # every static website (also documents and agent-published pages)
 easybits websites create "My shop" --slug my-shop   # slug optional
 easybits websites slug my-shop my-store             # change it; the old URL 301s
+easybits websites get my-store                      # slug or id: files, size, URL
+easybits websites deploy my-store ./dist            # upload a folder keeping its paths (--dry-run lists it)
+easybits websites upload my-store ./hero.jpg --path img/hero.jpg
+easybits websites files ls my-store                 # paths inside the site
+easybits websites rm my-store                       # type the slug to confirm (--yes without a terminal)
 easybits providers                   # storage provider (Tigris by default)
 easybits usage
 
+# Documents: pages of HTML you write (page = number 1… or id)
+easybits documents ls --search quote
+easybits documents create --name "ACME quote" --html cover.html --html prices.html
+easybits documents create --name "Carousel" --format ig-feed   # one blank 1080x1350 page
+easybits documents get "ACME quote"                # format, URL and pages
+easybits documents pages ls "ACME quote"
+easybits documents pages get "ACME quote" 2 --out prices.html
+easybits documents pages set "ACME quote" 2 prices.html        # - reads stdin
+easybits documents add-page "ACME quote" annex.html --after 2
+easybits documents rm-page "ACME quote" 3 --yes
+easybits documents reorder "ACME quote" 1 3 2
+easybits documents deploy "ACME quote"             # public URL (+ PDF)
+easybits documents export pdf "ACME quote" --out quote.pdf
+easybits documents export png Carousel --out ./slides   # one PNG per page, exact size
+easybits documents rm "ACME quote" --yes
+
+# Video: HTML + GSAP scenes with narration, rendered to MP4 (scene = number 1… or id)
+easybits video projects create --name "Fall promo" --format square   # portrait 1080x1920 by default
+easybits video projects ls
+easybits video projects get "Fall promo"           # scenes, music, status, last MP4
+easybits video scenes add "Fall promo" intro.html --timeline intro.js --narration "Fall is here"
+easybits video scenes ls "Fall promo"
+easybits video scenes set "Fall promo" 1 --duration 4 --voice ef_dora
+easybits video scenes reorder "Fall promo" 2 1
+easybits video scenes rm "Fall promo" 2 --yes
+easybits video music set "Fall promo" https://cdn.example.com/bed.mp3   # none removes it
+easybits video render "Fall promo" --wait --out promo.mp4   # without --wait: starts and returns
+easybits video projects rm "Fall promo" --yes
+easybits video ls                                  # AI-generated clips
+
 # MCP, SSH, docs
 easybits whoami        # account and where the credential comes from
 easybits doctor        # Node, CLI version, credential, API; exits 1 on a problem
@@ -125,8 +234,8 @@ easybits docs cli      # a docs section as markdown (--en for English)
 easybits docs --open   # open the docs in your browser
 ```
 
-**Names or ids.** Wherever a command takes an agent, a sandbox/machine or a database, you can
-pass its name instead of the id (`easybits sb exec scratch -- ls`, `easybits domains ls shop`).
+**Names or ids.** Wherever a command takes an agent, a sandbox/machine, a database, a site, a document or a video project, you can
+pass its name instead of the id (`easybits sb exec scratch -- ls`, `easybits sb domains ls shop`).
 The match is exact and case-insensitive; if two share the name the CLI exits 2 and lists the ids.
 
 Shell completion: `source <(easybits completion zsh)` (or `bash`, `fish`).
@@ -136,15 +245,15 @@ Help and messages follow your locale (`LANG=es_*` → Spanish) or `--lang es|en`
 Every command has help with examples: `easybits <command> <subcommand> --help`
 (or `easybits help <command> <subcommand>`). A typo gets a "Did you mean" suggestion.
 
-**Destructive commands** (`db rm`, `agents destroy`, `sandboxes destroy`, `domains rm`,
-`files rm`) ask before acting in a terminal: `[y/N]`, or typing the name/id for
+**Destructive commands** (every `rm` and `destroy`: `machines rm`, `db rm`, `agents destroy`,
+`sandboxes destroy`, `domains rm`, `files rm`…) ask before acting in a terminal: `[y/N]`, or typing the name/id for
 irreversible ones (a database, an agent, a permanent sandbox). Without a terminal they
 never prompt — and neither do they with `--json`: pass `--yes` / `-y`, or they exit `2`.
 
 **Dry runs.** Writes that change an agent (`agents set`, `files put|rm`, `skills add|rm`,
 `mcp set`, `create`) take `--dry-run`: they print what would change and touch nothing.
 
-**Updates.** Once a day the CLI checks npm and, in a terminal, says on stderr when a newer
+**Updates.** Every hour at most the CLI checks npm and, in a terminal, says on stderr when a newer
 version is out (never with `--json`). `EASYBITS_NO_UPDATE_CHECK=1` or `CI` turns it off.
 
 **Secrets** go in a dotenv file or on stdin, never in argv (visible in `ps` and shell
@@ -173,6 +282,39 @@ Host *.ghosty
 
 Full reference: https://www.easybits.cloud/docs#cli · https://www.easybits.cloud/en/docs/cli.md
 
+## Changes in 0.17.1
+
+- `easybits crons ls|runs|run|pause|resume`: EasyBits' scheduled jobs, the same as the
+  /dash/admin/crons panel (platform admins only; key with the ADMIN scope).
+
+## Changes in 0.17.0
+
+- `sites create --prompt … [--kind webapp|static] [--stack …] [--template …]` and
+  `sites theme get|set <site> [--theme <id> | --colors <file|->]`; a site goes by name or id.
+  Unknown stacks or templates are rejected before calling the API.
+- Machines: `machines get|restart|tiers`, `machines runspec get|set` (merges; `--file` takes the
+  output of `runspec get --json`), `machines backups|backup`, `machines redeploy` (recovery and
+  resize: `--tier … --replace`) and `machines rm` (release). `launch --machine --tier` now points to
+  `machines redeploy`.
+- `easybits secrets ls|set|rm`: your account vault (new REST `GET/POST /api/v2/secrets`,
+  `DELETE /api/v2/secrets/:name`). Values come from a dotenv file or stdin, never argv.
+- Sandboxes: `files rm|mv|mkdir`, `bg start|ls|status|kill` (background processes) and
+  `git clone|status|commit|push|pull|checkout|log` (`--git-token '$secret:NAME'`).
+- `easybits fleet ls|get|capabilities|configure|message`: fleet agents with your account credential.
+- `easybits domains …` now manages your account's domains (`/api/v2/domains`); a sandbox's
+  domains moved to `sandboxes domains` (the old form still works and says so on stderr).
+- `easybits web search|fetch|extract|extract-status|crawl`.
+- `easybits webhooks ls|create|update|rm` and `easybits keys ls|create|revoke` (`keys create` prints
+  the key once). Creating a key now needs WRITE and can't grant more than your own key has.
+- `easybits websites get|files ls|upload|deploy|rm` (`deploy` uploads a whole folder keeping paths).
+- `easybits documents …`: ls, get, create (`--html` per page or a blank `--format`), pages
+  ls|get|set, add-page, rm-page, reorder, deploy, export pdf|png, rm. You write the HTML and set it;
+  no AI generate/refine from the CLI.
+- `easybits video …`: projects ls|get|create|rm, scenes ls|add|set|rm|reorder, music set,
+  render (`--wait`, `--out`, `--timeout`) and ls.
+- `init` defaults to `--app-dir /app`, like `machines launch` (it was `/srv/app`).
+- The update notice checks npm at most once an hour (the docs said once a day).
+
 ## Changes in 0.16.0
 
 - `sites ls`: the sites of the site builder (/dash/sitios) — static sites and web apps,