@ghostystudio/cli 0.17.0 → 0.19.0

package/README.md

@@ -18,13 +18,16 @@ ghosty usage                                          # plan and usage this week
 ghosty agents ls
 ghosty agents create --name NAME [--engine E] [--model M] [--prompt TEXT | --prompt-file FILE] [--env K=V,…] [--workspace SLUG] [--channels teams=off]
 ghosty agents get <id> [--fields name,model,prompt] [--prompt-out FILE]
+ghosty agents export <id> [--out DIR]    # the agent as a YAML file (+ its skills with --out)
+ghosty apply <file|dir> [--agent X] [--create] [--prune] [--dry-run]   # make an agent match the file
 ghosty agents set <id> [--name] [--engine] [--model] [--prompt | --prompt-file FILE] [--env K=V,…] [--connect ID,…] [--disconnect ID,…] [--toolsets +crm]
 ghosty agents set <id> --prompt-base <base-id> --prompt-overlay overlay.json [--dry-run]   # prompt = another agent's + edits, kept in sync
 ghosty agents share|unshare <id> <email> [--role editor|admin]   # share without handing it over · agents shares <id> lists them
 ghosty agents rm <id> [--yes]
 ghosty agents restart <id>
 ghosty agents box <id> [--check PATH]… [--contains PATH=TEXT]… [--recycle]   # is its machine on the new image?
-ghosty agents demo <id> [--slug NAME] [--on | --off] [--vence "YYYY-MM-DDTHH:MM"|no] [--turns N] [--per-ip N]
+ghosty agents demo enable|disable <id>
+ghosty agents demo <id> [--slug NAME] [--expires "YYYY-MM-DDTHH:MM"|no] [--turns N] [--per-ip N]
                         [--welcome TEXT] [--starter TEXT] [--chips "a|b|c"] [--sponsor on|off] [--rotate]   # public /p/ link, no account needed
 ghosty agents doctor <id> [--verbose]                 # exits 1 when it finds a problem
 ghosty agents docs ls|grant|revoke <id> [doc]         [--write] [--no-deliver]
@@ -33,7 +36,7 @@ ghosty agents set <id> --voice elevenlabs:ID --voice-replies auto --auto-stage o
 
 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
-ghosty skills on|off <id> <slug>         # turn one of its skills (or one of Ghosty's) on or off
+ghosty skills enable|disable <id> <slug> # turn one of its skills (or one of Ghosty's) on or off
 ghosty skills templates <id>             # pdf-doc templates: its own and Ghosty's, and which folder wins
 ghosty dbs ls|tables|query|import|grant|revoke <id> [db]   [--write] [--arg V]… [--external-write t1,t2] [--external-rows t:col+col] [--from easybits:ID --tables a,b --append --dry-run]
 ghosty turns ls <id>                     [--errors | --status running|done|stopped|error] [--since 1h] [--limit N]
@@ -43,11 +46,11 @@ ghosty channels whatsapp link|unlink <id> --integration ID --answer on|off   [--
 ghosty channels whatsapp history <id> --integration ID [--days 7]   [--dry-run]   # its recent cards, messages and orders (no duplicates)
 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|set|create <id> [group]      [--role equipo|cliente] [--on|--off] [--dry-run]   # personal WhatsApp groups
+ghosty channels wa groups ls|enable|disable|set|create <id> [group]   [--role equipo|cliente] [--dry-run]   # personal WhatsApp groups
 ghosty boards ls|create|assign|move-cards|rm <workspace|agent> …   [--columns-from main] [--from A --to B --integration X --dry-run]
-ghosty board ls <id>                     [--q TEXT] [--limit 20]              # recent cards on its sales board
-ghosty board show <id> <folio|phone|id>  [--limit 20]                         # a card's thread, attachments and whether gs kept a copy
-ghosty board archive <id>                --integration X | --column X | --before 30d   [--dry-run]
+ghosty cards ls <id>                     [--q TEXT] [--limit 20]              # recent cards on its sales board
+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]
 
 ghosty try <id> "message"                [--session] [--reset]
@@ -87,6 +90,15 @@ Exit codes: `0` ok · `1` API error · `2` usage error · `3` not signed in.
 - `try --replay FILE --out DIR`: replays real conversations from your machine. The report is written after every step, survives Ghosty deploys (it honors `Retry-After`), and `--resume` continues a partial run.
 - `agents doctor` speaks English like the rest of the CLI; `channels whatsapp ls` returns a full URL.
 
+### Changes in 0.19.0
+
+- **The agent as a file.** `ghosty agents export <agent> [--out DIR]` writes its whole setup as YAML (recipe-compatible, secrets as `${NAME}`; with `--out`, its own skills too). `ghosty apply <file|dir>` shows a plan (`+ ~ - !`), asks and applies; `--agent X` targets another agent, `--create` makes a new one, `--prune` also removes what the file no longer lists. The current version is saved before applying.
+
+### Changes in 0.18.0
+
+- One naming rule (like `gh`): noun then verb; turning things on/off is `enable|disable`; `on|off` only as a flag value. `ghosty cards` (an agent's board cards; `board` still works), `skills enable|disable`, `agents demo enable|disable <agent>`, `channels wa groups enable|disable <agent> <group>`, `--expires` (was `--vence`). Old forms still work and print the new one.
+- Help for `login`, `logout`, `whoami`, `docs`, `use` and `cards`.
+
 ### Changes in 0.17.0
 
 - Agents by **name** everywhere: `ghosty agents get pia-0`, `ghosty try "Ghosty Ventas" "hola"` (ids still work). Same-name agents: the one in the `ghosty use` workspace wins, otherwise the CLI lists their ids.