@caphub/cli 0.1.2 → 0.1.3

package/README.md

@@ -16,10 +16,16 @@ npx @caphub/cli help
 
 ## Auth
 
-Store your API key once:
+Open the website approval flow:
 
 ```bash
-caphub auth login --api-key csk_live_...
+caphub auth login
+```
+
+For headless/cloud agents, put the key in the platform secret manager and expose it as:
+
+```bash
+CAPHUB_API_KEY=csk_live_...
 ```
 
 ## Discovery

package/bin/caphub.js

@@ -3,6 +3,7 @@
 import { mkdirSync, readFileSync, writeFileSync } from "node:fs";
 import os from "node:os";
 import { dirname, resolve } from "node:path";
+import { spawn } from "node:child_process";
 import { fileURLToPath } from "node:url";
 
 const __dirname = dirname(fileURLToPath(import.meta.url));
@@ -24,7 +25,7 @@ commands:
   help <capability>     show capability-specific help from the API
   capabilities          list live capabilities with short descriptions
   auth                  show current login state
-  auth login            website login flow; stores api key locally after approval
+  auth login            open website login flow; stores api key locally after approval
   auth whoami           verify the current api key against the API
   auth logout           remove stored api key from local config
   <capability> <json>   run a capability directly, e.g. search or search-ideas
@@ -96,6 +97,27 @@ function fail(message) {
   process.exit(1);
 }
 
+function openUrl(url) {
+  if (process.env.CAPHUB_NO_OPEN === "1") return false;
+
+  const command = process.platform === "darwin"
+    ? "open"
+    : process.platform === "win32"
+      ? "cmd"
+      : "xdg-open";
+  const args = process.platform === "win32"
+    ? ["/c", "start", "", url]
+    : [url];
+
+  try {
+    const child = spawn(command, args, { detached: true, stdio: "ignore" });
+    child.unref();
+    return true;
+  } catch {
+    return false;
+  }
+}
+
 function readStdin() {
   return new Promise((resolveInput) => {
     let data = "";
@@ -314,14 +336,18 @@ async function commandAuth(args) {
     if (!explicitApiKey && !args.includes("--api-key")) {
       const apiUrl = getApiUrl();
       const started = await fetchJson(`${apiUrl}/v1/auth/cli/start`, { method: "POST", body: {} });
+      const opened = openUrl(started.approval_url);
       process.stdout.write([
         "caphub auth login",
         "",
-        "Open this URL in your browser and finish sign-in:",
+        opened
+          ? "Opened the browser approval page. If it did not open, use this URL:"
+          : "Open this URL in your browser and finish sign-in:",
         started.approval_url,
         "",
         `code: ${started.code}`,
         `expires_in_seconds: ${started.expires_in_seconds}`,
+        process.env.CAPHUB_NO_OPEN === "1" ? "browser_open: disabled by CAPHUB_NO_OPEN=1" : `browser_open: ${opened ? "attempted" : "failed"}`,
         "",
         "Waiting for website approval...",
         "",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@caphub/cli",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "description": "Root CLI for Caphub agent capabilities",
   "type": "module",
   "bin": {