@great-arrow/cli 0.1.23 → 0.1.26

package/README.md

@@ -153,7 +153,31 @@ gad mcp install gemini
 ```
 
 `gad mcp install codex` writes Codex's native `~/.codex/config.toml` server
-entry and stores the bearer token in `~/.codex/.env`.
+entry and stores the bearer token in `~/.codex/.env`. The entry launches the
+stdio bridge, which detects the current checkout's git origin for every Codex
+session; it does not pin one repository in the global config.
+
+Workspace targeting precedence is explicit command target, current git repo,
+then the saved default outside a repo:
+
+```bash
+# One command only; accepts an id, slug, or exact name.
+gad --workspace great-arrow-digital todo list
+
+# Save a default and see the previous/current workspace in the confirmation.
+gad workspace switch great-arrow-digital
+
+# Inside a linked git checkout, the repo workspace wins over that saved default.
+gad workspace list
+```
+
+`workspace_list` and `tools_discover` are compact by default. MCP callers can
+request `detail:"full"` when diagnostics are needed; when a stable tool name is
+known, `tools_discover({ tool_name: exactName })` returns one schema without
+walking the full catalog or performing session/recommendation datastore reads.
+High-frequency `todo_log` and `work_heartbeat` calls skip the enrichment batch
+and render a single branded line, preserving the current workspace cue without
+repeating board/status payloads.
 
 #### Keeping local MCP installs current
 

package/dist/index.js

@@ -9399,7 +9399,7 @@ function isNodeError(value) {
 
 // src/lib/version.ts
 var CLI_PACKAGE_NAME = "@great-arrow/cli";
-var CLI_VERSION = "0.1.23";
+var CLI_VERSION = "0.1.26";
 var GAD_INSTALL_VERSION = "2026.08.08";
 var GAD_INSTALL_MIN_VERSION = "2026.06.22";
 var GAD_INSTALL_HEADER = "X-GAD-Install-Version";
@@ -10508,6 +10508,17 @@ async function captureCliEvent(input) {
   }
 }
 
+// src/lib/workspace-target.ts
+var commandWorkspaceTarget;
+var savedWorkspaceTarget;
+function setCommandWorkspaceTarget(target, savedDefault) {
+  commandWorkspaceTarget = target?.trim() || void 0;
+  savedWorkspaceTarget = savedDefault?.trim() || void 0;
+}
+function getCommandWorkspaceTarget(options = {}) {
+  return commandWorkspaceTarget ?? (options.hasRepo ? void 0 : savedWorkspaceTarget);
+}
+
 // src/lib/client.ts
 var DEFAULT_TIMEOUT_MS2 = 3e4;
 var MAX_RETRIES = 5;
@@ -10560,11 +10571,13 @@ var GadClient = class {
   token;
   apiUrl;
   repoUrl;
+  workspaceId;
   timeout;
   constructor(options) {
     this.token = options.token;
     this.apiUrl = options.apiUrl.replace(/\/$/, "");
     this.repoUrl = options.repoUrl ?? detectGitOrigin();
+    this.workspaceId = options.workspaceId?.trim() || getCommandWorkspaceTarget({ hasRepo: Boolean(this.repoUrl) }) || null;
     this.timeout = options.timeout ?? DEFAULT_TIMEOUT_MS2;
   }
   /**
@@ -10582,6 +10595,9 @@ var GadClient = class {
     if (this.repoUrl) {
       headers["X-Repo-URL"] = this.repoUrl;
     }
+    if (this.workspaceId) {
+      headers["X-Workspace-Id"] = this.workspaceId;
+    }
     return headers;
   }
   /**
@@ -11137,11 +11153,22 @@ var switchCommand = new Command("switch").description("Set the active workspace
     noColor: false
   });
   const client = await createClient();
-  await client.mcpCall("workspace_switch", { workspaceId: nameOrId });
+  const result = await client.mcpCall("workspace_switch", {
+    workspaceId: nameOrId
+  });
+  const payload = typeof result === "object" && result !== null ? result : {};
+  const current = typeof payload.current_workspace === "object" && payload.current_workspace !== null ? payload.current_workspace : null;
+  const resolvedId = typeof current?.id === "string" ? current.id : nameOrId;
+  const resolvedName = typeof current?.name === "string" ? current.name : nameOrId;
   const config = await loadConfig();
-  config.default_workspace = nameOrId;
+  config.default_workspace = resolvedId;
   await saveConfig(config);
-  fmt.success(`Switched to workspace: ${nameOrId}`);
+  const previous = typeof payload.previous_workspace === "object" && payload.previous_workspace !== null ? payload.previous_workspace : null;
+  const previousName = typeof previous?.name === "string" ? previous.name : null;
+  const previousId = typeof previous?.id === "string" ? previous.id : void 0;
+  fmt.success(
+    previousName && previousId && previousName !== resolvedName ? `Switched workspace: ${previousName} \u2192 ${resolvedName} (use '${previousId}' to switch back)` : `Working in workspace: ${resolvedName}`
+  );
 });
 var infoColumns = [
   { key: "name", header: "Name" },
@@ -12746,19 +12773,19 @@ function repoKey(repoUrl) {
     return null;
   }
 }
-function generateCodexConfigToml(apiUrl, repoUrl) {
-  const repoHeader = repoUrl ? `X-Repo-URL = "${tomlEscape(repoUrl)}"
-` : "";
+function generateCodexConfigToml(apiUrl, _repoUrl) {
   return `${CODEX_APPROVAL_POLICY}
 
 [mcp_servers.${CODEX_SERVER_NAME}]
-url = "${tomlEscape(mcpEndpoint(apiUrl))}"
-bearer_token_env_var = "GREAT_ARROW_TOKEN"
+command = "npx"
+args = ["-y", "@great-arrow/cli", "mcp", "start"]
+env_vars = ["GREAT_ARROW_TOKEN"]
 
-[mcp_servers.${CODEX_SERVER_NAME}.http_headers]
-X-MCP-Client = "${CODEX_CLIENT_ID}"
+[mcp_servers.${CODEX_SERVER_NAME}.env]
+GAD_API_URL = "${tomlEscape(normalizeApiUrl(apiUrl))}"
+GAD_MCP_CLIENT = "${CODEX_CLIENT_ID}"
 ${GAD_INSTALL_HEADER} = "${GAD_INSTALL_VERSION}"
-${repoHeader}`;
+`;
 }
 function generateCodexEnv(token) {
   return `GREAT_ARROW_TOKEN=${token}
@@ -12770,8 +12797,10 @@ function extractCodexGreatArrowApiUrl(content) {
   );
   if (!text2) return null;
   const match = text2.match(/^\s*url\s*=\s*"([^"]+)"\s*$/m);
-  if (!match?.[1]) return null;
-  const url = match[1].trim();
+  const dynamicMatch = text2.match(/^\s*GAD_API_URL\s*=\s*"([^"]+)"\s*$/m);
+  const configured = match?.[1] ?? dynamicMatch?.[1];
+  if (!configured) return null;
+  const url = configured.trim();
   return url.endsWith("/api/mcp") ? url.slice(0, -"/api/mcp".length) : url.replace(/\/+$/, "");
 }
 function splitTomlSections(content) {
@@ -12887,6 +12916,7 @@ function inspectCodexConfig(content, expectedRepoUrl) {
   const hasGreatArrowServer = grouped.has(CODEX_SERVER_NAME);
   const greatArrowInstallVersion = extractInstallVersion(greatArrowText);
   const greatArrowRepoKeys = extractConfiguredRepoKeys(greatArrowText);
+  const greatArrowUsesDynamicRepo = /^\s*command\s*=\s*"npx"\s*$/m.test(greatArrowText) && /@great-arrow\/cli/.test(greatArrowText) && /"mcp"\s*,\s*"start"/.test(greatArrowText) && !/(?:MEMORY_REPO_URL|GAD_REPO_URL)\s*=/.test(greatArrowText);
   const greatArrowHasRepoHeader = Boolean(
     expectedRepoKey && greatArrowRepoKeys.includes(expectedRepoKey)
   );
@@ -12916,10 +12946,10 @@ function inspectCodexConfig(content, expectedRepoUrl) {
   );
   if (expectedRepoKey) {
     issues.push(
-      greatArrowHasRepoHeader ? {
-        code: "repo_header_present",
+      greatArrowHasRepoHeader || greatArrowUsesDynamicRepo ? {
+        code: greatArrowUsesDynamicRepo ? "repo_routing_dynamic" : "repo_header_present",
         level: "pass",
-        message: `Great Arrow is pinned to ${expectedRepoUrl}.`
+        message: greatArrowUsesDynamicRepo ? "Great Arrow detects the current git origin for each Codex session." : `Great Arrow is pinned to ${expectedRepoUrl}.`
       } : {
         code: "repo_header_missing",
         level: "warn",
@@ -12985,6 +13015,7 @@ function inspectCodexConfig(content, expectedRepoUrl) {
     expectedRepoKey,
     hasGreatArrowServer,
     greatArrowHasRepoHeader,
+    greatArrowUsesDynamicRepo,
     greatArrowInstallVersion,
     greatArrowInstallVersionCurrent: Boolean(greatArrowInstallVersion) && compareVersion(greatArrowInstallVersion, GAD_INSTALL_VERSION) >= 0,
     unmanagedServers,
@@ -14921,7 +14952,8 @@ async function resolveBridgeAuth(options = {}) {
   const explicit = [
     [options.tokenFlag, "flag"],
     [env4.GAD_API_TOKEN, "GAD_API_TOKEN"],
-    [env4.GAD_TOKEN, "GAD_TOKEN"]
+    [env4.GAD_TOKEN, "GAD_TOKEN"],
+    [env4.GREAT_ARROW_TOKEN, "GREAT_ARROW_TOKEN"]
   ];
   for (const [raw, source] of explicit) {
     const token = raw?.trim();
@@ -14966,12 +14998,15 @@ function buildBridgeHeaders(options) {
     accept: "application/json",
     authorization: `Bearer ${options.token}`,
     "user-agent": `gad-cli/${CLI_VERSION} gad-install/${GAD_INSTALL_VERSION}`,
-    "x-mcp-client": BRIDGE_CLIENT_ID,
+    "x-mcp-client": options.clientId?.trim().slice(0, 64) || BRIDGE_CLIENT_ID,
     [GAD_CLI_VERSION_HEADER]: CLI_VERSION,
     [GAD_INSTALL_HEADER]: GAD_INSTALL_VERSION
   };
   if (options.repoUrl) headers["x-repo-url"] = options.repoUrl;
+  if (options.workspaceId) headers["x-workspace-id"] = options.workspaceId;
   if (options.sessionId) headers["x-mcp-session-id"] = options.sessionId;
+  if (options.deviceName) headers["x-device-name"] = options.deviceName;
+  if (options.machineId) headers["x-machine-id"] = options.machineId;
   return headers;
 }
 function rpcError(id, code, message) {
@@ -15053,13 +15088,18 @@ async function runStdioBridge(options) {
   const timeoutMs = Number(env4.MEMORY_TIMEOUT_MS ?? DEFAULT_TIMEOUT_MS3);
   const sessionId = (env4.GAD_SESSION_ID ?? env4.MEMORY_SESSION_ID)?.trim() || `${BRIDGE_CLIENT_ID}:${Date.now()}-${randomUUID().slice(0, 8)}`;
   const repoUrl = (env4.GAD_REPO_URL ?? env4.MEMORY_REPO_URL)?.trim() || detectGitOrigin3();
+  const workspaceId = (env4.GAD_WORKSPACE_ID ?? env4.GAD_WORKSPACE)?.trim() || getCommandWorkspaceTarget({ hasRepo: Boolean(repoUrl) });
   const headers = buildBridgeHeaders({
     token: options.auth.token,
     repoUrl,
-    sessionId
+    workspaceId,
+    sessionId,
+    clientId: env4.GAD_MCP_CLIENT,
+    deviceName: env4.GAD_DEVICE_NAME,
+    machineId: env4.GAD_MACHINE_ID
   });
   writeErr(
-    `[gad mcp] Bridging stdio \u2194 ${endpoint} (auth: ${options.auth.source}${repoUrl ? `, repo: ${repoUrl}` : ""})`
+    `[gad mcp] Bridging stdio \u2194 ${endpoint} (auth: ${options.auth.source}${workspaceId ? `, workspace: ${workspaceId}` : ""}${repoUrl ? `, repo: ${repoUrl}` : ""})`
   );
   const config = { endpoint, headers, timeoutMs };
   const rl = createInterface2({ input, crlfDelay: Infinity });
@@ -17247,12 +17287,25 @@ function normalizeGlance(raw) {
       };
     }
   }
+  let warRoom = null;
+  if (typeof obj.warRoom === "object" && obj.warRoom !== null) {
+    const w = obj.warRoom;
+    warRoom = {
+      priorityCount: typeof w.priorityCount === "number" ? w.priorityCount : 0,
+      unreadTotal: typeof w.unreadTotal === "number" ? w.unreadTotal : 0,
+      openRequestCount: typeof w.openRequestCount === "number" ? w.openRequestCount : 0,
+      topSender: typeof w.topSender === "string" ? w.topSender : null,
+      newestSender: typeof w.newestSender === "string" ? w.newestSender : null,
+      newestPreview: typeof w.newestPreview === "string" ? w.newestPreview : null
+    };
+  }
   return {
     workspace: typeof obj.workspace === "string" && obj.workspace !== "" ? obj.workspace : null,
     needsYou,
     topGoal,
     integrations,
     agents,
+    warRoom,
     urgency: typeof obj.urgency === "number" ? obj.urgency : null,
     generatedAt: typeof obj.generatedAt === "string" ? obj.generatedAt : (/* @__PURE__ */ new Date()).toISOString()
   };
@@ -17261,6 +17314,9 @@ function asArray2(value) {
   return Array.isArray(value) ? value : [];
 }
 function topSignature(payload) {
+  if (payload.warRoom && payload.warRoom.priorityCount > 0) {
+    return `warroom:${payload.warRoom.newestSender ?? "peer"}`;
+  }
   const top = payload.needsYou[0];
   if (top) return `needs:${top.kind}:${top.title}`;
   const integration = payload.integrations[0];
@@ -17306,6 +17362,12 @@ function glanceItemUrl(href, apiUrl) {
 function renderFooter(payload, apiUrl) {
   const c = createColor(false);
   const lines = [];
+  const wr = payload.warRoom;
+  if (wr && wr.priorityCount > 0) {
+    lines.push(
+      `${c.yellow("!")} ${wr.priorityCount} war-room message${wr.priorityCount === 1 ? "" : "s"} for you${wr.newestSender ? ` \u2014 ${wr.newestSender}` : ""}`
+    );
+  }
   for (const item of payload.needsYou.slice(0, 2)) {
     lines.push(`${c.yellow("!")} ${item.title}`);
     if (item.action) {
@@ -17329,10 +17391,12 @@ function renderFooter(payload, apiUrl) {
   lines.push(`${c.dim("\u2192")} ${c.cyan("gad status")} for the full picture.`);
   process.stderr.write("\n" + brandedBlock("needs you", lines) + "\n");
 }
+var GAD_LOGO = `<img src="https://www.greatarrow.ai/icon.svg" width="16" alt="Great Arrow" style="vertical-align:middle;display:inline-block;margin-right:4px;" />`;
 function brandedBlock(title, lines) {
-  const header = `\u{1F3F9} Great Arrow \xB7 ${title}`;
-  const rule = "\u2500".repeat(Math.min(60, header.length));
-  return [header, rule, ...lines].join("\n");
+  const header = `${GAD_LOGO} **Great Arrow** \xB7 ${title}`;
+  const visualLength = header.replace(GAD_LOGO, "  ").length;
+  const rule = "\u2500".repeat(Math.min(60, visualLength));
+  return [header, rule, ...lines].join("\\n");
 }
 
 // src/commands/status.ts
@@ -17383,7 +17447,7 @@ function renderStatus(payload, plain, apiUrl) {
     lines.push(c.badge(` ${payload.workspace} `));
     lines.push("");
   }
-  const hasAny = payload.needsYou.length > 0 || payload.topGoal !== null || payload.integrations.length > 0 || payload.agents.length > 0;
+  const hasAny = payload.needsYou.length > 0 || payload.topGoal !== null || payload.integrations.length > 0 || payload.agents.length > 0 || payload.warRoom !== null && payload.warRoom.priorityCount > 0;
   if (!hasAny) {
     lines.push(
       `${c.green("\u2713")} You're all clear \u2014 nothing needs you right now.`
@@ -17391,6 +17455,20 @@ function renderStatus(payload, plain, apiUrl) {
     process.stdout.write(brandedBlock("status", lines) + "\n");
     return;
   }
+  if (payload.warRoom && payload.warRoom.priorityCount > 0) {
+    const wr = payload.warRoom;
+    lines.push(c.bold("War room"));
+    lines.push(
+      `  ${c.yellow("!")} ${wr.priorityCount} message${wr.priorityCount === 1 ? "" : "s"} for you${wr.newestSender ? ` \u2014 ${wr.newestSender}` : ""}`
+    );
+    if (wr.newestPreview) {
+      lines.push(`      ${c.dim(wr.newestPreview)}`);
+    }
+    lines.push(
+      `      ${c.dim("\u2192")} ${c.cyan(glanceItemUrl("/team?tab=war-room", apiUrl) ?? "")}`
+    );
+    lines.push("");
+  }
   if (payload.needsYou.length > 0) {
     lines.push(c.bold("Needs you"));
     for (const item of payload.needsYou) {
@@ -21216,7 +21294,18 @@ if (shouldRunUpdateNotifier(process.argv)) {
     pkg: { name: CLI_PACKAGE_NAME, version: CLI_VERSION }
   }).notify();
 }
-var program2 = new Command().name("gad").description("Great Arrow Digital CLI \u2014 terminal access to the GAD platform").version(CLI_VERSION, "-v, --version").option("--json", "Output as JSON").option("--quiet", "Suppress decorative output").option("--no-color", "Disable color output").option("--no-glance", "Suppress the ambient proactive footer");
+var program2 = new Command().name("gad").description("Great Arrow Digital CLI \u2014 terminal access to the GAD platform").version(CLI_VERSION, "-v, --version").option("--json", "Output as JSON").option("--quiet", "Suppress decorative output").option("--no-color", "Disable color output").option("--no-glance", "Suppress the ambient proactive footer").option(
+  "--workspace <id-or-slug-or-name>",
+  "Target one accessible workspace for this command without changing the saved default"
+);
+program2.hook(
+  "preAction",
+  async (_thisCommand, actionCommand) => {
+    const options = actionCommand.optsWithGlobals();
+    const config = await loadConfig();
+    setCommandWorkspaceTarget(options.workspace, config.default_workspace);
+  }
+);
 void captureCliEvent({
   apiUrl: process.env.GAD_API_URL ?? "https://www.greatarrow.ai",
   name: "startup",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@great-arrow/cli",
-  "version": "0.1.23",
+  "version": "0.1.26",
   "description": "GreatArrow.ai CLI tool",
   "type": "module",
   "bin": {
@@ -19,10 +19,11 @@
   "dependencies": {
     "@napi-rs/keyring": "1.3.0",
     "commander": "^15.0.0",
-    "update-notifier": "^7.3.1"
+    "update-notifier": "^7.3.1",
+    "nanoid": "^3.3.18"
   },
   "devDependencies": {
-    "@types/node": "^26.1.1",
+    "@types/node": "^26.1.2",
     "esbuild": "^0.28.1",
     "fast-check": "^4.9.0",
     "typescript": "^7.0.2",
@@ -47,6 +48,6 @@
   "author": "GreatArrow.ai <support@greatarrow.ai>",
   "overrides": {
     "postcss": ">=8.5.23",
-    "nanoid": "^3.3.17"
+    "nanoid": "^3.3.18"
   }
 }