@ghostystudio/cli 0.68.0 → 0.70.0

package/README.md

@@ -13,9 +13,12 @@ npm i -g @ghostystudio/cli && ghosty login
 ## Commands
 
 ```bash
+ghosty login [--device] [--profile NAME]              # browser OAuth2; --device = link + code (SSH, CI)
+ghosty logout                                         # signs out and revokes this device's session
 ghosty whoami
 ghosty usage                                          # plan and usage this week / month (also: ghosty me usage)
 ghosty usage --workspace SLUG [--by agent,day] [--days 14]   # a workspace's turns and tokens per agent/day (owner or staff)
+ghosty plan open [workspace|personal]                # pay, change plan or manage billing (opens the browser)
 ghosty engines ls [--models]                          # valid --engine / --model values and what each model costs
 ghosty bags ls|create|set|rm <workspace> ["bag"]      [--tokens 20M] [--recurring on|off] [--hard-cap on|off] [--note]   # token bags (changing: staff)
 ghosty spaces create <slug>                          [--combo …: staff] [--dry-run]   # yours, trial
@@ -32,6 +35,9 @@ ghosty agents set <id> --prompt-base <base-id> --prompt-overlay overlay.json [--
 ghosty agents share|unshare <id> <email> [--role editor|admin]   # share without handing it over · agents shares <id> lists them
 ghosty agents teams ls|on|off|rm <id> [workspace] [--handle x]   # which Teams workspaces it answers in, and its @handle there
 ghosty agents archive|restore <id>                # archive: stops answering, deleted after 7 days unless restored
+ghosty agents token rotate|revoke <id> [--yes]    # owner only: rotate prints the new gat_ token once
+ghosty agents memory ls|add|edit|rm|enable|disable <id> …   # rules its team taught it (--scope wa) and its promos (--promo --title --details --from --until)
+ghosty agents transfer <id> --to EMAIL [--workspace SLUG] [--dry-run]   # hand it over with box, memory and files · --workspace SLUG|none: move it between your workspaces
 ghosty agents rm <id> [--from-workspace] [--yes]   # --from-workspace: turn it off in Teams first
 ghosty agents set <id> [--tool wa:tool=off,…] [--bag NAME|none] [--avatar URL|FILE]
 ghosty agents restart <id>
@@ -50,6 +56,8 @@ ghosty agents doctor <id> [--verbose]                 # exits 1 when it finds a
 ghosty agents docs ls|grant|revoke <id> [doc]         [--write] [--no-deliver]
 ghosty agents docs add <id> --url URL | --file PATH   [--description TEXT] [--grant read|write|no]
 ghosty agents set <id> --voice elevenlabs:ID --voice-replies auto --auto-stage on
+ghosty agents set <id> --web-search on|off --email-any on|off --extensions developer=off,…   # native web search · email anyone from customer channels · its box's extensions
+ghosty agents set <id> --chat-starters "a|b" --channel-roles teams=equipo,programado=cliente   # suggestions in its OWN chat (the widget's are embed --starters) · who talks on each channel
 
 ghosty files ls|get|put|rm <id> [path]   [--file LOCAL] [--out LOCAL]
 ghosty skills ls|get|add|rm <id> [slug]  [--file SKILL.md | --dir FOLDER] [--out DIR]   # get without --out only lists
@@ -60,9 +68,11 @@ ghosty turns ls <id>                     [--errors | --status running|done|stopp
 ghosty turns ls --workspace SLUG --quota-hits [--days 14]   # messages that got no turn because the balance ran out
 ghosty turns show <id> [turn-id|last]    # what came in, what it answered, where the time went   [--full]
 ghosty turns grep <id> "text"           # what the customer or the agent said, and its turn   [--since 7d] [--role user|agent]
+ghosty turns jobs <id>                   # its background jobs from your chats (video, audio, captions, downloads; 24 h) · stop: turns cancel
 ghosty channels whatsapp ls|enable|disable <id> [number]   [--dry-run]
 ghosty channels whatsapp link|unlink <id> --integration ID --answer on|off   [--forward] [--dry-run]   # bring a WABA number from Formmy
 ghosty channels whatsapp history <id> --integration ID [--days 7]   [--dry-run]   # its recent cards, messages and orders (no duplicates)
+ghosty channels whatsapp|messenger connect <id>   # opens Channels to connect with Meta (browser sign-in)
 ghosty channels wa import <id> --from-file F | --from-dir DIR --own-number yes|no   [--dry-run]   # personal WhatsApp session, no QR
 ghosty channels wa pair|status|pause <id>   [--phone N]
 ghosty channels wa groups ls|enable|disable|set|create <id> [group]   [--role equipo|cliente] [--wake mention|all] [--dry-run]   # personal WhatsApp groups
@@ -73,6 +83,7 @@ ghosty cards ls <id>                     [--q TEXT] [--limit 20]              #
 ghosty cards show <id> <folio|phone|id>  [--limit 20]                         # a card's thread, attachments and whether gs kept a copy
 ghosty cards archive <id>                --integration X | --column X | --before 30d   [--dry-run]
 ghosty mcp get|set <id>                  [--file servers.json]               # http headers accept ${turn.token} (per-turn key)
+ghosty mcp connect <id> --name N --url https://…  [--from-env VAR] [--no-open]   # one remote MCP by URL; OAuth in the browser if it asks
 
 ghosty try <id> "message"                [--session] [--reset]
 ghosty try <id> "message" --waba --session PHONE [--media FILE [--as-formmy]] [--history FILE]   # real WhatsApp path, nothing sent
@@ -80,6 +91,9 @@ ghosty try <id> --replay FILE --out DIR  [--max 15] [--concurrency 8] [--resume]
 ghosty chat <id> ["message"]             [--conversation ID]
 ghosty conversations ls <id>
 ghosty conversations show <id> <conversation-id> [--limit 20]   # what was said
+ghosty conversations continue|model|share <id> <conversation-id> [model] [--off]   # new linked thread · its model · read-only link
+ghosty conversations permission <id> <conversation-id> [allow|deny] [--id P] [--always]   # what the turn waits for, and answer it
+ghosty conversations subagents <id> <conversation-id> [stop <task-id>]   # its native subagents
 
 ghosty schedule add <id> "what to do"    --in 30m | --at ISO  [--every 12h --until ISO] [--conversation ID] [--title T]
 ghosty schedule ls <id>
@@ -89,16 +103,24 @@ ghosty teams post <workspace>#<room>[/<thread-id>] "msg" [--wait]   # write ther
 
 ghosty me files ls|get|export|upload|rm  [--q TEXT] [--kind image|video|audio|document|other] [--cursor C]
 ghosty me memories ls|add|edit|rm
+ghosty me docs ls|get|export|check|tts|restore <doc>   # editable docs your agents delivered: versions, PDF/Markdown, spelling, read aloud   [--rev N]
 ghosty conversations archive|rm <id> --kind test|channel|personal [--before 7d] [--dry-run]
 ghosty agents docs dedupe [--dry-run]    # your account: merge documents with the same content
 # Ghosty staff
 ghosty conversations ls --user EMAIL [--since 30d] · conversations show <id> <conv> --why|--tools
 ghosty turns stats [--since 14d] [--all] · push log --user EMAIL [--since 2d]
+ghosty support ls|show|reply --all [--status open|waiting_customer|resolved] · support resolve|reopen <id> · support link <id> <issue|PR>
+ghosty staff ls [staff] [client] [--all] · staff assign|unassign <staff> <client> [--reason]   # staff on client accounts (logged)
+ghosty settings ls|set|unset <KEY> [value]   # platform switches (+id/-id edits a list)
 ghosty agents doctor --user EMAIL [agent] [--turns 8] · usage --images [--plan free] [--by user]
 ghosty novedades ls|create|set|test|send|rm   [--title] [--body] [--image FILE] [--link] [--to] [--publish] [--at]
 ghosty sites ls [--house] · sites publish <file.html|folder> [--title] [--slug S] [--site <slug|id>] · sites slug <slug|id> <new-slug>   # house sites on EasyBits
 ghosty credentials ls|set|rm [provider]  [--from-env VAR]   # never as an argument
 ghosty connectors ls|connect|disconnect [id]  [--q TEXT] [--from-env VAR] [--no-open]   # Shopify, Stripe, monday…
+ghosty support open --title T --body TEXT · support ls | show <id> | reply <id> --body TEXT   # ask Ghosty for help; answered by email
+ghosty browser logout                    # revoke your terminal agents' browser tokens and disconnect Ghosty for Chrome
+ghosty audit ls [--workspace SLUG] [--agent ID] [--actor EMAIL] [--action A] [--since 24h] [--limit N]   # who changed what
+ghosty factory runs ls|show|why|stats|rename [--workspace SLUG] [--room R] [--status S] [show --timing] [why --refresh]   # Software Factory runs
 ghosty docs
 
 ghosty partner ls|enable|credentials|agent|tenants|audit|try   # one agent for each of YOUR customers: ghosty partner --help
@@ -114,6 +136,21 @@ Every command has its own help with examples: `ghosty <command> --help` or `ghos
 
 Exit codes: `0` ok · `1` API error · `2` usage error · `3` not signed in.
 
+### Changes in 0.70.0
+
+- `agents set --web-search on|off`, `--chat-starters "a|b"` (suggestions in the agent's OWN chat; the widget's stay in `agents embed --starters`, and `agents set --starters` now says so), `--channel-roles teams=equipo,programado=cliente`, `--extensions developer=off` and `--email-any on|off` (owner only).
+- `mcp connect <id> --name N --url https://… [--from-env VAR] [--no-open]`: one remote MCP by its URL, without writing servers.json; if it asks for OAuth, the sign-in opens in the browser and gs adds it when you finish.
+- `conversations continue|model|permission|share|subagents <id> <conv>`: carry on in a new linked thread, change its model, answer a permission the turn is waiting for (`allow|deny`, `--always`, `--id`), share it read-only (`--off`), list or stop native subagents. `chat` now prints each permission request with the command to answer it.
+- `turns jobs <id>`: background jobs from your chats (video, audio, captions, downloads; 24 h). Read-only: stop them with `turns cancel`; repeating work is `schedule --every`.
+- `me docs ls|get|export|check|tts|restore <doc>`: the editable docs your agents deliver (id or /app/docs/… link): versions, PDF/Markdown, spelling, read aloud.
+- `agents token rotate|revoke <id>` (owner only), `agents memory …` (its team's rules and its promos) and `agents transfer <id> --to EMAIL | --workspace SLUG|none [--dry-run]`, on new `api/v2` routes.
+- `channels whatsapp|messenger connect <id>` and `plan open [workspace|personal]` open the right page in the browser (Meta sign-in and billing stay on the web).
+- README: login/logout, support, browser, audit, factory, staff and settings were missing.
+
+### Changes in 0.69.0
+
+- `factory runs why` puts an unmet plan criterion on top (`approved_unmet_criterion`): approved without the preview a criterion asked for, merged without preview, smoke failed on the merged commit, or a CI criterion approved with CI `none`. Each one is listed with the criterion's text and the evidence (`acceptance[]` in `--json`). A saved analysis is redone if the run had events after it.
+
 ### Changes in 0.68.0
 
 - New `spaces members ls|add|rm <workspace> [email]`: a workspace's people without the Members screen (owner, admin or staff). `--role admin` lets them invite and remove; `--until 2026-10-28` or `--until 14d` gives a temporary seat that is removed automatically — for reviewer accounts (Meta, Google, Apple).
@@ -169,7 +206,7 @@ Exit codes: `0` ok · `1` API error · `2` usage error · `3` not signed in.
 
 ### Changes in 0.56.0
 
-- `factory runs why <run> [--refresh]`: why a run got stuck or failed — category, impact, the critical step with its evidence and what to change next time (a healthy run doesn't call the model).
+- `factory runs why <run> [--refresh]`: why a run got stuck or failed — category, impact, the critical step with its evidence and what to change next time (a healthy run doesn't call the model). It first checks the approved plan's criteria against the verdict: a criterion "in the preview" approved without the preview ready comes out on top as `approved_unmet_criterion`.
 - `factory runs show --timing` lists stuck patterns (a command open 8+ min, the same command repeated, errors in a row, going back and forth, apt install in a box); `runs stats` counts runs with stuck alerts.
 
 ### Changes in 0.55.0