@caphub/cli 0.1.2 → 0.1.4

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,8 @@
 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 { createInterface } from "node:readline/promises";
 import { fileURLToPath } from "node:url";
 
 const __dirname = dirname(fileURLToPath(import.meta.url));
@@ -24,7 +26,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 +98,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 = "";
@@ -135,6 +158,22 @@ async function fetchJson(url, { method = "GET", body, apiKey = "" } = {}) {
   return data;
 }
 
+async function waitForEnterToOpen(url) {
+  if (process.env.CAPHUB_NO_OPEN === "1") return false;
+  if (!process.stdin.isTTY || !process.stdout.isTTY) return false;
+
+  const rl = createInterface({
+    input: process.stdin,
+    output: process.stdout,
+  });
+  try {
+    await rl.question("Press Enter to open the browser login page, or Ctrl+C to cancel.");
+  } finally {
+    rl.close();
+  }
+  return openUrl(url);
+}
+
 function parseFlag(args, name) {
   const idx = args.indexOf(name);
   if (idx === -1) return "";
@@ -317,12 +356,19 @@ async function commandAuth(args) {
       process.stdout.write([
         "caphub auth login",
         "",
-        "Open this URL in your browser and finish sign-in:",
-        started.approval_url,
-        "",
+        "This will open Caphub in your browser to approve CLI login.",
         `code: ${started.code}`,
         `expires_in_seconds: ${started.expires_in_seconds}`,
+        `url: ${started.approval_url}`,
         "",
+      ].join("\n"));
+
+      const opened = await waitForEnterToOpen(started.approval_url);
+      process.stdout.write([
+        process.env.CAPHUB_NO_OPEN === "1"
+          ? "browser_open: disabled by CAPHUB_NO_OPEN=1"
+          : `browser_open: ${opened ? "attempted" : "not attempted"}`,
+        opened ? "If the browser did not open, copy the URL above." : "Open the URL above in your browser.",
         "Waiting for website approval...",
         "",
       ].join("\n"));

package/package.json

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