@ghostystudio/cli 0.14.0 → 0.16.0

package/README.md

@@ -44,11 +44,14 @@ ghosty channels whatsapp history <id> --integration ID [--days 7]   [--dry-run]
 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 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 mcp get|set <id>                  [--file servers.json]
 
 ghosty try <id> "message"                [--session] [--reset]
-ghosty try <id> "message" --waba --session PHONE [--media FILE] [--history FILE]   # real WhatsApp path, nothing sent
+ghosty try <id> "message" --waba --session PHONE [--media FILE [--as-formmy]] [--history FILE]   # real WhatsApp path, nothing sent
 ghosty try <id> --replay FILE --out DIR  [--max 15] [--concurrency 8] [--resume]
 ghosty chat <id> ["message"]             [--conversation ID]
 ghosty conversations ls <id>
@@ -84,6 +87,20 @@ 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.16.0
+
+- `agents create --like <agent> [--copy-dbs] [--dry-run]`: a new agent with another's setup (skills and their switches, toolsets, connectors, voice, databases, documents, board, shares), never its prompt, env or channels.
+- `skills house <id> --only a,b | --enable | --disable`: Ghosty's skills in bulk.
+- `agents docs grant <id> A B …` and `--like <agent>`.
+- `agents get --fields toolsets,connectors`: effective toolsets and each connector (connected, granted, effective).
+- `boards ls|create|assign|move-cards`: a workspace's boards, one per number if you like, with the columns of another and the cards moved over.
+
+### Changes in 0.15.0
+
+- `try --waba` lists everything the agent would send, tools included: 📍 location, 📄 files, 🎤 voice, ↩️ quotes, 🔘 buttons, 👤 contacts, reactions. Quotes and reactions now find the test message to point at.
+- `try --waba --media FILE --as-formmy`: the attachment arrives like a real Formmy forward (proxy with credential, copy to gs, transcription) and the output says whether the copy worked.
+- `board ls` (recent cards) and `board show <folio|phone|id>` (a card's thread: who wrote, text, attachment, copy in gs).
+
 ### Changes in 0.14.0
 
 - Fix: `--json` output over a pipe no longer gets cut at 64 KB (an 80 KB prompt came out as invalid JSON). The CLI now waits for stdout to drain before exiting.

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.14.0"}`, "content-type": "application/json", "content-length": Buffer.byteLength(data) }
+      headers: { authorization: `Bearer ${token}`, "user-agent": `ghosty-cli/${"0.16.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.14.0"}`,
+      "user-agent": `ghosty-cli/${"0.16.0"}`,
       ...opts.body !== void 0 ? { "content-type": "application/json" } : {},
       ...opts.headers
     },
@@ -428,13 +428,34 @@ async function uploadMedia(file) {
   const mime = MIME[ext] ?? "application/octet-stream";
   return { url: r.url, mime, filename: r.name, type: mime.startsWith("image/") ? "image" : mime.startsWith("audio/") ? "audio" : mime.startsWith("video/") ? "video" : "document" };
 }
+function richLine(s) {
+  const d = s.data ?? {};
+  const str = (k) => typeof d[k] === "string" ? d[k] : "";
+  switch (s.rich) {
+    case "ubicacion":
+      return `\u{1F4CD} ${str("nombre") || "location"} \xB7 ${Number(d.latitud).toFixed(4)},${Number(d.longitud).toFixed(4)}${str("direccion") ? dim(` ${str("direccion")}`) : ""}`;
+    case "boton":
+      return `\u{1F518} ${str("boton")} ${dim(str("url"))}  ${str("texto")}`;
+    case "contacto":
+      return `\u{1F464} ${str("nombre")} ${str("telefono")}`;
+    case "encuesta":
+      return `\u{1F4CA} ${str("pregunta")}`;
+    case "reaccion":
+      return `${str("emoji")} ${dim(`reaction to ${str("mensajeId") || "the last message"}`)}`;
+    case "cita":
+      return `\u21A9\uFE0F ${str("texto")} ${dim(`quoting ${str("mensajeId") || "the last message"}`)}`;
+  }
+}
 function sentText(sent) {
-  return sent.map((s) => s.kind === "text" ? `${lavender("\u2192")} ${s.text}` : s.kind === "voice" ? `${lavender("\u{1F3A4}")} ${s.text}` : `${lavender("\u{1F4CE}")} ${s.name} ${dim(s.url)}`).join("\n\n");
+  return sent.map(
+    (s) => s.kind === "text" ? `${lavender("\u2192")} ${s.text}` : s.kind === "voice" ? `${lavender("\u{1F3A4}")} ${s.text}` : s.kind === "file" ? `${lavender(/^audio\//.test(s.mime ?? "") ? "\u{1F3A4}" : "\u{1F4C4}")} ${s.name} ${dim(s.url)}` : richLine(s)
+  ).join("\n\n");
 }
 async function tryWaba(id, text, v) {
   const phone = v.session ?? "";
   if (!/^\d{10,15}$/.test(phone)) throw usage("--waba needs --session <phone> (10-15 digits, a made-up number).", 'Example: ghosty try <agent-id> "hola" --waba --session 5210000000009');
   if ((v.media?.length ?? 0) > 1) throw usage("One --media per turn (WhatsApp sends one file per message).", "Send several turns, one file each.");
+  if (v["as-formmy"] && !v.media?.length) throw usage("--as-formmy goes with --media FILE.", 'Example: ghosty try <agent-id> "" --waba --session 5210000000009 --media nota.ogg --as-formmy');
   if (!text && !v.media?.length && !v.reset) throw usage("Missing message.", 'Example: ghosty try <agent-id> "hola" --waba --session 5210000000009');
   let history;
   if (v.history) {
@@ -445,9 +466,11 @@ async function tryWaba(id, text, v) {
   }
   const media = v.media?.[0] ? await uploadMedia(v.media[0]) : void 0;
   if (process.stderr.isTTY && !globals.json && (text || media)) info(dim("Thinking\u2026 (the real WhatsApp path; nothing is sent)"));
-  const r = await tryPost(id, { as: "waba", session: phone, reset: v.reset, text: text ?? "", ...media ? { media } : {}, ...history ? { history } : {} });
+  const r = await tryPost(id, { as: "waba", session: phone, reset: v.reset, text: text ?? "", ...media ? { media } : {}, ...history ? { history } : {}, ...v["as-formmy"] ? { asFormmy: true } : {} });
   if (r.status !== 200) throw Object.assign(new Error(`${r.status} ${r.body.error ?? "turn failed"}`), { code: 1 });
-  out(r.body, () => (r.body.sent ? sentText(r.body.sent) || dim("(the agent sent nothing)") : dim("Session reset.")) + (r.body.error ? `
+  const via = r.body.media ? `
+${r.body.media.copied ? dim("attachment: downloaded through the Formmy-like proxy and copied to gs") : red("attachment: NOT copied to gs (the proxy download failed)")}` : "";
+  out(r.body, () => (r.body.sent ? sentText(r.body.sent) || dim("(the agent sent nothing)") : dim("Session reset.")) + via + (r.body.error ? `
 ${dim(`(warning: ${r.body.error})`)}` : ""));
 }
 async function tryReplay(id, v) {
@@ -550,11 +573,22 @@ async function agentsCreate(v) {
   if (v.workspace) body.workspace = v.workspace;
   const channels = parseChannels(v.channels);
   if (channels) body.channels = channels;
+  if (v.like) Object.assign(body, { like: v.like, ...v["copy-dbs"] ? { copyDbs: true } : {}, ...v["dry-run"] ? { dryRun: true } : {} });
+  else if (v["dry-run"]) throw usage("--dry-run goes with --like (it lists what would be copied).");
+  if (v.like && v["dry-run"]) {
+    const p = await api("/api/v2/me/agents", { method: "POST", body });
+    return out(p, () => `${dim(`like ${v.like} \xB7 ${p.engine ?? "?"} \xB7 ${p.model ?? "default"}${p.workspace ? ` \xB7 workspace ${p.workspace}` : ""}`)}
+${p.plan.join("\n")}
+${dim("Not copied: prompt, env, channels. Dry run: nothing created.")}`);
+  }
   const r = await api("/api/v2/me/agents", { method: "POST", body });
   const where = r.workspace ? `
   workspace: ${r.workspace}${r.handle ? ` \xB7 @${r.handle} in Teams` : dim(" \xB7 not active in Teams")}` : "";
+  const copied = r.copied?.length ? `
+${r.copied.map((l) => `  ${l}`).join("\n")}
+${dim("  Now give it its own prompt: ghosty agents set " + r.id + " --prompt-file PROMPT.md")}` : "";
   out(r, () => `${lavender("\u2713")} Created ${r.name} ${dim(`(${r.engine} \xB7 ${r.model ?? "default"})`)}
-  id: ${r.id}${where}`);
+  id: ${r.id}${where}${copied}`);
 }
 async function agentsGet(id, fields, promptOut) {
   id = need(id, "agent id", "ghosty agents get <agent-id>");
@@ -749,7 +783,7 @@ async function readSkillDir(dir) {
 }
 var trashDir = (id, slug) => join3(process.env.XDG_CONFIG_HOME || join3(homedir2(), ".config"), "ghosty", "trash", id, `${slug}-${(/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "-")}`);
 async function skillsCmd(sub, id, slug, v) {
-  const ex = "ghosty skills ls <agent-id> | on|off <agent-id> <slug> | get <agent-id> <slug> [--out DIR] | templates <agent-id> | add <agent-id> <slug> [--file SKILL.md | --dir FOLDER] | rm <agent-id> <slug>";
+  const ex = "ghosty skills ls <agent-id> | on|off <agent-id> <slug> | house <agent-id> [--only a,b] | get <agent-id> <slug> [--out DIR] | templates <agent-id> | add <agent-id> <slug> [--file SKILL.md | --dir FOLDER] | rm <agent-id> <slug>";
   id = need(id, "agent id", ex);
   switch (sub ?? "ls") {
     case "ls":
@@ -765,6 +799,21 @@ async function skillsCmd(sub, id, slug, v) {
 ${dim(`${more} more in the community catalog: ghosty skills add <agent-id> <slug> (--json lists them) \xB7 overlaps: ghosty agents doctor ${id}`)}`);
       return;
     }
+    case "house": {
+      const list = (x) => x ? x.split(",").map((s) => s.trim()).filter(Boolean) : void 0;
+      const only = list(v.only), on = list(v.enable), off = list(v.disable);
+      if (!only && !on && !off) {
+        const r2 = await api(agentPath(id, "/skills/house"));
+        out(r2, () => `${table(r2.house.map((h) => ({ slug: h.slug, on: h.enabled ? "on" : "off" })), ["slug", "on"])}
+${dim(`Change: ghosty skills house ${id} --only a,b | --enable a | --disable b [--dry-run]`)}`);
+        return;
+      }
+      const body = { ...only ? { only } : {}, ...on ? { on } : {}, ...off ? { off } : {}, ...v["dry-run"] ? { dryRun: true } : {} };
+      const r = await api(agentPath(id, "/skills/house"), { method: "PUT", body });
+      out(r, () => `${r.changes.map((c) => `${c.enabled ? "+" : "-"} ${c.slug}`).join("\n") || dim("Nothing to change.")}
+${dim(`On now: ${r.on.join(", ") || "none"}${r.dryRun ? " \xB7 dry run: nothing changed" : ""}`)}`);
+      return;
+    }
     case "on":
     case "off": {
       slug = need(slug, "skill slug", `ghosty skills ${sub} <agent-id> <slug>`);
@@ -1220,7 +1269,7 @@ async function call(path, v, init = {}) {
         "x-ghosty-ts": ts,
         "x-ghosty-sig": sig,
         "content-type": "application/json",
-        "user-agent": `ghosty-cli/${"0.14.0"}`
+        "user-agent": `ghosty-cli/${"0.16.0"}`
       },
       body: method === "GET" ? void 0 : raw
     });
@@ -1500,7 +1549,8 @@ ${dim(`${rows.length} row(s) \xB7 ${Math.round(r.ms)} ms`)}`;
       throw usage(`Unknown dbs subcommand: ${sub}.`, "Try: ghosty dbs ls | tables | query | import | grant | revoke   (ghosty dbs --help)");
   }
 }
-async function agentDocsCmd(sub, id, doc, v) {
+async function agentDocsCmd(sub, id, docs, v) {
+  let doc = docs[0];
   id = need2(id, "agent id", "ghosty agents docs ls <agent-id>");
   switch (sub ?? "ls") {
     case "ls":
@@ -1510,13 +1560,23 @@ async function agentDocsCmd(sub, id, doc, v) {
       return out(r.documents, () => rows.length ? table(rows, ["name", "access", "delivers", "id"]) : dim("This account has no documents yet: upload them at /app/datos."));
     }
     case "grant": {
-      doc = need2(doc, "document (id or exact name)", 'ghosty agents docs grant <agent-id> "Cat\xE1logo.pdf"');
-      const body = {};
-      if (v.write) body.mode = "write";
-      if (v["no-deliver"]) body.deliverable = false;
-      else if (v.deliver) body.deliverable = true;
-      const r = await api(agentPath2(id, `/documents/${enc6(doc)}`), { method: "PUT", body });
-      return out(r, () => `${lavender("\u2713")} ${r.name}: ${r.mode === "write" ? "reads and replaces it" : "reads it"}${r.deliverable ? ", and can send it" : ", never sends it"}.`);
+      let wanted;
+      if (v.like) {
+        if (docs.length) throw usage("Use document names or --like, not both.");
+        const other = await api(agentPath2(v.like, "/documents"));
+        wanted = other.documents.filter((d) => d.granted).map((d) => ({ ref: d.id, body: { mode: d.mode ?? "read", deliverable: d.deliverable ?? true } }));
+        if (!wanted.length) return out({ granted: [] }, () => dim(`${v.like} has no documents granted.`));
+      } else {
+        if (!docs.length) throw usage("Missing document (id or exact name).", 'Example: ghosty agents docs grant <agent-id> "Cat\xE1logo.pdf" "Precios.xlsx"   (or --like <other-agent>)');
+        const body = {};
+        if (v.write) body.mode = "write";
+        if (v["no-deliver"]) body.deliverable = false;
+        else if (v.deliver) body.deliverable = true;
+        wanted = docs.map((ref) => ({ ref, body }));
+      }
+      const done = [];
+      for (const w of wanted) done.push(await api(agentPath2(id, `/documents/${enc6(w.ref)}`), { method: "PUT", body: w.body }));
+      return out(done.length === 1 ? done[0] : { granted: done }, () => done.map((r) => `${lavender("\u2713")} ${r.name}: ${r.mode === "write" ? "reads and replaces it" : "reads it"}${r.deliverable ? ", and can send it" : ", never sends it"}.`).join("\n"));
     }
     case "add": {
       if (!v.url === !v.file) throw usage("Use --url URL or --file PATH (one of them).", 'Example: ghosty agents docs add <agent-id> --url https://\u2026/lista.pdf --description "Precios 2026"');
@@ -1891,8 +1951,37 @@ Cards appear on the team's board (no "new lead" alerts).`, { yes: v.yes, retry:
 }
 
 // src/commands/board.ts
-async function boardCmd(sub, id, v) {
-  if (sub !== "archive") throw usage(`Unknown board subcommand: ${sub ?? "(none)"}.`, "Try: ghosty board archive <agent-id> --integration prueba --dry-run");
+var WHO = { user: "customer", assistant: "agent", operator: "operator" };
+async function boardLs(id, v) {
+  const qs = new URLSearchParams({ ...v.q ? { q: v.q } : {}, ...v.limit ? { limit: v.limit } : {} });
+  const r = await api(`/api/v2/agents/${encodeURIComponent(id)}/board/conversations?${qs}`);
+  const rows = r.conversations.map((c) => ({ folio: c.folio ? `#${c.folio}` : "", name: c.name ?? "", phone: c.phone, column: c.column ?? "", msgs: c.messages, last: (c.lastActivity ?? "").slice(0, 16).replace("T", " ") }));
+  out(r, () => rows.length ? `${table(rows, ["folio", "name", "phone", "column", "msgs", "last"])}
+${dim(`\xAB${r.board}\xBB \xB7 thread: ghosty board show ${id} <folio|phone>`)}` : dim(`No cards on \xAB${r.board}\xBB${v.q ? ` matching "${v.q}"` : ""}.`));
+}
+async function boardShow(id, ref, v) {
+  if (!ref) throw usage("Missing conversation.", `Example: ghosty board show ${id} "#12"   (folio, phone, session or id; list them with ghosty board ls ${id})`);
+  const r = await api(`/api/v2/agents/${encodeURIComponent(id)}/board/conversations/${encodeURIComponent(ref)}${v.limit ? `?limit=${encodeURIComponent(v.limit)}` : ""}`);
+  const c = r.conversation;
+  const head = `${bold(c.name ?? c.phone)} ${dim(`${c.folio ? `#${c.folio} \xB7 ` : ""}+${c.phone} \xB7 ${c.column ?? "no column"} \xB7 ${c.session}`)}`;
+  const line = (m) => {
+    const at = m.createdAt.slice(5, 16).replace("T", " ");
+    const media = m.mediaType || m.mediaFilename ? `
+      ${dim(`\u{1F4CE} ${m.mediaType ?? "file"} ${m.mediaFilename ?? ""} \xB7 ${m.mediaCopied ? "copy in gs" : "no copy"}`)}` : "";
+    return `${dim(at)}  ${lavender((WHO[m.role] ?? m.role).padEnd(8))} ${m.content.replace(/\n/g, "\n                  ")}${media}`;
+  };
+  out(r, () => [head, ...r.messages.map(line)].join("\n"));
+}
+async function boardCmd(sub, id, v, ref) {
+  if (sub === "ls" || sub === "list") {
+    if (!id) throw usage("Missing agent id.", "Example: ghosty board ls <agent-id> [--q text] [--limit 20]");
+    return boardLs(id, v);
+  }
+  if (sub === "show") {
+    if (!id) throw usage("Missing agent id.", 'Example: ghosty board show <agent-id> "#12"');
+    return boardShow(id, ref, v);
+  }
+  if (sub !== "archive") throw usage(`Unknown board subcommand: ${sub ?? "(none)"}.`, "Try: ghosty board ls <agent-id> \xB7 ghosty board show <agent-id> <folio|phone> \xB7 ghosty board archive <agent-id> --integration prueba --dry-run");
   if (!id) throw usage("Missing agent id.", "Example: ghosty board archive <agent-id> --integration prueba --dry-run");
   const filter = { ...v.integration ? { integration: v.integration } : {}, ...v.column ? { column: v.column } : {}, ...v.before ? { before: v.before } : {} };
   if (!Object.keys(filter).length) throw usage("Add at least one filter: --integration, --column or --before.", "A filter-less archive would empty the board.");
@@ -1911,6 +2000,57 @@ Archive ${plan.matched} card(s) on \xAB${plan.board}\xBB? (reversible: a new mes
   out(r, () => `${lavender("\u2713")} Archived ${r.archived} card(s) on \xAB${r.board}\xBB.`);
 }
 
+// src/commands/boards.ts
+var enc8 = encodeURIComponent;
+async function boardsCmd(sub, a1, a2, v) {
+  switch (sub ?? "ls") {
+    case "ls":
+    case "list": {
+      if (!a1) throw usage("Missing workspace.", "Example: ghosty boards ls <workspace-slug>");
+      const r = await api(`/api/v2/workspaces/${enc8(a1)}/boards`);
+      const rows = r.boards.map((b) => ({ name: b.main ? `${b.name} (main)` : b.name, cards: b.cards, agents: b.agents.map((x) => x.name ?? x.id).join(", "), columns: b.columns.length, id: b.id }));
+      return out(r, () => table(rows, ["name", "cards", "agents", "columns", "id"]));
+    }
+    case "create": {
+      if (!a1 || !a2) throw usage("Missing workspace or name.", 'Example: ghosty boards create <workspace> "Siiqtec - Ixmiquilpan" --columns-from main');
+      const r = await api(`/api/v2/workspaces/${enc8(a1)}/boards`, { method: "POST", body: { name: a2, ...v["columns-from"] ? { columnsFrom: v["columns-from"] } : {} } });
+      return out(r, () => `${lavender("\u2713")} Board \xAB${r.name}\xBB created${r.columnsFrom ? ` with the ${r.columns} column(s) of \xAB${r.columnsFrom}\xBB` : ""}. ${dim(`Send an agent's cards there: ghosty boards assign <agent-id> "${r.name}"`)}`);
+    }
+    case "rm": {
+      if (!a1 || !a2) throw usage("Missing workspace or board.", 'Example: ghosty boards rm <workspace> "Prueba"');
+      requireYesIfHeadless(v.yes, `ghosty boards rm ${a1} ${JSON.stringify(a2)}`);
+      await confirm(`Delete the board \xAB${a2}\xBB of ${a1}? (only an empty one; its agents go back to the main board)`, { yes: v.yes, retry: `ghosty boards rm ${a1} ${JSON.stringify(a2)}` });
+      const r = await api(`/api/v2/workspaces/${enc8(a1)}/boards`, { method: "DELETE", body: { board: a2 } });
+      return out(r, () => `${lavender("\u2713")} Board \xAB${r.deleted}\xBB deleted.`);
+    }
+    case "assign": {
+      if (!a1 || !a2) throw usage("Missing agent or board.", 'Example: ghosty boards assign <agent-id> "Siiqtec - Ixmiquilpan"   (or main)');
+      const r = await api(`/api/v2/agents/${enc8(a1)}`, { method: "PATCH", body: { board: a2 } });
+      return out(r, () => `${lavender("\u2713")} New cards of ${a1} go to \xAB${r.board}\xBB. ${dim(`Existing ones stay where they are: ghosty boards move-cards ${r.workspace} --from \u2026 --to "${r.board}" \u2026`)}`);
+    }
+    case "move-cards": {
+      if (!a1 || !v.from || !v.to) throw usage("Missing workspace, --from or --to.", 'Example: ghosty boards move-cards <workspace> --from main --to "Siiqtec - Ixmiquilpan" --integration 6a3b02ad\u2026 --dry-run');
+      if (!v.integration && !v.phone && !v.all) throw usage("Add a filter: --integration ID, --phone N or --all.", "A filter-less move would empty the board.");
+      const path = `/api/v2/workspaces/${enc8(a1)}/boards/move-cards`;
+      const body = { from: v.from, to: v.to, ...v.integration ? { integration: v.integration } : {}, ...v.phone ? { phone: v.phone } : {}, ...v.all ? { all: true } : {} };
+      const retry = `ghosty boards move-cards ${a1} --from ${JSON.stringify(v.from)} --to ${JSON.stringify(v.to)}${v.integration ? ` --integration ${v.integration}` : ""}${v.phone ? ` --phone ${v.phone}` : ""}${v.all ? " --all" : ""}`;
+      if (!v["dry-run"]) requireYesIfHeadless(v.yes, retry);
+      const plan = await api(path, { method: "POST", body: { ...body, dryRun: true } });
+      const sample = table(plan.sample.map((c) => ({ folio: c.folio ? `#${c.folio}` : "", name: c.name ?? "", phone: c.phone })), ["folio", "name", "phone"]);
+      const text = `${sample}
+${plan.moved} of ${plan.matched} card(s) \xAB${plan.from}\xBB \u2192 \xAB${plan.to}\xBB${plan.skipped.length ? dim(` \xB7 ${plan.skipped.length} already in \xAB${plan.to}\xBB, skipped`) : ""}`;
+      if (v["dry-run"] || !plan.moved) return out(plan, () => `${text}
+${dim("Dry run: nothing changed.")}`);
+      await confirm(`${text}
+Move them with their threads and orders? (they get a new folio there)`, { yes: v.yes, retry });
+      const r = await api(path, { method: "POST", body });
+      return out(r, () => `${lavender("\u2713")} Moved ${r.moved} card(s) (${r.messages} message(s), ${r.orders} order(s)) to \xAB${r.to}\xBB.${r.skipped.length ? dim(` Skipped ${r.skipped.length}.`) : ""}`);
+    }
+    default:
+      throw usage(`Unknown boards subcommand: ${sub}.`, "Try: ghosty boards ls | create | assign | move-cards | rm");
+  }
+}
+
 // src/help.ts
 var DOCS = "https://www.ghosty.studio/docs/cli";
 var REF = `${DOCS}/comandos`;
@@ -1919,12 +2059,12 @@ var HELPS = {
     summary: "Create, inspect, change, check and delete agents.",
     usage: [
       "ghosty agents ls",
-      "ghosty agents create --name NAME [--engine E] [--model M] [--prompt TEXT | --prompt-file FILE] [--env K=V,\u2026] [--workspace SLUG] [--channels teams=off,\u2026]",
+      "ghosty agents create --name NAME [--engine E] [--model M] [--prompt TEXT | --prompt-file FILE] [--env K=V,\u2026] [--workspace SLUG] [--channels teams=off,\u2026] [--like AGENT [--copy-dbs] [--dry-run]]",
       "ghosty agents get <agent-id> [--fields name,model,prompt] [--prompt-out FILE]",
       "ghosty agents set <agent-id> [--name] [--engine] [--model] [--prompt | --prompt-file] [--env K=V,\u2026] [--connect ID,\u2026] [--disconnect ID,\u2026] [--voice E:ID] [--voice-replies auto|off] [--auto-stage on|off] [--toolsets crm,sales | +crm,-sales]",
       "ghosty agents set <agent-id> --prompt-base <base-agent-id> --prompt-overlay overlay.json [--dry-run [--out FILE]]   |   --prompt-base none",
       "ghosty agents doctor <agent-id> [--verbose]",
-      "ghosty agents docs ls|grant|revoke <agent-id> [doc] [--write] [--no-deliver]",
+      "ghosty agents docs ls|grant|revoke <agent-id> [doc\u2026] [--write] [--no-deliver] [--like AGENT]",
       "ghosty agents docs add <agent-id> --url URL | --file PATH [--name N] [--description TEXT] [--grant read|write|no] [--no-deliver]",
       "ghosty agents share <agent-id> <email> [--role editor|admin]",
       "ghosty agents unshare <agent-id> <email> [--yes]",
@@ -1937,6 +2077,8 @@ var HELPS = {
     flags: [
       ["--fields a,b", "get: return only these fields"],
       ["--prompt-out FILE", "get: write the prompt to FILE (edit it and come back with set --prompt-file)"],
+      ["--like AGENT", "create: copy that agent's setup (skills and their switches, toolsets, connectors, voice, databases, documents, board, shares) \u2014 not its prompt, env or channels. docs grant: the same documents"],
+      ["--copy-dbs", "create --like: duplicate its databases with their rows instead of granting the same ones"],
       ["--workspace SLUG", "create: born in that workspace (you own or administer it), owned by its owner and active in its Teams"],
       ["--channels k=on|off,\u2026", "create/set: turn channels on/off: teams, web, whatsapp, messenger, wa (personal WhatsApp)"],
       ["--toolsets LIST", "set: gs tool groups it gets (crm, sales\u2026): a list replaces; +x / -x add or remove"],
@@ -1977,6 +2119,9 @@ var HELPS = {
       "ghosty agents set <id> --toolsets +crm",
       "ghosty agents share <id> ana@empresa.com --role admin",
       "ghosty agents get <id> --prompt-out PROMPT.md",
+      "ghosty agents get <id> --fields toolsets,connectors   # what it really has: effective toolsets, connectors connected + granted",
+      "ghosty agents create --name tania-mkt --like <pia-id> --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 box <id> --contains /opt/claude-worker/skills/pdf-doc/render-doc.mjs=pdf-templates"
@@ -1989,6 +2134,7 @@ var HELPS = {
     usage: [
       "ghosty skills ls <agent-id>",
       "ghosty skills on|off <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>",
       "ghosty skills add <agent-id> <slug> [--file SKILL.md | --dir FOLDER]",
@@ -1996,6 +2142,8 @@ var HELPS = {
     ],
     flags: [
       ["--out DIR", "get: folder to write into; without it, get only lists the files"],
+      ["--only a,b", "house: leave ONLY these of Ghosty's skills on (the rest off)"],
+      ["--enable / --disable a,b", "house: turn these of Ghosty's skills on / off"],
       ["--file FILE", "add: upload one SKILL.md"],
       ["--dir FOLDER", "add: upload a whole skill folder (SKILL.md + assets); restores a backup"],
       ["--yes", "rm: skip the confirmation (required without a terminal)"]
@@ -2073,13 +2221,14 @@ var HELPS = {
     summary: "Test turns: plain, through the real WhatsApp path (nothing is sent), or a replay of real conversations.",
     usage: [
       'ghosty try <agent-id> "message" [--session ID] [--reset]',
-      'ghosty try <agent-id> "message" --waba --session PHONE [--media FILE] [--history FILE] [--reset]',
+      'ghosty try <agent-id> "message" --waba --session PHONE [--media FILE [--as-formmy]] [--history FILE] [--reset]',
       "ghosty try <agent-id> --replay FILE --out DIR [--max 15] [--concurrency 8] [--resume]"
     ],
     flags: [
       ["--waba", "the real WhatsApp Business path: inherited context, price rule, board, voice. Shows what it WOULD send"],
       ["--session PHONE", "with --waba: a made-up customer phone (10-15 digits); each phone is its own conversation"],
       ["--media FILE", "with --waba: the customer sends this photo/audio/PDF (one per turn)"],
+      ["--as-formmy", "with --media: it arrives like a real Formmy forward (proxy with credential, copy to gs, transcription) and says if the copy worked"],
       ["--history FILE", "with --waba: what was said before, as [{role: user|agent, text, at?}]; counts on the first turn (--reset)"],
       ["--reset", "forget that test session (with --waba also its test thread)"],
       ["--replay FILE", "run the conversations in FILE ({sample: [{id, fakePhone, messages}]}) against the agent"],
@@ -2096,7 +2245,8 @@ var HELPS = {
     ],
     notes: [
       "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."
+      "--whatsapp is now an alias of --waba.",
+      "--waba lists everything it would send, tools included: \u{1F4CD} location, \u{1F4C4} files, \u{1F3A4} voice, \u21A9\uFE0F quotes, \u{1F518} buttons, \u{1F464} contacts, reactions."
     ],
     learn: `${REF}#turnos-de-prueba`
   },
@@ -2187,18 +2337,44 @@ HELPS.channels = {
   ],
   learn: `${REF}#canales-de-whatsapp`
 };
+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: [
+    "ghosty boards ls <workspace>",
+    'ghosty boards create <workspace> "Name" [--columns-from main|<board>]',
+    "ghosty boards assign <agent-id> <board|main>",
+    "ghosty boards move-cards <workspace> --from <board> --to <board> [--integration ID | --phone N | --all] [--dry-run] [--yes]",
+    'ghosty boards rm <workspace> "Name" [--yes]'
+  ],
+  flags: [
+    ["--columns-from B", "create: copy the columns of that board (main, a name or an id) instead of the default ones"],
+    ["--from / --to B", "move-cards: boards by name, id or main"],
+    ["--integration ID | --phone N | --all", "move-cards: which cards (a filter is required)"],
+    ["-n, --dry-run", "move-cards: count and show a sample, change nothing"],
+    ["--yes", "move-cards: skip the confirmation (required without a terminal)"]
+  ],
+  examples: ["ghosty boards ls siiqtec", 'ghosty boards create siiqtec "Siiqtec - Ixmiquilpan" --columns-from main', 'ghosty boards assign <agent-id> "Siiqtec - Ixmiquilpan"', 'ghosty boards move-cards siiqtec --from main --to "Siiqtec - Ixmiquilpan" --integration 6a3b02ad\u2026 --dry-run'],
+  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.",
-  usage: ["ghosty board archive <agent-id> [--integration ID] [--column NAME] [--before 30d|ISO] [--dry-run] [--yes]"],
+  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]"
+  ],
   flags: [
+    ["--q TEXT", "ls: cards whose name, phone or last message contains TEXT"],
+    ["--limit N", "ls: cards (default 20) \xB7 show: last N messages (default 20, max 500)"],
     ["--integration ID", "cards from this channel/integration (e.g. prueba)"],
     ["--column NAME", "cards in this column"],
     ["--before T", "cards with no activity since T (30d, 12h or an ISO date)"],
     ["-n, --dry-run", "count and show a sample, change nothing"],
     ["--yes", "skip the confirmation (required without a terminal)"]
   ],
-  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."],
+  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"],
+  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.conversations = HELPS.chat;
@@ -2272,6 +2448,7 @@ ${bold("Agents")}
   agents ls                 List your agents
   agents create             Create an agent                   --name [--engine] [--model] [--prompt | --prompt-file FILE] [--env K=V,\u2026]
                             [--workspace SLUG] [--channels teams=off,\u2026]  born in a workspace, active in its Teams
+                            [--like AGENT [--copy-dbs] [--dry-run]]  with another agent's setup (not its prompt, env or channels)
   agents get <id>           Show an agent's config            [--fields name,model,prompt] [--prompt-out FILE]
   agents set <id>           Change identity or engine         [--name] [--engine] [--model] [--prompt | --prompt-file FILE] [--env K=V,\u2026]
                             [--connect google-drive,\u2026] [--disconnect \u2026]  give/remove access to your connectors
@@ -2281,6 +2458,7 @@ ${bold("Agents")}
                             [--prompt-base AGENT|none --prompt-overlay FILE [--dry-run]]  prompt = another agent's + edits, kept in sync
   agents doctor <id>        Check the config: overlapping skills, tools the prompt names, broken grants, failing turns
   agents docs ls|grant|revoke <id> [doc]   Documents it reads and may send   [--write] [--no-deliver]
+  agents docs grant <id> A B\u2026   Grant several documents at once   [--like AGENT] copies another agent's
   agents docs add <id>      Upload a document and grant it   --url URL | --file PATH  [--description] [--grant read|write|no]
   agents share|unshare <id> <email>   Share it without handing it over   [--role editor|admin] \xB7 agents shares <id> lists them
   agents rm <id>            Delete an agent (owner only; asks you to type its name, or --yes)
@@ -2292,6 +2470,7 @@ ${bold("Agents")}
 ${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 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
   dbs ls|tables|query|import|grant|revoke <id> [db]   Databases it uses   [--write] [--external-write t1,t2] [--external-rows t:col] [--from easybits:ID --dry-run]
@@ -2303,11 +2482,14 @@ ${bold("Configure an agent")}
   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]
+  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]
 
 ${bold("Talk to an agent")}
   try <id> "message"        One test turn, prints the full answer   [--session] [--reset]
-    --waba --session PHONE  \u2026through the real WhatsApp path, nothing sent   [--media FILE] [--history FILE]
+    --waba --session PHONE  \u2026through the real WhatsApp path, nothing sent; lists what it would send (tools too)   [--media FILE [--as-formmy]] [--history FILE]
     --replay FILE --out DIR Replay real conversations; report written locally   [--max 15] [--concurrency 8] [--resume]
   chat <id> ["message"]     Stream a conversation (no message = interactive)   [--conversation ID]
   conversations ls <id>     List conversations
@@ -2339,7 +2521,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", "credentials", "docs", "help"];
+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 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);
@@ -2419,6 +2601,16 @@ async function main() {
       limit: { type: "string" },
       verbose: { type: "boolean" },
       full: { type: "boolean" },
+      "as-formmy": { type: "boolean" },
+      like: { type: "string" },
+      "copy-dbs": { type: "boolean" },
+      only: { type: "string" },
+      enable: { type: "string" },
+      disable: { type: "string" },
+      "columns-from": { type: "string" },
+      to: { type: "string" },
+      all: { type: "boolean" },
+      q: { type: "string" },
       "prompt-out": { type: "string" },
       toolsets: { type: "string" },
       "prompt-base": { type: "string" },
@@ -2458,7 +2650,7 @@ async function main() {
   const tokens = splitTokens(pos, v);
   globals.token = tokens.session;
   globals.profile = v.profile;
-  if (v.version) return out({ version: "0.14.0" }, () => "0.14.0");
+  if (v.version) return out({ version: "0.16.0" }, () => "0.16.0");
   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;
@@ -2492,7 +2684,7 @@ async function main() {
       if (sub === "set") return agentsSet(a1, v);
       if (sub === "rm" || sub === "delete") return agentsRm(a1, v);
       if (sub === "doctor") return agentsDoctor(a1, v);
-      if (sub === "docs" || sub === "documents") return agentDocsCmd(a1, a2, pos[4], v);
+      if (sub === "docs" || sub === "documents") return agentDocsCmd(a1, a2, pos.slice(4).filter((x) => x !== void 0), v);
       if (sub === "restart") return agentsRestart(a1);
       if (sub === "demo") return agentsDemo(a1, v);
       if (sub === "box") return agentsBox(a1, v);
@@ -2509,7 +2701,9 @@ async function main() {
     case "turns":
       return turnsCmd(sub, a1, a2, v);
     case "board":
-      return boardCmd(sub, a1, v);
+      return boardCmd(sub, a1, v, a2);
+    case "boards":
+      return boardsCmd(sub, a1, a2, v);
     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);
@@ -2544,7 +2738,7 @@ async function main() {
       throw unknown(cmd, cmd, COMMANDS, "ghosty --help");
   }
 }
-var notice = updateNotice("0.14.0").catch(() => null);
+var notice = updateNotice("0.16.0").catch(() => null);
 main().then(
   async () => {
     const n = await notice;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ghostystudio/cli",
-  "version": "0.14.0",
+  "version": "0.16.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": {