@ghostystudio/cli 0.9.0 → 0.9.1

package/README.md

@@ -8,24 +8,29 @@ npx -y @ghostystudio/cli login
 npm i -g @ghostystudio/cli && ghosty login
 ```
 
-`ghosty login` opens your browser (OAuth2 + PKCE). If you already have a session on ghosty.studio, opening the link is all it takes. A coding agent can drive it for you: `ghosty login --json` prints `{"event":"login_url","url":…}` first so the agent can hand you the link.
+`ghosty login` opens your browser (OAuth2 + PKCE). If you already have a session on ghosty.studio, opening the link is all it takes. A coding agent can drive it for you: `ghosty login --json` prints `{"event":"login_url","url":…}` first so the agent can hand you the link. Over SSH, CI or from another device, `ghosty login --device` gives you a link + code instead (automatic when there is no local browser).
 
 ## Commands
 
 ```bash
 ghosty whoami
+ghosty usage                                          # plan and usage this week / month (also: ghosty me usage)
 ghosty agents ls
+ghosty agents create --name NAME [--engine E] [--model M] [--prompt TEXT | --prompt-file FILE] [--env K=V,…]
 ghosty agents get <id> [--fields name,model,prompt]
-ghosty agents set <id> [--name] [--model] [--prompt | --prompt-file FILE]
+ghosty agents set <id> [--name] [--engine] [--model] [--prompt | --prompt-file FILE] [--env K=V,…] [--connect ID,…] [--disconnect ID,…]
+ghosty agents rm <id> [--yes]
 ghosty agents restart <id>
+ghosty agents demo <id> [--slug NAME] [--on | --off] [--vence "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]
 ghosty agents set <id> --voice elevenlabs:ID --voice-replies auto --auto-stage on
 
 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]
-ghosty dbs ls|tables|query|import|grant|revoke <id> [db]   [--write] [--external-write t1,t2] [--from easybits:ID --dry-run]
-ghosty turns ls <id>                     [--errors] [--since 1h] [--limit N]
+ghosty dbs ls|tables|query|import|grant|revoke <id> [db]   [--write] [--arg V]… [--external-write t1,t2] [--from easybits:ID --tables a,b --append --dry-run]
+ghosty turns ls <id>                     [--errors | --status running|done|stopped|error] [--since 1h] [--limit N]
 ghosty channels whatsapp ls|enable|disable <id> [number]   [--dry-run]
 ghosty board archive <id>                --integration X | --column X | --before 30d   [--dry-run]
 ghosty mcp get|set <id>                  [--file servers.json]
@@ -43,14 +48,23 @@ ghosty schedule rm <id> <schedule-id>
 ghosty me files ls|upload|rm             [--kind image|video|audio|document|other]
 ghosty credentials ls|set|rm [provider]  [--from-env VAR]   # never as an argument
 ghosty docs
+
+ghosty partner ls|enable|credentials|agent|tenants|audit|try   # one agent for each of YOUR customers: ghosty partner --help
 ```
 
-Global: `--json` (stdout is JSON only), `--token <token>` / `GHOSTY_TOKEN` (a `gat_…` agent token reaches only that agent), `--help`, `--version`.
+Global: `--json` (stdout is JSON only), `--token <token>` / `GHOSTY_TOKEN` (a `gat_…` agent token reaches only that agent), `--profile <name>` / `GHOSTY_PROFILE` (a separate saved session, e.g. one per account), `--yes`, `--help`, `--version`. Env: `GHOSTY_URL`, `XDG_CONFIG_HOME`, `NO_COLOR`; partner commands sign with `GHOSTY_PARTNER_KEY` + `GHOSTY_PARTNER_SECRET` when set.
+
+Aliases: `creds` = `credentials`, `db` = `dbs`, `dbs sql` = `dbs query`.
 
 Every command has its own help with examples: `ghosty <command> --help` or `ghosty help <command>`.
 
 Exit codes: `0` ok · `1` API error · `2` usage error · `3` not signed in.
 
+### Changes in 0.9.1
+
+- `ghosty agents --help` describes every `agents demo` flag; `ghosty usage --help` has its own page.
+- "Learn more" links point to the exact section of https://www.ghosty.studio/docs/cli/comandos; `partner --help` links to /docs/cli/partners.
+
 ### Changes in 0.9.0
 
 - `try --waba`: a test turn through the **real** WhatsApp Business path (inherited context, price rule, board, voice decision). It prints what it would have sent (text, voice note, files) and sends nothing. `--media` for photos/audio/PDF and `--history` to seed what was said before. `--whatsapp` is now an alias.

package/dist/index.js

@@ -282,7 +282,7 @@ async function postLong(path, body, timeoutMs = 9e5) {
     const req = httpsRequest(`${base}${path}`, {
       method: "POST",
       timeout: timeoutMs,
-      headers: { authorization: `Bearer ${token}`, "user-agent": `ghosty-cli/${"0.9.0"}`, "content-type": "application/json", "content-length": Buffer.byteLength(data) }
+      headers: { authorization: `Bearer ${token}`, "user-agent": `ghosty-cli/${"0.9.1"}`, "content-type": "application/json", "content-length": Buffer.byteLength(data) }
     }, (res) => {
       let buf = "";
       res.on("data", (c) => buf += c);
@@ -324,7 +324,7 @@ async function request(path, opts = {}, retried = false) {
     method: opts.method ?? (opts.body !== void 0 || opts.raw !== void 0 ? "POST" : "GET"),
     headers: {
       authorization: `Bearer ${token}`,
-      "user-agent": `ghosty-cli/${"0.9.0"}`,
+      "user-agent": `ghosty-cli/${"0.9.1"}`,
       ...opts.body !== void 0 ? { "content-type": "application/json" } : {},
       ...opts.headers
     },
@@ -744,7 +744,7 @@ async function agentsDemo(id, v) {
   if (v.on) body.enabled = true;
   if (v.off) body.enabled = false;
   if (v.turns) body.maxTurns = Number(v.turns);
-  if (v.hours) body.trialHours = Number(v.hours);
+  if (v.vence !== void 0) body.venceEl = v.vence === "no" ? null : new Date(v.vence).toISOString();
   if (v["per-ip"]) body.perIpDay = Number(v["per-ip"]);
   if (v.welcome !== void 0) body.welcome = v.welcome;
   if (v.chips !== void 0) body.chips = v.chips.split("|").map((c) => c.trim()).filter(Boolean);
@@ -759,7 +759,7 @@ async function agentsDemo(id, v) {
     d,
     () => [
       `${d.enabled ? lavender("\u25CF on") : dim("\u25CB off")}  ${d.url ?? dim("(no link yet: --slug NAME)")}`,
-      dim(`trial: ${d.trialHours} h from the first message \xB7 cap ${d.maxTurns} messages per visitor \xB7 ${d.perIpDay} per IP per day`),
+      dim(`expires: ${d.venceEl ? new Date(d.venceEl).toLocaleString("es-MX") : "never"} \xB7 cap ${d.maxTurns} messages per visitor \xB7 ${d.perIpDay} per IP per day`),
       d.welcome ? `welcome: ${d.welcome}` : dim("welcome: (default greeting)"),
       d.starter ? `starter: \u2728 ${d.starter}` : dim("starter: (none)"),
       d.chips.length ? `chips: ${d.chips.join(" | ")}` : dim("chips: (default)"),
@@ -1069,7 +1069,7 @@ ${bold("Options")}
   --json             Machine-readable output
 
 ${bold("Server credential mode")}  GHOSTY_PARTNER_KEY=gpk_\u2026 GHOSTY_PARTNER_SECRET=gps_\u2026 ghosty partner agent get
-${dim("Docs: https://www.ghosty.studio/docs/cli")}`;
+${dim("Docs: https://www.ghosty.studio/docs/cli/partners")}`;
 var enc5 = encodeURIComponent;
 function partnerCreds() {
   const key = process.env.GHOSTY_PARTNER_KEY;
@@ -1090,7 +1090,7 @@ async function call(path, v, init = {}) {
         "x-ghosty-ts": ts,
         "x-ghosty-sig": sig,
         "content-type": "application/json",
-        "user-agent": `ghosty-cli/${"0.9.0"}`
+        "user-agent": `ghosty-cli/${"0.9.1"}`
       },
       body: method === "GET" ? void 0 : raw
     });
@@ -1537,6 +1537,7 @@ Archive ${plan.matched} card(s) on \xAB${plan.board}\xBB? (reversible: a new mes
 
 // src/help.ts
 var DOCS = "https://www.ghosty.studio/docs/cli";
+var REF = `${DOCS}/comandos`;
 var HELPS = {
   agents: {
     summary: "Create, inspect, change, check and delete agents.",
@@ -1548,7 +1549,7 @@ var HELPS = {
       "ghosty agents doctor <agent-id> [--verbose]",
       "ghosty agents docs ls|grant|revoke <agent-id> [doc] [--write] [--no-deliver]",
       "ghosty agents restart <agent-id>",
-      "ghosty agents demo <agent-id> [--slug NAME] [--on | --off] \u2026",
+      'ghosty agents demo <agent-id> [--slug NAME] [--on | --off] [--vence "YYYY-MM-DDTHH:MM"|no] [--turns N] [--per-ip N] [--welcome TEXT] [--starter TEXT] [--chips "a|b|c"] [--sponsor on|off] [--rotate]',
       "ghosty agents rm <agent-id> [--yes]"
     ],
     flags: [
@@ -1559,17 +1560,28 @@ var HELPS = {
       ["--verbose", "doctor: also list the checks that passed"],
       ["--write", "docs grant: the agent may replace the document (default: read only)"],
       ["--no-deliver", "docs grant: it can read it but never send it to whoever writes"],
-      ["--yes", "rm: skip the confirmation (required without a terminal)"]
+      ["--yes", "rm: skip the confirmation (required without a terminal)"],
+      ["--slug NAME", "demo: link name; a 6-char code is appended (/p/NAME-CODE)"],
+      ["--on | --off", "demo: turn the public link on or off"],
+      ["--vence DATE|no", `demo: fixed expiry in your machine's time ("2026-10-15T20:00"); no = never`],
+      ["--turns N", "demo: messages per visitor (default 150)"],
+      ["--per-ip N", "demo: messages per IP per day (default 30)"],
+      ["--welcome TEXT", "demo: chat greeting (empty = default)"],
+      ["--starter TEXT", 'demo: highlighted first suggestion ("" removes it)'],
+      ['--chips "a|b|c"', "demo: suggestions, separated by |"],
+      ["--sponsor on|off", "demo: copies people keep run on YOUR engine key"],
+      ["--rotate", "demo: new code; the old link stops working"]
     ],
     examples: [
       "ghosty agents doctor cmu7pgbyr0001gee3ruk172mm",
       "ghosty agents set <id> --prompt-file PROMPT.md",
       "ghosty agents set <id> --voice elevenlabs:21m00Tcm4TlvDq8ikWAM --voice-replies auto --auto-stage on",
       'ghosty agents docs grant <id> "Cat\xE1logo 2026.pdf"',
-      "ghosty agents docs grant <id> precios.xlsx --write --no-deliver"
+      "ghosty agents docs grant <id> precios.xlsx --write --no-deliver",
+      'ghosty agents demo <id> --slug guardias --on --vence "2026-10-15T20:00" --starter "Ens\xE9\xF1ame c\xF3mo empezar"'
     ],
-    notes: ["doctor exits 1 when it finds a problem, so it can gate a script or CI."],
-    learn: `${DOCS}#agents`
+    notes: ["doctor exits 1 when it finds a problem, so it can gate a script or CI.", "demo with no flags only prints its status: link, expiry, caps and numbers."],
+    learn: `${REF}#agentes`
   },
   skills: {
     summary: "Skills of an agent (agentskills.io format: a folder with SKILL.md).",
@@ -1592,7 +1604,7 @@ var HELPS = {
       "ghosty skills rm <id> cotizacion        # keeps a local copy first"
     ],
     notes: ["rm saves a copy under ~/.config/ghosty/trash/ and prints the command that restores it."],
-    learn: `${DOCS}#skills`
+    learn: `${REF}#skills`
   },
   dbs: {
     summary: "Databases an agent can use, and what it may write from customer channels.",
@@ -1621,7 +1633,7 @@ var HELPS = {
       "ghosty dbs import <id> totequim --from easybits:6a10c84c\u2026 --dry-run   # reads $EASYBITS_API_KEY"
     ],
     notes: ["<db> is the database id or its name. From owner channels the agent reads and writes everything granted."],
-    learn: `${DOCS}#dbs`
+    learn: `${REF}#bases-de-datos`
   },
   turns: {
     summary: "An agent's recent turns: what answered, what failed and why.",
@@ -1633,19 +1645,19 @@ var HELPS = {
       ["--limit N", "max rows (default 20, max 500)"]
     ],
     examples: ["ghosty turns ls <id> --errors --since 1h", "ghosty turns ls <id> --json --limit 100"],
-    learn: `${DOCS}#turns`
+    learn: `${REF}#turnos`
   },
   files: {
     summary: "Files in the agent's machine.",
     usage: ["ghosty files ls <agent-id> [dir]", "ghosty files get <agent-id> <path> [--out LOCAL]", "ghosty files put <agent-id> <path> [--file LOCAL | < stdin]", "ghosty files rm <agent-id> <path> [--yes]"],
     examples: ["ghosty files put <id> knowledge/precios.md --file precios.md", "cat notas.md | ghosty files put <id> notas.md"],
-    learn: `${DOCS}#files`
+    learn: `${REF}#archivos`
   },
   mcp: {
     summary: "MCP servers of an agent. set REPLACES the whole list.",
     usage: ["ghosty mcp get <agent-id>", "ghosty mcp set <agent-id> --file servers.json"],
     examples: ["ghosty mcp get <id> > servers.json && $EDITOR servers.json && ghosty mcp set <id> --file servers.json"],
-    learn: `${DOCS}#mcp`
+    learn: `${REF}#servidores-mcp`
   },
   try: {
     summary: "Test turns: plain, through the real WhatsApp path (nothing is sent), or a replay of real conversations.",
@@ -1676,25 +1688,25 @@ var HELPS = {
       "Replays survive Ghosty deploys: a 503 is retried after its Retry-After; the report lives on your disk.",
       "--whatsapp is now an alias of --waba."
     ],
-    learn: `${DOCS}#try`
+    learn: `${REF}#turnos-de-prueba`
   },
   chat: {
     summary: "Stream a conversation; with no message it is interactive.",
     usage: ['ghosty chat <agent-id> ["message"] [--conversation ID]', "ghosty conversations ls <agent-id>"],
     examples: ['ghosty chat <id> "hola"', "ghosty chat <id>"],
-    learn: `${DOCS}#chat`
+    learn: `${REF}#conversaciones`
   },
   schedule: {
     summary: "Turns that run later, on the agent's own clock.",
     usage: ['ghosty schedule add <agent-id> "what to do" --in 30m | --at ISO [--every 12h --until ISO] [--conversation ID] [--title T]', "ghosty schedule ls <agent-id>", "ghosty schedule rm <agent-id> <schedule-id>"],
     examples: ['ghosty schedule add <id> "revisa pedidos pendientes" --every 12h --in 1h'],
-    learn: `${DOCS}#schedule`
+    learn: `${REF}#programar-turnos`
   },
   me: {
     summary: "Your account: files and usage.",
     usage: ["ghosty me files ls|upload|rm [--kind image|video|audio|document|other]", "ghosty usage"],
     examples: ["ghosty me files ls --kind document"],
-    learn: `${DOCS}#me`
+    learn: `${REF}#tu-cuenta`
   }
 };
 HELPS.credentials = {
@@ -1710,7 +1722,7 @@ HELPS.credentials = {
     "op read op://vault/claude/token | ghosty credentials set anthropic-oauth"
   ],
   notes: ["The key is never accepted as an argument: it would stay in your shell history and in `ps`."],
-  learn: `${DOCS}#credentials`
+  learn: `${REF}#credenciales`
 };
 HELPS.creds = HELPS.credentials;
 HELPS.channels = {
@@ -1722,7 +1734,7 @@ HELPS.channels = {
   ],
   examples: ["ghosty channels whatsapp ls <id>", "ghosty channels whatsapp enable <id> 5512345678 --dry-run", "ghosty channels whatsapp disable <id> 5512345678"],
   notes: ["<number> is its id, its label or its last digits. One number, one agent: enabling it takes it from the other agent.", "Disabling keeps logging messages; nobody answers them."],
-  learn: `${DOCS}#channels`
+  learn: `${REF}#canales-de-whatsapp`
 };
 HELPS.board = {
   summary: "The agent's sales board. It belongs to the WORKSPACE: you must be a member, a shared agent is not enough.",
@@ -1736,10 +1748,10 @@ HELPS.board = {
   ],
   examples: ["ghosty board archive <id> --integration prueba --dry-run", "ghosty board archive <id> --column Perdido --before 30d --yes"],
   notes: ["Archiving is reversible: when the customer writes again the card comes back. At least one filter is required."],
-  learn: `${DOCS}#board`
+  learn: `${REF}#tablero`
 };
 HELPS.conversations = HELPS.chat;
-HELPS.usage = HELPS.me;
+HELPS.usage = { ...HELPS.me, summary: "Your plan and how much you've used this week and month.", usage: ["ghosty usage", "ghosty me usage"], examples: ["ghosty usage", "ghosty usage --json"], learn: `${REF}#uso` };
 function helpText(cmd) {
   const h = HELPS[cmd];
   if (!h) return void 0;
@@ -1780,7 +1792,7 @@ ${bold("Agents")}
   agents rm <id>            Delete an agent (owner only; asks you to type its name, or --yes)
   agents restart <id>       Restart an ACP agent (needsRestart) so it loads new skills
   agents demo <id>          Public demo link /p/<slug>: anyone tries it without an account, "Keep it" clones it to theirs
-                            [--slug NAME] [--on | --off] [--hours N] [--turns N] [--per-ip N] [--welcome TEXT] [--chips "a|b|c"] [--starter TEXT] [--sponsor on|off] [--rotate]
+                            [--slug NAME] [--on | --off] [--vence "YYYY-MM-DDTHH:MM"|no] [--turns N] [--per-ip N] [--welcome TEXT] [--chips "a|b|c"] [--starter TEXT] [--sponsor on|off] [--rotate]
 
 ${bold("Configure an agent")}
   files ls|get|put|rm <id> [path]    Files in the agent's machine   [--file LOCAL] [--out LOCAL]
@@ -1881,7 +1893,7 @@ async function main() {
       on: { type: "boolean" },
       off: { type: "boolean" },
       turns: { type: "string" },
-      hours: { type: "string" },
+      vence: { type: "string" },
       "per-ip": { type: "string" },
       welcome: { type: "string" },
       chips: { type: "string" },
@@ -1917,7 +1929,7 @@ async function main() {
   const tokens = splitTokens(pos, v);
   globals.token = tokens.session;
   globals.profile = v.profile;
-  if (v.version) return out({ version: "0.9.0" }, () => "0.9.0");
+  if (v.version) return out({ version: "0.9.1" }, () => "0.9.1");
   const [cmd, sub, a1, a2] = pos;
   if (cmd === "partner" && (v.help || !sub || sub === "help")) return out({ help: PARTNER_HELP }, () => PARTNER_HELP);
   const topic = cmd === "help" ? sub : v.help ? cmd : void 0;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ghostystudio/cli",
-  "version": "0.9.0",
+  "version": "0.9.1",
   "description": "Official Ghosty Studio CLI — configure, test and chat with your agents from the terminal. Built for humans and coding agents.",
   "type": "module",
   "bin": {