agendex-cli 0.9.1 → 0.10.1

package/README.md

@@ -1,6 +1,6 @@
 # `agendex-cli`
 
-Node-compatible Agendex CLI for browser login, one-shot sync, daemon supervision, status checks, and daemon cleanup.
+Node-compatible Agendex CLI for browser login, opening the web app, one-shot sync, daemon supervision, status checks, and daemon cleanup.
 
 ## Install
 
@@ -16,6 +16,8 @@ bun install -g agendex-cli
 ```bash
 agendex login                  # Authenticate via browser OAuth (agendex.dev)
 agendex login --url <url>      # Login to a self-hosted instance
+agendex open                   # Open the Agendex web app in your default browser
+agendex open --url <url>       # Open a self-hosted deployment
 agendex logout                 # Clear stored cloud token
 agendex configure              # Select which agents/adapters to index
 agendex start                  # Start daemon (backgrounds itself)
@@ -86,7 +88,7 @@ Before running `start`, `configure`, or `sync`, the CLI checks for a newer publi
 [agendex] run: npm i -g agendex-cli
 ```
 
-The check is skipped for `stop`, `status`, `login`, `logout`, `cleanup`, and `help`.
+The check is skipped for `stop`, `status`, `login`, `logout`, `open`, `cleanup`, and `help`.
 
 ## Supported Runtime
 
@@ -106,3 +108,9 @@ agendex login --url https://agendex.yourdomain.com
 This opens your deployment's OAuth flow and stores the returned `cloudToken` and `convexUrl` in your active config directory (`~/.agendex/config.json` for prod, `~/.agendex-dev/config.json` when using `--dev` or `AGENDEX_DEV=1`).
 
 The target can also be set via `AGENDEX_SITE_URL` env var. For local development against the default dev app URL, use `agendex login --dev` or set `AGENDEX_DEV=1` (see [Dev vs prod](#dev-vs-prod-config-directory) above).
+
+## Open the web app
+
+`agendex open` launches your default browser to the same base URL as the default login target (`https://app.agendex.dev` in prod, or the local EE dev URL when using `--dev` / `AGENDEX_DEV=1`). Override with `agendex open --url <url>` or `AGENDEX_SITE_URL`.
+
+If launching the browser is undesirable (for example in CI), set `AGENDEX_DISABLE_BROWSER=1`; the CLI still prints the URL to visit.

package/dist/cli.js

@@ -2948,18 +2948,21 @@ function getDefaultSiteUrl() {
     return process.env.AGENDEX_SITE_URL;
   return isDevMode() ? DEV_SITE_URL : PROD_SITE_URL;
 }
+function launchBrowser(url, label) {
+  console.log(`[agendex] Opening ${label}...`);
+  console.log(`[agendex] If it doesn't open, visit: ${url}`);
+  if (process.env.AGENDEX_DISABLE_BROWSER === "1") {
+    console.log("[agendex] Browser launch disabled by AGENDEX_DISABLE_BROWSER=1.");
+  } else {
+    openBrowser(url);
+  }
+}
 async function login(siteUrlOverride) {
   const { port, result } = await startCallbackServer();
   const callbackUrl = `http://127.0.0.1:${port}/callback`;
   const siteUrl = siteUrlOverride ?? getDefaultSiteUrl();
   const authUrl = `${siteUrl}/auth/cli?callback=${encodeURIComponent(callbackUrl)}`;
-  console.log(`[agendex] Opening browser for authentication...`);
-  console.log(`[agendex] If it doesn't open, visit: ${authUrl}`);
-  if (process.env.AGENDEX_DISABLE_BROWSER === "1") {
-    console.log("[agendex] Browser launch disabled by AGENDEX_DISABLE_BROWSER=1.");
-  } else {
-    openBrowser(authUrl);
-  }
+  launchBrowser(authUrl, "browser for authentication");
   const callback = await result;
   const existing = loadConfig();
   const config = {
@@ -3409,7 +3412,7 @@ import { join as join12 } from "node:path";
 // package.json
 var package_default = {
   name: "agendex-cli",
-  version: "0.9.1",
+  version: "0.10.1",
   description: "Agendex CLI for login, sync, and daemon workflows",
   homepage: "https://github.com/Tyru5/Agendex#readme",
   repository: {
@@ -3519,6 +3522,29 @@ function isNewer(latest, current) {
   return false;
 }
 
+// src/web.ts
+async function openAgendexWeb(siteUrlOverride) {
+  const base = siteUrlOverride ?? getDefaultSiteUrl();
+  const url = base.replace(/\/$/, "");
+  launchBrowser(url, "Agendex in your browser");
+}
+async function openSharedPlan(url) {
+  let parsed;
+  try {
+    parsed = new URL(url);
+  } catch {
+    console.error(`[agendex] invalid URL: ${url}`);
+    return false;
+  }
+  if (!parsed.pathname.includes("/shared/")) {
+    console.error(`[agendex] not a shared plan URL: ${url}`);
+    console.error("[agendex] expected format: https://app.agendex.dev/shared/<token>");
+    return false;
+  }
+  launchBrowser(url, "shared plan in your browser");
+  return true;
+}
+
 // src/cli.ts
 var args = process.argv.slice(2);
 var devFlag = args.includes("--dev");
@@ -3545,6 +3571,8 @@ async function main() {
     "status",
     "login",
     "logout",
+    "open",
+    "view",
     "cleanup",
     "help",
     "--help",
@@ -3559,6 +3587,22 @@ async function main() {
     }
   }
   switch (command) {
+    case "open": {
+      const urlIdx = args.indexOf("--url");
+      const siteUrl = urlIdx !== -1 ? args[urlIdx + 1] : undefined;
+      await openAgendexWeb(siteUrl);
+      return 0;
+    }
+    case "view": {
+      const url = args.find((a) => a !== "view" && a !== "--dev" && !a.startsWith("--"));
+      if (!url) {
+        writeStderr("[agendex] usage: agendex view <shared-plan-url>");
+        return 1;
+      }
+      if (!await openSharedPlan(url))
+        return 1;
+      return 0;
+    }
     case "start": {
       if (args.includes("--daemon")) {
         await startSupervisor();
@@ -3760,6 +3804,9 @@ Usage:
   agendex stop         Stop the running daemon
   agendex login        Authenticate via browser OAuth (agendex.dev)
   agendex login --url <url>  Login to a self-hosted instance
+  agendex open         Open the Agendex web app in your browser
+  agendex open --url <url>  Open a self-hosted instance
+  agendex view <url>   Open a shared plan URL in your browser
   agendex logout       Clear stored cloud token
   agendex configure    Select which agents/adapters to index
   agendex sync         One-shot scan + sync to cloud (skips unchanged plans)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agendex-cli",
-  "version": "0.9.1",
+  "version": "0.10.1",
   "description": "Agendex CLI for login, sync, and daemon workflows",
   "homepage": "https://github.com/Tyru5/Agendex#readme",
   "repository": {