@brainbase-labs/cli 0.10.1 → 0.11.0

package/dist/index.js

@@ -29449,7 +29449,7 @@ function padStart(s, n) {
 // package.json
 var package_default = {
   name: "@brainbase-labs/cli",
-  version: "0.10.1",
+  version: "0.11.0",
   description: "Pack, share, and install agent templates across harnesses (Claude Code, Codex, ...).",
   type: "module",
   bin: {
@@ -52792,6 +52792,14 @@ function diffSecrets(local, cloud) {
   };
 }
 
+// src/core/entrypoint-gate.ts
+function entrypointExecutionAllowed(opts) {
+  if (opts.flag)
+    return true;
+  const v3 = (opts.env.BRAINBASE_RUN_ENTRYPOINT ?? "").trim().toLowerCase();
+  return v3 === "1" || v3 === "true";
+}
+
 // src/cli/agent-pull.ts
 async function runAgentPull(cwd2, args) {
   banner("agent pull — bring cloud changes into this folder");
@@ -53007,7 +53015,7 @@ async function runAgentPull(cwd2, args) {
     };
     writeSyncState(cwd2, newState);
     await pullSecrets(cwd2, agentId);
-    await runEntrypointIfPresent(cwd2, yaml);
+    await runEntrypointIfPresent(cwd2, yaml, entrypointExecutionAllowed({ flag: args.runEntrypoint, env: process.env }));
     $e(`Pulled ${cloudAgent.name} at revision ${cloud.revision}.`);
   } finally {
     try {
@@ -53326,7 +53334,7 @@ function buildLinkFromAgent(agent, harness, prev) {
     tracking: prev?.tracking
   };
 }
-async function runEntrypointIfPresent(cwd2, manifest) {
+async function runEntrypointIfPresent(cwd2, manifest, execute) {
   if (!manifest.entrypoint)
     return;
   const body = resolveEntrypoint(cwd2, manifest);
@@ -53340,6 +53348,10 @@ async function runEntrypointIfPresent(cwd2, manifest) {
   try {
     fs45.chmodSync(scriptPath, 493);
   } catch {}
+  if (!execute) {
+    f2.info(`Agent has an entrypoint — written to ${import_picocolors25.default.dim(path48.relative(cwd2, scriptPath))}, not executed. ` + `Run it with ${import_picocolors25.default.cyan("brainbase run bash .brainbase/entrypoint.sh")} or re-pull with ${import_picocolors25.default.cyan("--run-entrypoint")}. Sandboxes run it automatically.`);
+    return;
+  }
   f2.info(`Running entrypoint ${import_picocolors25.default.dim(`(${path48.relative(cwd2, scriptPath)})`)}`);
   const secrets = readLocalSecrets(cwd2);
   const env3 = { ...process.env, ...secrets };
@@ -54811,7 +54823,8 @@ async function runAgent(cwd2, sub, args, opts) {
         yes: opts.yes,
         scope: opts.scope,
         agentIdArg: args[0],
-        force: opts.force
+        force: opts.force,
+        runEntrypoint: opts.runEntrypoint
       });
       return;
     case "push":
@@ -54849,7 +54862,7 @@ function printHelp() {
   out.push(`  ${import_picocolors32.default.bold("brainbase agent")} ${import_picocolors32.default.dim("<sub> [options]")}`);
   out.push("");
   out.push(`  ${import_picocolors32.default.cyan("create")}             ${import_picocolors32.default.dim("claim an unclaimed brainbase.agent.yaml and create the cloud agent")}`);
-  out.push(`  ${import_picocolors32.default.cyan("pull")} ${import_picocolors32.default.dim("[<id>]")}      ${import_picocolors32.default.dim("apply cloud changes into this folder — pass <id> to switch (--force to override)")}`);
+  out.push(`  ${import_picocolors32.default.cyan("pull")} ${import_picocolors32.default.dim("[<id>]")}      ${import_picocolors32.default.dim("apply cloud changes into this folder — pass <id> to switch (--force to override); --run-entrypoint to also execute the agent entrypoint")}`);
   out.push(`  ${import_picocolors32.default.cyan("push")}               ${import_picocolors32.default.dim("send local changes to the cloud")}`);
   out.push(`  ${import_picocolors32.default.cyan("unpack")}             ${import_picocolors32.default.dim("install the claimed agent into a harness layout (--harness to override)")}`);
   out.push(`  ${import_picocolors32.default.cyan("status")}             ${import_picocolors32.default.dim("show what would push and what would pull")}`);
@@ -56782,7 +56795,7 @@ function help() {
   out.push(divider("LINKED AGENT"));
   out.push("");
   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 pull")} ${import_picocolors41.default.dim("[<id>]")}          ${import_picocolors41.default.dim("bring cloud changes into this folder (--force to override; --run-entrypoint to also execute the agent entrypoint)")}`);
   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")}`);
@@ -56846,6 +56859,7 @@ function help() {
   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(`  ${import_picocolors41.default.dim("BRAINBASE_RUN_ENTRYPOINT")} =1 → agent pull executes the agent entrypoint (sandbox boots; or pass --run-entrypoint)`);
   out.push("");
   out.push(divider("HARNESSES"));
   out.push("");
@@ -56950,6 +56964,7 @@ async function main() {
   const noTracking = hasFlag2(argv, "--no-tracking");
   const track = hasFlag2(argv, "--track");
   const forceFlag = hasFlag2(argv, "--force");
+  const runEntrypointFlag = hasFlag2(argv, "--run-entrypoint");
   const graphOnlyFlag = hasFlag2(argv, "--graph-only");
   const nameFlag = getFlag(argv, "--name");
   const skillVersionFlag = getFlag(argv, "--skill-version");
@@ -57041,7 +57056,8 @@ async function main() {
           teamId: teamIdFlag,
           noTracking,
           track,
-          force: forceFlag
+          force: forceFlag,
+          runEntrypoint: runEntrypointFlag
         });
         break;
       }

package/package.json

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