@brainbase-labs/cli 0.8.3 → 0.9.0

package/dist/index.js

@@ -28582,9 +28582,9 @@ var require_jsx_dev_runtime = __commonJS((exports, module) => {
 });
 
 // src/index.ts
-var import_picocolors40 = __toESM(require_picocolors(), 1);
+var import_picocolors41 = __toESM(require_picocolors(), 1);
 import process14 from "node:process";
-import fs51 from "node:fs";
+import fs52 from "node:fs";
 
 // src/cli/template.ts
 var import_picocolors12 = __toESM(require_picocolors(), 1);
@@ -29449,7 +29449,7 @@ function padStart(s, n) {
 // package.json
 var package_default = {
   name: "@brainbase-labs/cli",
-  version: "0.8.3",
+  version: "0.9.0",
   description: "Pack, share, and install agent templates across harnesses (Claude Code, Codex, ...).",
   type: "module",
   bin: {
@@ -54595,7 +54595,7 @@ function printHelp() {
 }
 
 // src/cli/orchestration.ts
-var import_picocolors37 = __toESM(require_picocolors(), 1);
+var import_picocolors38 = __toESM(require_picocolors(), 1);
 
 // src/cli/orchestration-pull.ts
 import path54 from "node:path";
@@ -54625,11 +54625,24 @@ var EdgeSchema = exports_external.object({
   description: exports_external.string().optional(),
   payload_schema: exports_external.record(exports_external.unknown()).optional()
 });
+var TriggerEdgeSchema = exports_external.object({
+  agent: exports_external.string(),
+  description: exports_external.string().optional(),
+  payload_schema: exports_external.record(exports_external.unknown()).optional()
+});
+var TriggerSchema = exports_external.object({
+  type: exports_external.string(),
+  node_id: exports_external.string(),
+  is_active: exports_external.boolean().optional(),
+  config: exports_external.record(exports_external.unknown()).optional(),
+  to: exports_external.array(TriggerEdgeSchema).default([])
+});
 var OrchestrationManifestSchema = exports_external.object({
   schema: exports_external.literal(1),
   orchestration: OrchMetaSchema,
   members: exports_external.array(MemberSchema).default([]),
-  edges: exports_external.array(EdgeSchema).default([])
+  edges: exports_external.array(EdgeSchema).default([]),
+  triggers: exports_external.array(TriggerSchema).optional()
 });
 function orchManifestPath(cwd2) {
   return path51.join(cwd2, ORCH_MANIFEST_FILE);
@@ -54659,7 +54672,7 @@ function writeOrchManifest(cwd2, manifest) {
   doc.contents = manifest;
   doc.commentBefore = ` brainbase-orchestration.yaml — declarative orchestration manifest.
 ` + ` Committed to source control. Edit by hand, then
-` + " `brainbase orchestration push`. Member agents live under ./agents/.";
+` + " `brainbase orchestration push`. Member agents live under ./agents/." + "\n A `triggers:` block (if present) is READ-ONLY — managed in the web app\n" + " and ignored by `orchestration push`.";
   fs47.writeFileSync(orchManifestPath(cwd2), String(doc), "utf8");
 }
 function memberDir(cwd2, slug) {
@@ -54669,6 +54682,9 @@ var MEMBER_SLUG_MAX = 50;
 function slugifyRaw(raw) {
   return (raw || "").toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "");
 }
+function slugifyMemberName(raw) {
+  return slugifyRaw(raw) || "agent";
+}
 function resolveMemberSlugs(members) {
   const SAFE = /^[a-z0-9][a-z0-9-]*$/;
   const used = new Set;
@@ -55092,7 +55108,20 @@ async function runOrchestrationPull(cwd2, args) {
       to: slugFor(e2.to_agent_id),
       ...e2.description ? { description: e2.description } : {},
       ...e2.payload_schema && Object.keys(e2.payload_schema).length ? { payload_schema: e2.payload_schema } : {}
-    }))
+    })),
+    ...cloud.triggers && cloud.triggers.length ? {
+      triggers: cloud.triggers.map((t) => ({
+        type: t.trigger_type,
+        node_id: t.node_id,
+        is_active: t.is_active,
+        ...t.config && Object.keys(t.config).length ? { config: t.config } : {},
+        to: t.edges.map((e2) => ({
+          agent: slugFor(e2.to_agent_id),
+          ...e2.description ? { description: e2.description } : {},
+          ...e2.payload_schema && Object.keys(e2.payload_schema).length ? { payload_schema: e2.payload_schema } : {}
+        }))
+      }))
+    } : {}
   };
   writeOrchManifest(cwd2, manifest);
   writeOrchLink(cwd2, {
@@ -55478,6 +55507,192 @@ function handleApiError7(err) {
   }
 }
 
+// src/cli/orchestration-add-agent.ts
+import fs51 from "node:fs";
+var import_picocolors37 = __toESM(require_picocolors(), 1);
+
+// src/core/orchestration-add.ts
+function resolveOrgIdForGroup(groupId, orgsWithTeams) {
+  for (const o2 of orgsWithTeams) {
+    if (o2.teamIds.includes(groupId))
+      return o2.orgId;
+  }
+  return null;
+}
+function parseEdgeSchema(raw) {
+  if (!raw || !raw.trim())
+    return;
+  let parsed;
+  try {
+    parsed = JSON.parse(raw);
+  } catch {
+    throw new Error(`--schema is not valid JSON: ${raw}`);
+  }
+  if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed)) {
+    throw new Error(`--schema must be a JSON object, e.g. '{"field":"type"}'`);
+  }
+  return parsed;
+}
+function mergeMemberAndEdges(manifest, input) {
+  const members = manifest.members.slice();
+  if (!members.some((m3) => m3.slug === input.slug)) {
+    members.push({
+      slug: input.slug,
+      ...input.name && input.name !== input.slug ? { name: input.name } : {}
+    });
+  }
+  const memberSlugs = new Set(members.map((m3) => m3.slug));
+  const newEdges = [];
+  const addEdge = (from, to2) => {
+    if (from === to2)
+      throw new Error(`Edge ${from} → ${to2}: self-loops are not allowed.`);
+    for (const slug of [from, to2]) {
+      if (!memberSlugs.has(slug)) {
+        throw new Error(`Edge endpoint "${slug}" is not a member. Members: ${[...memberSlugs].join(", ")}.`);
+      }
+    }
+    const duplicate = manifest.edges.some((e2) => e2.from === from && e2.to === to2) || newEdges.some((e2) => e2.from === from && e2.to === to2);
+    if (duplicate)
+      return;
+    newEdges.push({
+      from,
+      to: to2,
+      ...input.description ? { description: input.description } : {},
+      ...input.payloadSchema ? { payload_schema: input.payloadSchema } : {}
+    });
+  };
+  for (const f4 of input.from)
+    addEdge(f4, input.slug);
+  for (const t of input.to)
+    addEdge(input.slug, t);
+  return { ...manifest, members, edges: [...manifest.edges, ...newEdges] };
+}
+
+// src/cli/orchestration-add-agent.ts
+async function runOrchestrationAddAgent(cwd2, args) {
+  banner("orchestration add-agent — create a member agent and wire it into the graph");
+  const link2 = readOrchLink(cwd2);
+  if (!link2 || !hasOrchManifest(cwd2)) {
+    f2.warn("This folder is not a linked orchestration.");
+    f2.info(`Run ${import_picocolors37.default.cyan("brainbase orchestration pull <id>")} first.`);
+    return;
+  }
+  let manifest;
+  try {
+    manifest = readOrchManifest(cwd2);
+  } catch (err) {
+    f2.error(err.message);
+    return;
+  }
+  let name = args.name?.trim();
+  if (!name) {
+    name = (await text({
+      message: "New agent name",
+      placeholder: "e.g. Refund Bot",
+      validate: (v3) => !v3?.trim() ? "Required" : undefined,
+      flagHint: "Pass the name positionally or with --name."
+    })).trim();
+  }
+  let slug = slugifyMemberName(name);
+  if (manifest.members.some((m3) => m3.slug === slug) || fs51.existsSync(memberDir(cwd2, slug))) {
+    let n = 2;
+    let candidate = `${slug}-${n}`;
+    while (manifest.members.some((m3) => m3.slug === candidate) || fs51.existsSync(memberDir(cwd2, candidate))) {
+      candidate = `${slug}-${++n}`;
+    }
+    f2.info(`Slug ${import_picocolors37.default.bold(slug)} is taken — using ${import_picocolors37.default.bold(candidate)}.`);
+    slug = candidate;
+  }
+  let payloadSchema;
+  try {
+    payloadSchema = parseEdgeSchema(args.schema);
+  } catch (err) {
+    f2.error(err.message);
+    return;
+  }
+  let orgId = args.orgId;
+  if (!orgId) {
+    const sp = de();
+    sp.start("Resolving org for this orchestration…");
+    try {
+      const orgs = await api.listOrgs();
+      const orgsWithTeams = [];
+      for (const o2 of orgs) {
+        const teams = await api.listTeams(o2.id);
+        orgsWithTeams.push({ orgId: o2.id, teamIds: teams.map((t) => t.id) });
+      }
+      const resolved = resolveOrgIdForGroup(link2.group_id, orgsWithTeams);
+      if (!resolved) {
+        sp.stop("Failed.");
+        f2.error(`Could not find an org that owns group ${import_picocolors37.default.bold(link2.group_id)}. ` + `Pass ${import_picocolors37.default.cyan("--org <id>")} explicitly.`);
+        return;
+      }
+      orgId = resolved;
+      sp.stop("Resolved org.");
+    } catch (err) {
+      sp.stop("Failed.");
+      f2.error(err.message);
+      return;
+    }
+  }
+  let from = args.from ?? [];
+  let to2 = args.to ?? [];
+  let description = args.description;
+  if (from.length === 0 && to2.length === 0 && isInteractive() && manifest.members.length > 0) {
+    const memberOptions = manifest.members.map((m3) => ({ value: m3.slug, label: m3.slug }));
+    const pickedFrom = await ae({
+      message: `Connect ${import_picocolors37.default.bold(slug)} FROM which member(s)? — edges INTO ${slug} (space to select, enter to skip)`,
+      options: memberOptions,
+      required: false
+    });
+    if (Array.isArray(pickedFrom))
+      from = pickedFrom;
+    const pickedTo = await ae({
+      message: `Connect ${import_picocolors37.default.bold(slug)} TO which member(s)? — edges OUT of ${slug} (space to select, enter to skip)`,
+      options: memberOptions,
+      required: false
+    });
+    if (Array.isArray(pickedTo))
+      to2 = pickedTo;
+    if ((from.length > 0 || to2.length > 0) && description === undefined) {
+      const d3 = await te({ message: "Edge description (optional)" });
+      if (typeof d3 === "string" && d3.trim())
+        description = d3.trim();
+    }
+  }
+  let updated;
+  try {
+    updated = mergeMemberAndEdges(manifest, { slug, name, from, to: to2, description, payloadSchema });
+  } catch (err) {
+    f2.error(err.message);
+    return;
+  }
+  const dest = memberDir(cwd2, slug);
+  try {
+    fs51.mkdirSync(dest, { recursive: true });
+    await runAgentCreate(dest, {
+      name,
+      orgId,
+      teamId: link2.group_id,
+      harness: args.harness,
+      yes: true,
+      noTracking: true
+    });
+  } catch (err) {
+    try {
+      fs51.rmSync(dest, { recursive: true, force: true });
+    } catch {}
+    f2.error(`Failed to create ${slug}: ${err.message}`);
+    return;
+  }
+  writeOrchManifest(cwd2, updated);
+  if (args.noPush) {
+    f2.info(`Manifest updated. Run ${import_picocolors37.default.cyan("brainbase orchestration push")} to apply.`);
+    return;
+  }
+  await runOrchestrationPush(cwd2, { yes: true, graphOnly: true });
+}
+
 // src/cli/orchestration.ts
 async function runOrchestration(cwd2, sub, args, opts) {
   switch (sub) {
@@ -55501,6 +55716,20 @@ async function runOrchestration(cwd2, sub, args, opts) {
     case "ls":
       await runOrchestrationList({ orgId: opts.orgId, teamId: opts.teamId });
       return;
+    case "add-agent":
+    case "add":
+      await runOrchestrationAddAgent(cwd2, {
+        name: args[0] ?? opts.name,
+        from: opts.from,
+        to: opts.to,
+        description: opts.description,
+        schema: opts.schema,
+        harness: opts.harness,
+        orgId: opts.orgId,
+        noPush: opts.noPush,
+        yes: opts.yes
+      });
+      return;
     case undefined:
     case "help":
     case "-h":
@@ -55517,19 +55746,20 @@ async function runOrchestration(cwd2, sub, args, opts) {
 function printHelp2() {
   const out = [];
   out.push("");
-  out.push(`  ${import_picocolors37.default.bold("brainbase orchestration")} ${import_picocolors37.default.dim("<sub> [options]")}`);
+  out.push(`  ${import_picocolors38.default.bold("brainbase orchestration")} ${import_picocolors38.default.dim("<sub> [options]")}`);
   out.push("");
-  out.push(`  ${import_picocolors37.default.cyan("pull")} ${import_picocolors37.default.dim("<id>")}      ${import_picocolors37.default.dim("fetch orchestration + every member agent into this folder")}`);
-  out.push(`  ${import_picocolors37.default.cyan("push")}             ${import_picocolors37.default.dim("push each member, then update the orchestration graph")}`);
-  out.push(`  ${import_picocolors37.default.cyan("status")}           ${import_picocolors37.default.dim("show what would push and what would pull")}`);
-  out.push(`  ${import_picocolors37.default.cyan("list")}             ${import_picocolors37.default.dim("list orchestrations under a team")}`);
+  out.push(`  ${import_picocolors38.default.cyan("pull")} ${import_picocolors38.default.dim("<id>")}      ${import_picocolors38.default.dim("fetch orchestration + every member agent into this folder")}`);
+  out.push(`  ${import_picocolors38.default.cyan("push")}             ${import_picocolors38.default.dim("push each member, then update the orchestration graph")}`);
+  out.push(`  ${import_picocolors38.default.cyan("add-agent")} ${import_picocolors38.default.dim("<name>")}    ${import_picocolors38.default.dim("create a member agent, wire edges (--from/--to), and push")}`);
+  out.push(`  ${import_picocolors38.default.cyan("status")}           ${import_picocolors38.default.dim("show what would push and what would pull")}`);
+  out.push(`  ${import_picocolors38.default.cyan("list")}             ${import_picocolors38.default.dim("list orchestrations under a team")}`);
   out.push("");
-  out.push(`  ${import_picocolors37.default.bold("Flags")}`);
-  out.push(`    ${import_picocolors37.default.dim("--yes, -y")}        skip confirmations`);
-  out.push(`    ${import_picocolors37.default.dim("--harness <id>")}   harness for newly-created member folders (default claude-code)`);
-  out.push(`    ${import_picocolors37.default.dim("--graph-only")}     for push: only update members + edges, skip per-member push`);
-  out.push(`    ${import_picocolors37.default.dim("--org <id>")}       for list: org id (CLI vocab — DB teams.id)`);
-  out.push(`    ${import_picocolors37.default.dim("--team <id>")}      for list: team id (CLI vocab — DB groups.id)`);
+  out.push(`  ${import_picocolors38.default.bold("Flags")}`);
+  out.push(`    ${import_picocolors38.default.dim("--yes, -y")}        skip confirmations`);
+  out.push(`    ${import_picocolors38.default.dim("--harness <id>")}   harness for newly-created member folders (default claude-code)`);
+  out.push(`    ${import_picocolors38.default.dim("--graph-only")}     for push: only update members + edges, skip per-member push`);
+  out.push(`    ${import_picocolors38.default.dim("--org <id>")}       for list: org id (CLI vocab — DB teams.id)`);
+  out.push(`    ${import_picocolors38.default.dim("--team <id>")}      for list: team id (CLI vocab — DB groups.id)`);
   out.push("");
   console.log(out.join(`
 `));
@@ -55574,16 +55804,16 @@ async function runRun(cwd2, args) {
 }
 
 // src/cli/publish.ts
-var import_picocolors38 = __toESM(require_picocolors(), 1);
+var import_picocolors39 = __toESM(require_picocolors(), 1);
 async function runPublish(cwd2, _args) {
   banner("publish — send your changes to the team");
   const link2 = readLink(cwd2);
   if (!link2) {
     f2.warn("This folder is not linked to any agent.");
-    f2.info(`Run ${import_picocolors38.default.cyan("brainbase link")} first.`);
+    f2.info(`Run ${import_picocolors39.default.cyan("brainbase link")} first.`);
     return;
   }
-  f2.info(`${import_picocolors38.default.bold("publish")} is coming soon — for now, edit the agent on the web app and run ${import_picocolors38.default.cyan("brainbase sync")} to bring changes here.`);
+  f2.info(`${import_picocolors39.default.bold("publish")} is coming soon — for now, edit the agent on the web app and run ${import_picocolors39.default.cyan("brainbase sync")} to bring changes here.`);
 }
 
 // src/ui/ink/StatusCard.tsx
@@ -55881,7 +56111,7 @@ async function runStatus(cwd2) {
 }
 
 // src/cli/token.ts
-var import_picocolors39 = __toESM(require_picocolors(), 1);
+var import_picocolors40 = __toESM(require_picocolors(), 1);
 
 // src/ui/ink/TokenCards.tsx
 var jsx_dev_runtime17 = __toESM(require_jsx_dev_runtime(), 1);
@@ -56175,7 +56405,7 @@ async function runTokenRevoke(args) {
   }
   if (!autoProceed(args.yes)) {
     const ok = await se({
-      message: `Revoke token ${import_picocolors39.default.bold(args.id)}? CIs and machines using it will stop working.`,
+      message: `Revoke token ${import_picocolors40.default.bold(args.id)}? CIs and machines using it will stop working.`,
       initialValue: false
     });
     if (!ensureNotCancelled(ok))
@@ -56190,7 +56420,7 @@ async function runTokenRevoke(args) {
 }
 async function runTokenClear() {
   if (!readToken()) {
-    console.log(import_picocolors39.default.dim("No local token stored."));
+    console.log(import_picocolors40.default.dim("No local token stored."));
     return;
   }
   clearToken();
@@ -56241,17 +56471,17 @@ async function runToken(sub, rest2, args) {
 function printTokenHelp() {
   const out = [];
   out.push("");
-  out.push(`  ${import_picocolors39.default.bold("brainbase token")} ${import_picocolors39.default.dim("<command>")}`);
+  out.push(`  ${import_picocolors40.default.bold("brainbase token")} ${import_picocolors40.default.dim("<command>")}`);
   out.push("");
-  out.push(`  ${import_picocolors39.default.cyan("create")}                        ${import_picocolors39.default.dim("issue a new long-lived CLI key (PAT)")}`);
-  out.push(`  ${import_picocolors39.default.cyan("list")}                          ${import_picocolors39.default.dim("show your active tokens")}`);
-  out.push(`  ${import_picocolors39.default.cyan("revoke")} ${import_picocolors39.default.dim("<id>")}                  ${import_picocolors39.default.dim("revoke a token by id")}`);
-  out.push(`  ${import_picocolors39.default.cyan("clear")}                         ${import_picocolors39.default.dim("forget the local token (does not revoke)")}`);
+  out.push(`  ${import_picocolors40.default.cyan("create")}                        ${import_picocolors40.default.dim("issue a new long-lived CLI key (PAT)")}`);
+  out.push(`  ${import_picocolors40.default.cyan("list")}                          ${import_picocolors40.default.dim("show your active tokens")}`);
+  out.push(`  ${import_picocolors40.default.cyan("revoke")} ${import_picocolors40.default.dim("<id>")}                  ${import_picocolors40.default.dim("revoke a token by id")}`);
+  out.push(`  ${import_picocolors40.default.cyan("clear")}                         ${import_picocolors40.default.dim("forget the local token (does not revoke)")}`);
   out.push("");
-  out.push(`  ${import_picocolors39.default.bold("create flags")}`);
-  out.push(`  ${import_picocolors39.default.cyan("--name, -n")} ${import_picocolors39.default.dim("<label>")}        ${import_picocolors39.default.dim("token label (prompted if omitted)")}`);
-  out.push(`  ${import_picocolors39.default.cyan("--scopes")} ${import_picocolors39.default.dim("<list>")}           ${import_picocolors39.default.dim("comma-separated; allowed: read, publish, admin")}`);
-  out.push(`                                ${import_picocolors39.default.dim("default: read,publish")}`);
+  out.push(`  ${import_picocolors40.default.bold("create flags")}`);
+  out.push(`  ${import_picocolors40.default.cyan("--name, -n")} ${import_picocolors40.default.dim("<label>")}        ${import_picocolors40.default.dim("token label (prompted if omitted)")}`);
+  out.push(`  ${import_picocolors40.default.cyan("--scopes")} ${import_picocolors40.default.dim("<list>")}           ${import_picocolors40.default.dim("comma-separated; allowed: read, publish, admin")}`);
+  out.push(`                                ${import_picocolors40.default.dim("default: read,publish")}`);
   out.push("");
   console.log(out.join(`
 `));
@@ -56271,92 +56501,92 @@ var PROTECTED = new Set([
 function help() {
   const out = [];
   out.push("");
-  out.push(`  ${brandTint("◆")}  ${import_picocolors40.default.bold("brainbase")}  ${import_picocolors40.default.dim(`v${VERSION}`)}`);
-  out.push(`     ${import_picocolors40.default.dim("connect your local agent to the brainbase platform")}`);
+  out.push(`  ${brandTint("◆")}  ${import_picocolors41.default.bold("brainbase")}  ${import_picocolors41.default.dim(`v${VERSION}`)}`);
+  out.push(`     ${import_picocolors41.default.dim("connect your local agent to the brainbase platform")}`);
   out.push("");
   out.push(divider("USAGE"));
   out.push("");
-  out.push(`  ${import_picocolors40.default.bold("brainbase")} ${import_picocolors40.default.dim("<command> [options]")}`);
+  out.push(`  ${import_picocolors41.default.bold("brainbase")} ${import_picocolors41.default.dim("<command> [options]")}`);
   out.push("");
   out.push(divider("AUTH"));
   out.push("");
-  out.push(`  ${import_picocolors40.default.cyan("login")}     ${import_picocolors40.default.dim("  open the web app and connect this device")}`);
-  out.push(`  ${import_picocolors40.default.cyan("logout")}    ${import_picocolors40.default.dim("  clear the local session")}`);
-  out.push(`  ${import_picocolors40.default.cyan("whoami")}    ${import_picocolors40.default.dim("  show the current user")}`);
+  out.push(`  ${import_picocolors41.default.cyan("login")}     ${import_picocolors41.default.dim("  open the web app and connect this device")}`);
+  out.push(`  ${import_picocolors41.default.cyan("logout")}    ${import_picocolors41.default.dim("  clear the local session")}`);
+  out.push(`  ${import_picocolors41.default.cyan("whoami")}    ${import_picocolors41.default.dim("  show the current user")}`);
   out.push("");
   out.push(divider("LINKED AGENT"));
   out.push("");
-  out.push(`  ${import_picocolors40.default.cyan("agent create")}               ${import_picocolors40.default.dim("claim an unclaimed brainbase.agent.yaml and create the cloud agent")}`);
-  out.push(`  ${import_picocolors40.default.cyan("agent pull")} ${import_picocolors40.default.dim("[<id>]")}          ${import_picocolors40.default.dim("bring cloud changes into this folder (--force to override)")}`);
-  out.push(`  ${import_picocolors40.default.cyan("agent push")}                 ${import_picocolors40.default.dim("send local changes to the cloud")}`);
-  out.push(`  ${import_picocolors40.default.cyan("agent unpack")}               ${import_picocolors40.default.dim("install the claimed agent into a harness layout")}`);
-  out.push(`  ${import_picocolors40.default.cyan("link")}                       ${import_picocolors40.default.dim("attach this folder to an existing agent")}`);
-  out.push(`  ${import_picocolors40.default.cyan("agent status")}               ${import_picocolors40.default.dim("show what would pull and what would push")}`);
-  out.push(`  ${import_picocolors40.default.cyan("agent env")}                  ${import_picocolors40.default.dim("print export lines for `eval $(brainbase agent env)`")}`);
-  out.push(`  ${import_picocolors40.default.cyan("run")} ${import_picocolors40.default.dim("<cmd> [args...]")}         ${import_picocolors40.default.dim("run <cmd> with secrets.env loaded into env")}`);
-  out.push(`  ${import_picocolors40.default.cyan("status")}                     ${import_picocolors40.default.dim("show what this folder is linked to")}`);
-  out.push(`  ${import_picocolors40.default.cyan("unlink")}                     ${import_picocolors40.default.dim("disconnect this folder")}`);
+  out.push(`  ${import_picocolors41.default.cyan("agent create")}               ${import_picocolors41.default.dim("claim an unclaimed brainbase.agent.yaml and create the cloud agent")}`);
+  out.push(`  ${import_picocolors41.default.cyan("agent pull")} ${import_picocolors41.default.dim("[<id>]")}          ${import_picocolors41.default.dim("bring cloud changes into this folder (--force to override)")}`);
+  out.push(`  ${import_picocolors41.default.cyan("agent push")}                 ${import_picocolors41.default.dim("send local changes to the cloud")}`);
+  out.push(`  ${import_picocolors41.default.cyan("agent unpack")}               ${import_picocolors41.default.dim("install the claimed agent into a harness layout")}`);
+  out.push(`  ${import_picocolors41.default.cyan("link")}                       ${import_picocolors41.default.dim("attach this folder to an existing agent")}`);
+  out.push(`  ${import_picocolors41.default.cyan("agent status")}               ${import_picocolors41.default.dim("show what would pull and what would push")}`);
+  out.push(`  ${import_picocolors41.default.cyan("agent env")}                  ${import_picocolors41.default.dim("print export lines for `eval $(brainbase agent env)`")}`);
+  out.push(`  ${import_picocolors41.default.cyan("run")} ${import_picocolors41.default.dim("<cmd> [args...]")}         ${import_picocolors41.default.dim("run <cmd> with secrets.env loaded into env")}`);
+  out.push(`  ${import_picocolors41.default.cyan("status")}                     ${import_picocolors41.default.dim("show what this folder is linked to")}`);
+  out.push(`  ${import_picocolors41.default.cyan("unlink")}                     ${import_picocolors41.default.dim("disconnect this folder")}`);
   out.push("");
   out.push(divider("ORCHESTRATIONS"));
   out.push("");
-  out.push(`  ${import_picocolors40.default.cyan("orchestration list")}             ${import_picocolors40.default.dim("list orchestrations under a team")}`);
-  out.push(`  ${import_picocolors40.default.cyan("orchestration pull")} ${import_picocolors40.default.dim("<id>")}        ${import_picocolors40.default.dim("recursively fetch an orchestration + every member agent")}`);
-  out.push(`  ${import_picocolors40.default.cyan("orchestration push")}             ${import_picocolors40.default.dim("recursively push each member, then update the graph")}`);
-  out.push(`  ${import_picocolors40.default.cyan("orchestration status")}           ${import_picocolors40.default.dim("show what would push and what would pull")}`);
+  out.push(`  ${import_picocolors41.default.cyan("orchestration list")}             ${import_picocolors41.default.dim("list orchestrations under a team")}`);
+  out.push(`  ${import_picocolors41.default.cyan("orchestration pull")} ${import_picocolors41.default.dim("<id>")}        ${import_picocolors41.default.dim("recursively fetch an orchestration + every member agent")}`);
+  out.push(`  ${import_picocolors41.default.cyan("orchestration push")}             ${import_picocolors41.default.dim("recursively push each member, then update the graph")}`);
+  out.push(`  ${import_picocolors41.default.cyan("orchestration status")}           ${import_picocolors41.default.dim("show what would push and what would pull")}`);
   out.push("");
   out.push(divider("TEMPLATES"));
   out.push("");
-  out.push(`  ${import_picocolors40.default.cyan("template pack")}                       ${import_picocolors40.default.dim("bundle the current agent into a template")}`);
-  out.push(`  ${import_picocolors40.default.cyan("template publish")}                    ${import_picocolors40.default.dim("upload a template to the registry")}`);
-  out.push(`  ${import_picocolors40.default.cyan("template search")} ${import_picocolors40.default.dim("[query]")}             ${import_picocolors40.default.dim("search the registry")}`);
-  out.push(`  ${import_picocolors40.default.cyan("template info")}    ${import_picocolors40.default.dim("<creator/slug>")}     ${import_picocolors40.default.dim("show registry details for a template")}`);
-  out.push(`  ${import_picocolors40.default.cyan("template onboard")} ${import_picocolors40.default.dim("<creator/slug>")}     ${import_picocolors40.default.dim("install (or refresh) a template")}`);
-  out.push(`  ${import_picocolors40.default.cyan("template list")}                       ${import_picocolors40.default.dim("show installed templates")}`);
-  out.push(`  ${import_picocolors40.default.cyan("template remove")}  ${import_picocolors40.default.dim("<creator/slug>")}     ${import_picocolors40.default.dim("uninstall a template")}`);
+  out.push(`  ${import_picocolors41.default.cyan("template pack")}                       ${import_picocolors41.default.dim("bundle the current agent into a template")}`);
+  out.push(`  ${import_picocolors41.default.cyan("template publish")}                    ${import_picocolors41.default.dim("upload a template to the registry")}`);
+  out.push(`  ${import_picocolors41.default.cyan("template search")} ${import_picocolors41.default.dim("[query]")}             ${import_picocolors41.default.dim("search the registry")}`);
+  out.push(`  ${import_picocolors41.default.cyan("template info")}    ${import_picocolors41.default.dim("<creator/slug>")}     ${import_picocolors41.default.dim("show registry details for a template")}`);
+  out.push(`  ${import_picocolors41.default.cyan("template onboard")} ${import_picocolors41.default.dim("<creator/slug>")}     ${import_picocolors41.default.dim("install (or refresh) a template")}`);
+  out.push(`  ${import_picocolors41.default.cyan("template list")}                       ${import_picocolors41.default.dim("show installed templates")}`);
+  out.push(`  ${import_picocolors41.default.cyan("template remove")}  ${import_picocolors41.default.dim("<creator/slug>")}     ${import_picocolors41.default.dim("uninstall a template")}`);
   out.push("");
   out.push(divider("SKILLS"));
   out.push("");
-  out.push(`  ${import_picocolors40.default.cyan("skill add")} ${import_picocolors40.default.dim("<source>")}                  ${import_picocolors40.default.dim("install a skill (github / git / brainbase)")}`);
-  out.push(`  ${import_picocolors40.default.cyan("skill list")}                            ${import_picocolors40.default.dim("show locally installed skills + their source")}`);
-  out.push(`  ${import_picocolors40.default.cyan("skill update")} ${import_picocolors40.default.dim("<slug>")}                  ${import_picocolors40.default.dim("re-fetch a skill from its recorded source")}`);
-  out.push(`  ${import_picocolors40.default.cyan("skill remove")} ${import_picocolors40.default.dim("<slug>")}                  ${import_picocolors40.default.dim("uninstall a skill")}`);
-  out.push(`  ${import_picocolors40.default.cyan("skill search")} ${import_picocolors40.default.dim("[query]")}                 ${import_picocolors40.default.dim("search the brainbase skill registry")}`);
-  out.push(`  ${import_picocolors40.default.cyan("skill info")} ${import_picocolors40.default.dim("<creator/slug>")}            ${import_picocolors40.default.dim("show registry details for a skill")}`);
-  out.push(`  ${import_picocolors40.default.cyan("skill publish")} ${import_picocolors40.default.dim("[dir]")}                  ${import_picocolors40.default.dim("publish a SKILL.md folder (defaults to .)")}`);
+  out.push(`  ${import_picocolors41.default.cyan("skill add")} ${import_picocolors41.default.dim("<source>")}                  ${import_picocolors41.default.dim("install a skill (github / git / brainbase)")}`);
+  out.push(`  ${import_picocolors41.default.cyan("skill list")}                            ${import_picocolors41.default.dim("show locally installed skills + their source")}`);
+  out.push(`  ${import_picocolors41.default.cyan("skill update")} ${import_picocolors41.default.dim("<slug>")}                  ${import_picocolors41.default.dim("re-fetch a skill from its recorded source")}`);
+  out.push(`  ${import_picocolors41.default.cyan("skill remove")} ${import_picocolors41.default.dim("<slug>")}                  ${import_picocolors41.default.dim("uninstall a skill")}`);
+  out.push(`  ${import_picocolors41.default.cyan("skill search")} ${import_picocolors41.default.dim("[query]")}                 ${import_picocolors41.default.dim("search the brainbase skill registry")}`);
+  out.push(`  ${import_picocolors41.default.cyan("skill info")} ${import_picocolors41.default.dim("<creator/slug>")}            ${import_picocolors41.default.dim("show registry details for a skill")}`);
+  out.push(`  ${import_picocolors41.default.cyan("skill publish")} ${import_picocolors41.default.dim("[dir]")}                  ${import_picocolors41.default.dim("publish a SKILL.md folder (defaults to .)")}`);
   out.push("");
   out.push(divider("CLI TOKENS"));
   out.push("");
-  out.push(`  ${import_picocolors40.default.cyan("token create")}                        ${import_picocolors40.default.dim("issue a long-lived CLI key for CI / scripts")}`);
-  out.push(`  ${import_picocolors40.default.cyan("token list")}                          ${import_picocolors40.default.dim("show your active tokens")}`);
-  out.push(`  ${import_picocolors40.default.cyan("token revoke")} ${import_picocolors40.default.dim("<id>")}                  ${import_picocolors40.default.dim("revoke a token")}`);
+  out.push(`  ${import_picocolors41.default.cyan("token create")}                        ${import_picocolors41.default.dim("issue a long-lived CLI key for CI / scripts")}`);
+  out.push(`  ${import_picocolors41.default.cyan("token list")}                          ${import_picocolors41.default.dim("show your active tokens")}`);
+  out.push(`  ${import_picocolors41.default.cyan("token revoke")} ${import_picocolors41.default.dim("<id>")}                  ${import_picocolors41.default.dim("revoke a token")}`);
   out.push("");
   out.push(divider("FLAGS"));
   out.push("");
-  out.push(`  ${import_picocolors40.default.dim("--harness <id>")}     force harness for onboard / sync (e.g. claude-code)`);
-  out.push(`  ${import_picocolors40.default.dim("--scope <s>")}        force scope: global | project`);
-  out.push(`  ${import_picocolors40.default.dim("--yes, -y")}          skip confirmations / auto-overwrite`);
-  out.push(`  ${import_picocolors40.default.dim("--agent <id>")}       for link: attach this folder to an existing agent non-interactively`);
-  out.push(`  ${import_picocolors40.default.dim("--no-tracking")}      for link: skip routing LLM traffic through brainbase`);
-  out.push(`  ${import_picocolors40.default.dim("--track")}            for agent create: enable tracking non-interactively (off without a TTY)`);
-  out.push(`  ${import_picocolors40.default.dim("--shell <sh|fish>")}  for agent env: pick output format (auto-detected from $SHELL)`);
-  out.push(`  ${import_picocolors40.default.dim("--all")}              for template list: include installs from other folders`);
-  out.push(`  ${import_picocolors40.default.dim("--web <url>")}        for login: web app URL (default https://new.usekafka.com)`);
+  out.push(`  ${import_picocolors41.default.dim("--harness <id>")}     force harness for onboard / sync (e.g. claude-code)`);
+  out.push(`  ${import_picocolors41.default.dim("--scope <s>")}        force scope: global | project`);
+  out.push(`  ${import_picocolors41.default.dim("--yes, -y")}          skip confirmations / auto-overwrite`);
+  out.push(`  ${import_picocolors41.default.dim("--agent <id>")}       for link: attach this folder to an existing agent non-interactively`);
+  out.push(`  ${import_picocolors41.default.dim("--no-tracking")}      for link: skip routing LLM traffic through brainbase`);
+  out.push(`  ${import_picocolors41.default.dim("--track")}            for agent create: enable tracking non-interactively (off without a TTY)`);
+  out.push(`  ${import_picocolors41.default.dim("--shell <sh|fish>")}  for agent env: pick output format (auto-detected from $SHELL)`);
+  out.push(`  ${import_picocolors41.default.dim("--all")}              for template list: include installs from other folders`);
+  out.push(`  ${import_picocolors41.default.dim("--web <url>")}        for login: web app URL (default https://new.usekafka.com)`);
   out.push("");
   out.push(divider("ENV"));
   out.push("");
-  out.push(`  ${import_picocolors40.default.dim("BRAINBASE_HOME")}         override the local config dir (default ~/.brainbase)`);
-  out.push(`  ${import_picocolors40.default.dim("BRAINBASE_WEB_URL")}      override the web app URL used by login`);
-  out.push(`  ${import_picocolors40.default.dim("BRAINBASE_API_URL")}      override the API URL used by link / sync`);
-  out.push(`  ${import_picocolors40.default.dim("BRAINBASE_REGISTRY_URL")} override the registry API URL`);
-  out.push(`  ${import_picocolors40.default.dim("BRAINBASE_TOKEN")}        long-lived CLI PAT (overrides token.json)`);
-  out.push(`  ${import_picocolors40.default.dim("BRAINBASE_SKIP_AUTH")}    bypass the auth gate for development`);
-  out.push(`  ${import_picocolors40.default.dim("BRAINBASE_NON_INTERACTIVE")} force non-interactive mode — skip/auto-default prompts (CI & agents)`);
+  out.push(`  ${import_picocolors41.default.dim("BRAINBASE_HOME")}         override the local config dir (default ~/.brainbase)`);
+  out.push(`  ${import_picocolors41.default.dim("BRAINBASE_WEB_URL")}      override the web app URL used by login`);
+  out.push(`  ${import_picocolors41.default.dim("BRAINBASE_API_URL")}      override the API URL used by link / sync`);
+  out.push(`  ${import_picocolors41.default.dim("BRAINBASE_REGISTRY_URL")} override the registry API URL`);
+  out.push(`  ${import_picocolors41.default.dim("BRAINBASE_TOKEN")}        long-lived CLI PAT (overrides token.json)`);
+  out.push(`  ${import_picocolors41.default.dim("BRAINBASE_SKIP_AUTH")}    bypass the auth gate for development`);
+  out.push(`  ${import_picocolors41.default.dim("BRAINBASE_NON_INTERACTIVE")} force non-interactive mode — skip/auto-default prompts (CI & agents)`);
   out.push("");
   out.push(divider("HARNESSES"));
   out.push("");
-  out.push(`  ${import_picocolors40.default.dim("•")} ${import_picocolors40.default.bold("claude-code")}  ${import_picocolors40.default.dim("skills, mcps, agents, commands, playbooks, instructions, files")}`);
-  out.push(`  ${import_picocolors40.default.dim("•")} ${import_picocolors40.default.bold("codex")}        ${import_picocolors40.default.dim("skills, mcps, commands, playbooks, instructions, files")}`);
-  out.push(`  ${import_picocolors40.default.dim("•")} ${import_picocolors40.default.bold("kafka")}        ${import_picocolors40.default.dim("skills, mcps, agents, commands, playbooks, instructions, files")}`);
+  out.push(`  ${import_picocolors41.default.dim("•")} ${import_picocolors41.default.bold("claude-code")}  ${import_picocolors41.default.dim("skills, mcps, agents, commands, playbooks, instructions, files")}`);
+  out.push(`  ${import_picocolors41.default.dim("•")} ${import_picocolors41.default.bold("codex")}        ${import_picocolors41.default.dim("skills, mcps, commands, playbooks, instructions, files")}`);
+  out.push(`  ${import_picocolors41.default.dim("•")} ${import_picocolors41.default.bold("kafka")}        ${import_picocolors41.default.dim("skills, mcps, agents, commands, playbooks, instructions, files")}`);
   out.push("");
   console.log(out.join(`
 `));
@@ -56372,6 +56602,16 @@ function getFlag(args, ...names) {
   }
   return;
 }
+function getFlagAll(args, ...names) {
+  const out = [];
+  let v3 = getFlag(args, ...names);
+  while (v3 !== undefined) {
+    if (v3)
+      out.push(v3);
+    v3 = getFlag(args, ...names);
+  }
+  return out;
+}
 function hasFlag2(args, ...names) {
   for (const n of names) {
     const i = args.indexOf(n);
@@ -56400,13 +56640,13 @@ async function requireAuth(cmd) {
   if (status.ok)
     return;
   console.error("");
-  console.error(`  ${brandTint("◆")}  ${import_picocolors40.default.bold("brainbase")}`);
+  console.error(`  ${brandTint("◆")}  ${import_picocolors41.default.bold("brainbase")}`);
   console.error("");
-  console.error(`  ${import_picocolors40.default.red("✗")}  You need to sign in to use ${import_picocolors40.default.bold("brainbase " + cmd)}.`);
+  console.error(`  ${import_picocolors41.default.red("✗")}  You need to sign in to use ${import_picocolors41.default.bold("brainbase " + cmd)}.`);
   if (status.reason)
-    console.error(`     ${import_picocolors40.default.dim(status.reason)}`);
+    console.error(`     ${import_picocolors41.default.dim(status.reason)}`);
   console.error("");
-  console.error(`     Run ${import_picocolors40.default.cyan("brainbase login")} to connect this device.`);
+  console.error(`     Run ${import_picocolors41.default.cyan("brainbase login")} to connect this device.`);
   console.error("");
   process14.exit(1);
 }
@@ -56416,7 +56656,7 @@ async function main() {
   const rawCwd = process14.cwd();
   const cwd2 = (() => {
     try {
-      return fs51.realpathSync(rawCwd);
+      return fs52.realpathSync(rawCwd);
     } catch {
       return rawCwd;
     }
@@ -56451,6 +56691,11 @@ async function main() {
   const taglineFlag = getFlag(argv, "--tagline");
   const orgIdFlag = getFlag(argv, "--org");
   const teamIdFlag = getFlag(argv, "--team");
+  const fromFlags = getFlagAll(argv, "--from");
+  const toFlags = getFlagAll(argv, "--to");
+  const descriptionFlag = getFlag(argv, "--description");
+  const schemaFlag = getFlag(argv, "--schema");
+  const noPushFlag = hasFlag2(argv, "--no-push");
   ensureSkillResolversRegistered();
   await requireAuth(cmd);
   try {
@@ -56543,7 +56788,13 @@ async function main() {
           harness,
           orgId: orgIdFlag,
           teamId: teamIdFlag,
-          graphOnly: graphOnlyFlag
+          graphOnly: graphOnlyFlag,
+          name: nameFlag,
+          from: fromFlags,
+          to: toFlags,
+          description: descriptionFlag,
+          schema: schemaFlag,
+          noPush: noPushFlag
         });
         break;
       }
@@ -56562,7 +56813,7 @@ async function main() {
         process14.exit(1);
     }
   } catch (err) {
-    console.error(import_picocolors40.default.red(`
+    console.error(import_picocolors41.default.red(`
 ${err.message}`));
     if (process14.env.BRAINBASE_DEBUG)
       console.error(err.stack);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@brainbase-labs/cli",
-  "version": "0.8.3",
+  "version": "0.9.0",
   "description": "Pack, share, and install agent templates across harnesses (Claude Code, Codex, ...).",
   "type": "module",
   "bin": {