@ghostystudio/cli 0.16.1 → 0.18.0

package/README.md

@@ -24,7 +24,8 @@ ghosty agents share|unshare <id> <email> [--role editor|admin]   # share without
 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 +34,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 +44,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 +88,16 @@ 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.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.
+- `ghosty use <workspace>`: default workspace for `boards`, `agents create` and `agents ls` (`--all`, `--workspace none`, `use --clear`).
+
 ### Changes in 0.16.1
 
 - `agents create --like`: `--board same|main|new|NAME` (`new` = its own board with the source's columns, one per number) and `--no-notify` (shared with the same people, no email).

package/dist/index.js

@@ -288,7 +288,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.16.1"}`, "content-type": "application/json", "content-length": Buffer.byteLength(data) }
+      headers: { authorization: `Bearer ${token}`, "user-agent": `ghosty-cli/${"0.18.0"}`, "content-type": "application/json", "content-length": Buffer.byteLength(data) }
     }, (res) => {
       let buf = "";
       res.on("data", (c) => buf += c);
@@ -330,7 +330,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.16.1"}`,
+      "user-agent": `ghosty-cli/${"0.18.0"}`,
       ...opts.body !== void 0 ? { "content-type": "application/json" } : {},
       ...opts.headers
     },
@@ -529,17 +529,21 @@ var need = (v, what, example) => {
   if (!v) throw usage(`Missing ${what}.`, `Example: ${example}`);
   return v;
 };
-async function agentsLs() {
+async function agentsLs(workspace) {
   const r = await api("/api/v2/me/agents?client=cli");
-  const rows = r.agentes.map((a) => ({
+  const list = workspace ? r.agentes.filter((a) => a.espacio?.nombre === workspace) : r.agentes;
+  const spaceOf = (a) => a.espacio?.tipo === "workspace" ? a.espacio.nombre : a.espacio?.tipo ?? "";
+  const rows = list.map((a) => ({
     id: a.id,
     name: a.nombre,
     engine: a.motor ?? a.origen,
     source: a.origen,
+    workspace: spaceOf(a),
     lastActivity: a.ultimaActividad ?? null,
     ...a.compartidoPor ? { sharedBy: a.compartidoPor } : {}
   }));
-  out(rows, () => table(rows, ["id", "name", "engine", "lastActivity"]));
+  out(rows, () => `${table(rows, ["id", "name", "engine", "workspace", "lastActivity"])}${workspace ? `
+${dim(`only ${workspace} (ghosty use) \xB7 all: --all`)}` : ""}`);
 }
 function parseEnv(raw) {
   if (!raw) return void 0;
@@ -1269,7 +1273,7 @@ async function call(path, v, init = {}) {
         "x-ghosty-ts": ts,
         "x-ghosty-sig": sig,
         "content-type": "application/json",
-        "user-agent": `ghosty-cli/${"0.16.1"}`
+        "user-agent": `ghosty-cli/${"0.18.0"}`
       },
       body: method === "GET" ? void 0 : raw
     });
@@ -2002,7 +2006,11 @@ Archive ${plan.matched} card(s) on \xAB${plan.board}\xBB? (reversible: a new mes
 
 // src/commands/boards.ts
 var enc8 = encodeURIComponent;
-async function boardsCmd(sub, a1, a2, v) {
+async function boardsCmd(sub, a1, a2, v, context) {
+  if (context && sub !== "assign") {
+    if ((sub === "ls" || sub === "list" || !sub || sub === "move-cards") && !a1) a1 = context;
+    else if ((sub === "create" || sub === "rm") && a1 && !a2) [a1, a2] = [context, a1];
+  }
   switch (sub ?? "ls") {
     case "ls":
     case "list": {
@@ -2071,7 +2079,8 @@ var HELPS = {
       "ghosty agents shares <agent-id>",
       "ghosty agents restart <agent-id>",
       "ghosty agents box <agent-id> [--check PATH]\u2026 [--contains PATH=TEXT]\u2026 [--recycle]",
-      '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 demo enable|disable <agent-id>",
+      'ghosty agents demo <agent-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]',
       "ghosty agents rm <agent-id> [--yes]"
     ],
     flags: [
@@ -2097,8 +2106,7 @@ var HELPS = {
       ["--role R", "share: editor (configures and uses it) or admin (also shares it); again on a shared email changes the role"],
       ["--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`],
+      ["--expires 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)"],
@@ -2125,7 +2133,8 @@ var HELPS = {
       "ghosty agents create --name tania-mkt --like <pia-id> --board new --no-notify --dry-run",
       'ghosty agents docs grant <id> "Cat\xE1logo.pdf" "Precios.xlsx"   \xB7   ghosty agents docs grant <id> --like <other-id>',
       "ghosty agents set <pia-id> --prompt-base <tania-id> --prompt-overlay capa.json --dry-run --out /tmp/pia.md",
-      'ghosty agents demo <id> --slug guardias --on --vence "2026-10-15T20:00" --starter "Ens\xE9\xF1ame c\xF3mo empezar"',
+      "ghosty agents demo enable <id>",
+      'ghosty agents demo <id> --slug guardias --expires "2026-10-15T20:00" --starter "Ens\xE9\xF1ame c\xF3mo empezar"',
       "ghosty agents box <id> --contains /opt/claude-worker/skills/pdf-doc/render-doc.mjs=pdf-templates"
     ],
     notes: ["doctor exits 1 when it finds a problem, so it can gate a script or CI.", "A derived prompt can't be edited directly (409): change the base or the overlay, or unlink it with --prompt-base none.", "demo with no flags only prints its status: link, expiry, caps and numbers."],
@@ -2135,7 +2144,7 @@ var HELPS = {
     summary: "Skills of an agent (agentskills.io format: a folder with SKILL.md).",
     usage: [
       "ghosty skills ls <agent-id>",
-      "ghosty skills on|off <agent-id> <slug>",
+      "ghosty skills enable|disable <agent-id> <slug>",
       "ghosty skills house <agent-id> [--only a,b | --enable a,b | --disable a,b] [--dry-run]",
       "ghosty skills get <agent-id> <slug> [--out DIR]",
       "ghosty skills templates <agent-id>",
@@ -2300,14 +2309,14 @@ HELPS.channels = {
     "ghosty channels wa pair <agent-id> --phone 5215512345678",
     "ghosty channels wa status|pause <agent-id>",
     "ghosty channels wa groups ls <agent-id> [--cached]",
-    "ghosty channels wa groups set <agent-id> <group> [--role equipo|cliente] [--on | --off] [--dry-run] [--yes]",
+    "ghosty channels wa groups enable|disable <agent-id> <group> [--role equipo|cliente] [--dry-run] [--yes]",
+    "ghosty channels wa groups set <agent-id> <group> --role equipo|cliente [--dry-run]",
     'ghosty channels wa groups create <agent-id> "Name" [--role equipo|cliente]'
   ],
   flags: [
     ["-n, --dry-run", "print the plan (+ starts answering, - stops) and change nothing"],
-    ["--yes", "enable / groups set --on: skip the confirmation (required without a terminal)"],
+    ["--yes", "enable / groups enable: skip the confirmation (required without a terminal)"],
     ["--role R", "groups: equipo (the team: writes to databases, admin tools) or cliente (like any customer)"],
-    ["--on | --off", "groups set: the agent answers in that group, or stops"],
     ["--cached", "groups ls: don't ask WhatsApp for the live list (faster; may miss new groups)"],
     ["--integration ID", "link/unlink/history: the WhatsApp Business number's Integration id in Formmy"],
     ["--days N", "history: conversations active in the last N days (1-30, default 7)"],
@@ -2324,7 +2333,7 @@ HELPS.channels = {
     "ghosty channels whatsapp enable <id> 5512345678 --dry-run",
     "ghosty channels whatsapp disable <id> 5512345678",
     "ghosty channels wa groups ls <id>",
-    'ghosty channels wa groups set <id> "Pia-cotizadora" --role equipo --on --dry-run',
+    'ghosty channels wa groups enable <id> "Pia-cotizadora" --role equipo --dry-run',
     "ghosty channels whatsapp link <id> --integration 6a3af395\u2026 --answer off --dry-run",
     "ghosty channels whatsapp history <id> --integration 6a3af395\u2026 --days 7 --dry-run",
     "ghosty channels wa import <id> --from-file pia-wa.json --own-number no --dry-run"
@@ -2339,6 +2348,24 @@ HELPS.channels = {
   ],
   learn: `${REF}#canales-de-whatsapp`
 };
+HELPS.login = {
+  summary: "Sign in with your browser (OAuth2, no password here). An agent can run it for you: it prints the URL and waits.",
+  usage: ["ghosty login", "ghosty login --device"],
+  flags: [["--device", "sign in from another device with a link + code (automatic over SSH or CI)"], ["--profile NAME", "a separate saved session, e.g. one per account"]],
+  examples: ["ghosty login", "ghosty login --profile cliente", "GHOSTY_TOKEN=gat_\u2026 ghosty agents get <id>   # no login: an agent token"],
+  learn: `${REF}#sesion`
+};
+HELPS.logout = { summary: "Sign out and revoke this device's session on the server.", usage: ["ghosty logout [--profile NAME]"], examples: ["ghosty logout"], learn: `${REF}#sesion` };
+HELPS.whoami = { summary: "Who you are signed in as (with --json, also your account's plan).", usage: ["ghosty whoami [--json]"], examples: ["ghosty whoami"], learn: `${REF}#sesion` };
+HELPS.docs = { summary: "Open the docs in your browser (with --json, just print the URL).", usage: ["ghosty docs [topic]"], examples: ["ghosty docs", "ghosty docs cli"], learn: REF };
+HELPS.use = {
+  summary: "A default workspace for this session (profile): boards take it without typing it, agents create is born there and agents ls lists only its agents.",
+  usage: ["ghosty use                 # which one", "ghosty use <workspace>", "ghosty use --clear"],
+  flags: [["--clear", "no default workspace"]],
+  examples: ["ghosty use siiqtec", "ghosty boards ls", "ghosty agents create --name tania-mkt --like pia-0 --board new", "ghosty agents ls --all"],
+  notes: ["Agents can be named instead of using their id anywhere; with several of the same name, the one in this workspace wins.", "agents create --workspace none makes a personal agent even with a default workspace."],
+  learn: `${REF}#sesion`
+};
 HELPS.boards = {
   summary: "A WORKSPACE's sales boards: list them, create one (copying another's columns), choose where an agent sends its cards, and move cards between boards.",
   usage: [
@@ -2359,12 +2386,12 @@ HELPS.boards = {
   notes: ["assign changes where NEW cards go; move-cards brings the existing ones (thread, orders, activity) with a new folio. A card whose conversation is already on the target board is skipped.", "Reading needs membership; changing needs owner or staff of the workspace.", "rm only deletes an empty board that is not the main one."],
   learn: `${REF}#tablero`
 };
-HELPS.board = {
-  summary: "The agent's sales board. It belongs to the WORKSPACE: you must be a member, a shared agent is not enough.",
+HELPS.cards = {
+  summary: "The cards on an agent's sales board (its board belongs to the WORKSPACE: you must be a member, a shared agent is not enough). The workspace's boards themselves: ghosty boards.",
   usage: [
-    "ghosty board ls <agent-id> [--q TEXT] [--limit 20]",
-    "ghosty board show <agent-id> <folio|phone|session|id> [--limit 20]",
-    "ghosty board archive <agent-id> [--integration ID] [--column NAME] [--before 30d|ISO] [--dry-run] [--yes]"
+    "ghosty cards ls <agent-id> [--q TEXT] [--limit 20]",
+    "ghosty cards show <agent-id> <folio|phone|session|id> [--limit 20]",
+    "ghosty cards archive <agent-id> [--integration ID] [--column NAME] [--before 30d|ISO] [--dry-run] [--yes]"
   ],
   flags: [
     ["--q TEXT", "ls: cards whose name, phone or last message contains TEXT"],
@@ -2375,10 +2402,11 @@ HELPS.board = {
     ["-n, --dry-run", "count and show a sample, change nothing"],
     ["--yes", "skip the confirmation (required without a terminal)"]
   ],
-  examples: ["ghosty board ls <id> --q 7712", 'ghosty board show <id> "#12"', "ghosty board show <id> 5210000009922 --limit 50", "ghosty board archive <id> --integration prueba --dry-run", "ghosty board archive <id> --column Perdido --before 30d --yes"],
+  examples: ["ghosty cards ls <id> --q 7712", 'ghosty cards show <id> "#12"', "ghosty cards show <id> 5210000009922 --limit 50", "ghosty cards archive <id> --integration prueba --dry-run", "ghosty cards archive <id> --column Perdido --before 30d --yes"],
   notes: ["show prints each message with who wrote it (customer, agent, operator), its attachment and whether gs keeps a copy of it.", "Archiving is reversible: when the customer writes again the card comes back. At least one filter is required."],
   learn: `${REF}#tablero`
 };
+HELPS.board = HELPS.cards;
 HELPS.conversations = HELPS.chat;
 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) {
@@ -2414,28 +2442,84 @@ function newer(a, b) {
 }
 async function latestVersion() {
   if (process.env.GHOSTY_NO_UPDATE_CHECK || process.env.CI) return null;
-  let cache = {};
+  let cache2 = {};
   try {
-    cache = JSON.parse(await readFile9(FILE, "utf8"));
+    cache2 = JSON.parse(await readFile9(FILE, "utf8"));
   } catch {
   }
-  if (!cache.checkedAt || Date.now() - cache.checkedAt > DAY) {
+  if (!cache2.checkedAt || Date.now() - cache2.checkedAt > DAY) {
     try {
       const r = await fetch("https://registry.npmjs.org/@ghostystudio/cli/latest", { signal: AbortSignal.timeout(1500) });
       const latest = (await r.json()).version;
-      if (latest) cache = { latest, checkedAt: Date.now() };
+      if (latest) cache2 = { latest, checkedAt: Date.now() };
       await mkdir4(dirname3(FILE), { recursive: true });
-      await writeFile4(FILE, JSON.stringify(cache));
+      await writeFile4(FILE, JSON.stringify(cache2));
     } catch {
     }
   }
-  return cache.latest ?? null;
+  return cache2.latest ?? null;
 }
 async function updateNotice(current) {
   const latest = await latestVersion();
   return latest && newer(latest, current) ? `Update available: ${current} \u2192 ${latest}. Run: ${UPGRADE}` : null;
 }
 
+// src/resolve.ts
+var looksLikeId = (s) => /^c[a-z0-9]{20,}$/.test(s) || /^[0-9a-f]{24}$/.test(s);
+function pickAgent(list, ref, workspace) {
+  const want = ref.trim().toLowerCase();
+  let hits = list.filter((a) => a.nombre.trim().toLowerCase() === want);
+  if (hits.length > 1 && workspace) {
+    const here = hits.filter((a) => a.espacio?.nombre === workspace);
+    if (here.length) hits = here;
+  }
+  if (hits.length === 1) return hits[0].id;
+  if (!hits.length) {
+    const near = list.filter((a) => a.nombre.toLowerCase().includes(want)).slice(0, 5);
+    throw new CliError(`No agent named "${ref}".`, EXIT.USAGE, near.length ? `Did you mean: ${near.map((a) => `${a.nombre} (${a.id})`).join(", ")}?` : "List them: ghosty agents ls");
+  }
+  const where = (a) => a.espacio?.tipo === "workspace" ? a.espacio.nombre : a.espacio?.tipo ?? "?";
+  throw new CliError(`${hits.length} agents are named "${ref}".`, EXIT.USAGE, `Use the id:
+${hits.map((a) => `  ${a.id}  ${a.motor ?? ""}  ${where(a)}`).join("\n")}`);
+}
+var cache = null;
+function listAgents() {
+  cache ??= api("/api/v2/me/agents?client=cli").then((r) => r.agentes);
+  return cache;
+}
+async function resolveAgent(ref, workspace) {
+  if (!ref || looksLikeId(ref)) return ref;
+  return pickAgent(await listAgents(), ref, workspace);
+}
+
+// src/aliases.ts
+function normalizeArgs(pos, v) {
+  const notes = [];
+  const [cmd, sub] = pos;
+  if (cmd === "cards") pos[0] = "board";
+  else if (cmd === "board") notes.push("`ghosty board` is now `ghosty cards` (same subcommands).");
+  if (cmd === "skills") {
+    if (sub === "enable") pos[1] = "on";
+    else if (sub === "disable") pos[1] = "off";
+    else if (sub === "on" || sub === "off") notes.push(`\`skills ${sub}\` is now \`skills ${sub === "on" ? "enable" : "disable"}\`.`);
+  }
+  if (cmd === "agents" && sub === "demo") {
+    if (pos[2] === "enable" || pos[2] === "disable") {
+      v[pos[2] === "enable" ? "on" : "off"] = true;
+      pos.splice(2, 1);
+    } else if (v.on || v.off) notes.push(`\`agents demo <agent> --${v.on ? "on" : "off"}\` is now \`agents demo ${v.on ? "enable" : "disable"} <agent>\`.`);
+    if (v.expires !== void 0) v.vence = v.expires;
+    else if (v.vence !== void 0) notes.push("`--vence` is now `--expires`.");
+  }
+  if (cmd === "channels" && pos[2] === "groups") {
+    if (pos[3] === "enable" || pos[3] === "disable") {
+      v[pos[3] === "enable" ? "on" : "off"] = true;
+      pos[3] = "set";
+    } else if (pos[3] === "set" && (v.on || v.off)) notes.push(`\`groups set \u2026 --${v.on ? "on" : "off"}\` is now \`groups ${v.on ? "enable" : "disable"} <agent> <group>\` (set keeps --role).`);
+  }
+  return notes;
+}
+
 // src/index.ts
 var HELP = `${bold("Usage:")} ghosty <command> [options]
 
@@ -2444,6 +2528,7 @@ ${bold("Session")}
     --device                Sign in from another device with a link + code (auto over SSH/CI)
   logout                    Sign out and revoke this device's session
   whoami                    Show who you are signed in as
+  use [workspace]           Default workspace for boards, agents create and agents ls   [--clear]
   usage                     Your plan and how much you've used this week and month
 
 ${bold("Agents")}
@@ -2466,12 +2551,13 @@ ${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 box <id>           The machine serving it: is it on the new image?   [--check PATH]\u2026 [--contains PATH=TEXT]\u2026 [--recycle]
+  agents demo enable|disable <id>   Turn its public demo link on or off
   agents demo <id>          Public demo link /p/<slug>: anyone tries it without an account, "Keep it" clones it to theirs
-                            [--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]
+                            [--slug NAME] [--expires "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]
-  skills on|off <id> <slug>          Turn one of its skills (or one of Ghosty's) on or off
+  skills enable|disable <id> <slug>  Turn one of its skills (or one of Ghosty's) on or off
   skills house <id>                  Ghosty's skills in bulk   [--only a,b | --enable a,b | --disable a,b] [--dry-run]
   skills ls|get|add|rm <id> [slug]   Skills (add from catalog, --file SKILL.md or --dir FOLDER; get lists, --out DIR saves; rm keeps a copy)
   skills templates <id>              pdf-doc templates it sees: its own and Ghosty's, and which folder wins
@@ -2483,11 +2569,11 @@ ${bold("Configure an agent")}
   channels wa import <id> --from-file F | --from-dir DIR --own-number yes|no   Move a personal WhatsApp session here, no QR   [--dry-run] [--replace] [--no-connect]
   channels wa pair <id> --phone N         Pair a personal WhatsApp by code (no QR)
   channels wa status|pause <id>           Personal WhatsApp: how it is / pause it (keeps the session)
-  channels wa groups ls|set|create <id> [group]        Personal WhatsApp groups it answers, and as whom   [--role equipo|cliente] [--on|--off] [--dry-run]
+  channels wa groups ls|enable|disable|set|create <id> [group]   Personal WhatsApp groups it answers, and as whom   [--role equipo|cliente] [--dry-run]
   boards ls|create|assign|move-cards|rm   A workspace's boards: create (--columns-from), where an agent sends cards, move cards
-  board ls <id>             Recent cards on its sales board   [--q TEXT] [--limit 20]
-  board show <id> <card>    A card's thread: who wrote, text, attachments and whether gs kept a copy   (folio, phone or id)
-  board archive <id>        Archive cards in bulk (reversible)   --integration X | --column X | --before 30d   [--dry-run]
+  cards ls <id>             Recent cards on its sales board   [--q TEXT] [--limit 20]
+  cards show <id> <card>    A card's thread: who wrote, text, attachments and whether gs kept a copy   (folio, phone or id)
+  cards archive <id>        Archive cards in bulk (reversible)   --integration X | --column X | --before 30d   [--dry-run]
 
 ${bold("Talk to an agent")}
   try <id> "message"        One test turn, prints the full answer   [--session] [--reset]
@@ -2513,6 +2599,7 @@ ${bold("Your account")}
   docs [topic]              Open the docs
 
 ${bold("Global options")}
+  <agent>                   Everywhere: an agent's NAME (case-insensitive) or its id
   --json                    Machine-readable output (stdout is JSON only)
   --token <token>           Use this token (or env GHOSTY_TOKEN). A gat_\u2026 agent token reaches only that agent.
   --profile <name>          Use a separate saved session (or env GHOSTY_PROFILE), e.g. one per account
@@ -2523,7 +2610,7 @@ ${bold("Global options")}
 ${bold("Exit codes")}  0 ok \xB7 1 API error \xB7 2 usage error \xB7 3 not signed in
 ${dim("Note: `ghosty` may collide with another binary on your PATH (e.g. the Ghosty TUI). Check with `which -a ghosty`; run `npx @ghostystudio/cli` to be sure.")}
 ${dim("Docs: https://www.ghosty.studio/docs/cli")}`;
-var COMMANDS = ["login", "logout", "whoami", "usage", "agents", "files", "skills", "mcp", "dbs", "turns", "try", "chat", "conversations", "schedule", "partner", "me", "channels", "board", "boards", "credentials", "docs", "help"];
+var COMMANDS = ["login", "logout", "whoami", "usage", "use", "cards", "agents", "files", "skills", "mcp", "dbs", "turns", "try", "chat", "conversations", "schedule", "partner", "me", "channels", "board", "boards", "credentials", "docs", "help"];
 var AGENTS_SUBS = ["ls", "create", "get", "set", "doctor", "docs", "share", "unshare", "shares", "rm", "restart", "demo", "box"];
 function unknown(what, input, known, helpCmd) {
   const s = suggest(input, known);
@@ -2533,6 +2620,45 @@ function showHelp() {
   if (process.stdout.isTTY && !process.env.NO_COLOR && !globals.json) process.stdout.write(BANNER + "\n\n");
   process.stdout.write(HELP + "\n");
 }
+function agentArgIndex(pos) {
+  const [cmd, sub] = pos;
+  switch (cmd) {
+    case "agents":
+      if (sub === "docs" || sub === "documents") return 3;
+      return sub && !["ls", "list", "create", "new"].includes(sub) ? 2 : null;
+    case "files":
+    case "skills":
+    case "mcp":
+    case "dbs":
+    case "db":
+    case "turns":
+    case "board":
+    case "conversations":
+    case "schedule":
+      return 2;
+    case "try":
+    case "chat":
+      return 1;
+    case "channels":
+      return pos[2] === "groups" ? 4 : 3;
+    case "boards":
+      return sub === "assign" ? 2 : null;
+    default:
+      return null;
+  }
+}
+async function useCmd(slug, v) {
+  const cfg = await readConfig();
+  if (v.clear) {
+    delete cfg.workspace;
+    await writeConfig(cfg);
+    return out({ workspace: null }, () => `${lavender("\u2713")} No default workspace.`);
+  }
+  if (!slug) return out({ workspace: cfg.workspace ?? null }, () => cfg.workspace ? `Workspace: ${bold(cfg.workspace)}` : dim("No default workspace. Set one: ghosty use <workspace>"));
+  await api(`/api/v2/workspaces/${encodeURIComponent(slug)}/boards`);
+  await writeConfig({ ...cfg, workspace: slug });
+  return out({ workspace: slug }, () => `${lavender("\u2713")} Using ${bold(slug)}: boards, agents create and agents ls default to it. ${dim("(ghosty use --clear to stop)")}`);
+}
 async function main() {
   const { values: v, positionals: pos } = parseArgs({
     allowPositionals: true,
@@ -2614,6 +2740,8 @@ async function main() {
       "columns-from": { type: "string" },
       to: { type: "string" },
       all: { type: "boolean" },
+      clear: { type: "boolean" },
+      expires: { type: "string" },
       q: { type: "string" },
       "prompt-out": { type: "string" },
       toolsets: { type: "string" },
@@ -2654,7 +2782,17 @@ async function main() {
   const tokens = splitTokens(pos, v);
   globals.token = tokens.session;
   globals.profile = v.profile;
-  if (v.version) return out({ version: "0.16.1" }, () => "0.16.1");
+  if (v.version) return out({ version: "0.18.0" }, () => "0.18.0");
+  for (const n of normalizeArgs(pos, v)) if (!globals.json) info(dim(n));
+  const context = (await readConfig()).workspace;
+  if (!explicitToken()?.startsWith("gat_")) {
+    const at = agentArgIndex(pos);
+    if (at !== null && pos[at]) pos[at] = await resolveAgent(pos[at], context);
+    for (const f of ["like", "prompt-base"]) {
+      const val = v[f];
+      if (typeof val === "string" && val !== "none") v[f] = await resolveAgent(val, context);
+    }
+  }
   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;
@@ -2680,9 +2818,18 @@ async function main() {
       const me = await api("/api/v2/me");
       return out(me, () => `${bold(me.email)}${dim(`  \xB7 ${new URL(process.env.GHOSTY_URL || "https://www.ghosty.studio").host}`)}`);
     }
+    case "use":
+      return useCmd(sub, v);
     case "agents":
-      if (sub === "ls" || sub === "list" || !sub) return agentsLs();
-      if (sub === "create" || sub === "new") return agentsCreate(v);
+      if (sub === "ls" || sub === "list" || !sub) return agentsLs(v.all ? void 0 : context);
+      if (sub === "create" || sub === "new") {
+        if (v.workspace === "none") delete v.workspace;
+        else if (!v.workspace && context) {
+          v.workspace = context;
+          if (!globals.json) info(dim(`workspace ${context} (from ghosty use; --workspace none for a personal agent)`));
+        }
+        return agentsCreate(v);
+      }
       if (sub === "get") return agentsGet(a1, v.fields, v["prompt-out"]);
       if (sub === "share" || sub === "unshare" || sub === "shares") return agentsShare(sub, a1, a2, v);
       if (sub === "set") return agentsSet(a1, v);
@@ -2707,7 +2854,7 @@ async function main() {
     case "board":
       return boardCmd(sub, a1, v, a2);
     case "boards":
-      return boardsCmd(sub, a1, a2, v);
+      return boardsCmd(sub, a1, a2, v, context);
     case "channels":
       if (a1 === "groups") return groupsCmd(pos.slice(3).filter((x) => x !== void 0), v);
       return channelsCmd(sub, a1, a2, pos.slice(4).join(" ") || void 0, v);
@@ -2742,7 +2889,7 @@ async function main() {
       throw unknown(cmd, cmd, COMMANDS, "ghosty --help");
   }
 }
-var notice = updateNotice("0.16.1").catch(() => null);
+var notice = updateNotice("0.18.0").catch(() => null);
 main().then(
   async () => {
     const n = await notice;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ghostystudio/cli",
-  "version": "0.16.1",
+  "version": "0.18.0",
   "description": "Official Ghosty Studio CLI — configure, test and chat with your agents from the terminal. Built for humans and coding agents.",
   "type": "module",
   "bin": {
@@ -16,7 +16,7 @@
   "scripts": {
     "build": "esbuild src/index.ts --bundle --platform=node --format=esm --target=node22 --outfile=dist/index.js --banner:js='#!/usr/bin/env node' --define:__VERSION__=\\\"$npm_package_version\\\"",
     "prepack": "npm run build",
-    "test": "for t in flags prompt api rows wa-auth; do esbuild src/$t.test.ts --bundle --platform=node --format=esm --outfile=/tmp/ghosty-cli-$t.test.mjs --log-level=error || exit 1; done && node --test /tmp/ghosty-cli-*.test.mjs"
+    "test": "for t in flags prompt api rows wa-auth resolve aliases; do esbuild src/$t.test.ts --bundle --platform=node --format=esm --outfile=/tmp/ghosty-cli-$t.test.mjs --log-level=error || exit 1; done && node --test /tmp/ghosty-cli-*.test.mjs"
   },
   "keywords": [
     "ghosty",