@ghostystudio/cli 0.16.0 → 0.17.0

package/README.md

@@ -87,6 +87,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.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).
+
 ### 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.

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.0"}`, "content-type": "application/json", "content-length": Buffer.byteLength(data) }
+      headers: { authorization: `Bearer ${token}`, "user-agent": `ghosty-cli/${"0.17.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.0"}`,
+      "user-agent": `ghosty-cli/${"0.17.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;
@@ -573,8 +577,8 @@ 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) Object.assign(body, { like: v.like, ...v["copy-dbs"] ? { copyDbs: true } : {}, ...v["dry-run"] ? { dryRun: true } : {}, ...v.board ? { board: v.board } : {}, ...v["no-notify"] ? { notify: false } : {} });
+  else if (v["dry-run"] || v.board || v["no-notify"]) throw usage("--dry-run, --board and --no-notify go with --like.");
   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}` : ""}`)}
@@ -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.0"}`
+        "user-agent": `ghosty-cli/${"0.17.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": {
@@ -2059,7 +2067,7 @@ 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] [--like AGENT [--copy-dbs] [--dry-run]]",
+      "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] [--board same|main|new|NAME] [--no-notify] [--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",
@@ -2079,6 +2087,8 @@ var HELPS = {
       ["--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"],
+      ["--board B", "create --like: same (the source's board, default) \xB7 main \xB7 new (a board named like the agent, with the source's columns: one board per number) \xB7 or an existing board"],
+      ["--no-notify", "create --like: share it with the same people WITHOUT emailing them"],
       ["--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"],
@@ -2120,7 +2130,7 @@ var HELPS = {
       "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 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"',
@@ -2337,6 +2347,14 @@ HELPS.channels = {
   ],
   learn: `${REF}#canales-de-whatsapp`
 };
+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: [
@@ -2412,28 +2430,56 @@ 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/index.ts
 var HELP = `${bold("Usage:")} ghosty <command> [options]
 
@@ -2442,13 +2488,14 @@ ${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")}
   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)
+                            [--like AGENT [--copy-dbs] [--board same|main|new|NAME] [--no-notify] [--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
@@ -2511,6 +2558,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
@@ -2521,7 +2569,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", "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);
@@ -2531,6 +2579,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,
@@ -2604,12 +2691,15 @@ async function main() {
       "as-formmy": { type: "boolean" },
       like: { type: "string" },
       "copy-dbs": { type: "boolean" },
+      "no-notify": { type: "boolean" },
+      board: { type: "string" },
       only: { type: "string" },
       enable: { type: "string" },
       disable: { type: "string" },
       "columns-from": { type: "string" },
       to: { type: "string" },
       all: { type: "boolean" },
+      clear: { type: "boolean" },
       q: { type: "string" },
       "prompt-out": { type: "string" },
       toolsets: { type: "string" },
@@ -2650,7 +2740,16 @@ async function main() {
   const tokens = splitTokens(pos, v);
   globals.token = tokens.session;
   globals.profile = v.profile;
-  if (v.version) return out({ version: "0.16.0" }, () => "0.16.0");
+  if (v.version) return out({ version: "0.17.0" }, () => "0.17.0");
+  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;
@@ -2676,9 +2775,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);
@@ -2703,7 +2811,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);
@@ -2738,7 +2846,7 @@ async function main() {
       throw unknown(cmd, cmd, COMMANDS, "ghosty --help");
   }
 }
-var notice = updateNotice("0.16.0").catch(() => null);
+var notice = updateNotice("0.17.0").catch(() => null);
 main().then(
   async () => {
     const n = await notice;

package/package.json

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