agendex-cli 0.9.0 → 0.10.0

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

@@ -2398,7 +2398,7 @@ async function loadOrInitConfig(options = {}) {
 }
 // ../shared/src/daemon-status.ts
 var CLI_DAEMON_HEARTBEAT_INTERVAL_MS = 30000;
-var CLI_DAEMON_STALE_AFTER_MS = CLI_DAEMON_HEARTBEAT_INTERVAL_MS * 3;
+var CLI_DAEMON_STALE_AFTER_MS = CLI_DAEMON_HEARTBEAT_INTERVAL_MS * 5;
 // ../shared/src/services/plan-service.ts
 import { existsSync as existsSync4, readdirSync as readdirSync3, statSync } from "node:fs";
 import { lstat, mkdir, readdir as readdir2, readFile as readFile6, stat as stat6, writeFile as writeFile3 } from "node:fs/promises";
@@ -2817,6 +2817,13 @@ async function sendHeartbeat() {
     }
   } catch {}
 }
+async function sendShutdown() {
+  try {
+    const { token, convexUrl } = getCloudConfig();
+    cachedDeviceId ??= loadOrCreateDeviceId();
+    await deleteDaemons([cachedDeviceId]);
+  } catch {}
+}
 async function refreshToken(currentToken, convexUrl) {
   const res = await requestText(`${convexUrl}/api/cli/refresh`, {
     method: "POST",
@@ -3201,7 +3208,7 @@ async function runWorker() {
   const adapters = resolveAdapters(config.enabledAdapters);
   setActiveAdapters(adapters);
   console.log(`[agendex] daemon starting with ${config.enabledAdapters.length} adapters`);
-  sendHeartbeat();
+  await sendHeartbeat();
   const syncCache = loadSyncCache();
   const syncQueue = [];
   let syncing = false;
@@ -3289,6 +3296,12 @@ async function runWorker() {
     processSyncQueue();
   });
   console.log(`[agendex] daemon running. Watching for file changes...`);
+  async function gracefulShutdown() {
+    await sendShutdown();
+    process.exit(0);
+  }
+  process.on("SIGTERM", () => void gracefulShutdown());
+  process.on("SIGINT", () => void gracefulShutdown());
   await new Promise(() => {});
 }
 async function startSupervisor() {
@@ -3396,7 +3409,7 @@ import { join as join12 } from "node:path";
 // package.json
 var package_default = {
   name: "agendex-cli",
-  version: "0.9.0",
+  version: "0.10.0",
   description: "Agendex CLI for login, sync, and daemon workflows",
   homepage: "https://github.com/Tyru5/Agendex#readme",
   repository: {
@@ -3506,6 +3519,19 @@ function isNewer(latest, current) {
   return false;
 }
 
+// src/web.ts
+async function openAgendexWeb(siteUrlOverride) {
+  const base = siteUrlOverride ?? getDefaultSiteUrl();
+  const url = base.replace(/\/$/, "");
+  console.log("[agendex] Opening Agendex in your browser...");
+  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);
+  }
+}
+
 // src/cli.ts
 var args = process.argv.slice(2);
 var devFlag = args.includes("--dev");
@@ -3532,6 +3558,7 @@ async function main() {
     "status",
     "login",
     "logout",
+    "open",
     "cleanup",
     "help",
     "--help",
@@ -3546,6 +3573,12 @@ 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 "start": {
       if (args.includes("--daemon")) {
         await startSupervisor();
@@ -3592,6 +3625,7 @@ async function main() {
         writeStderr("[agendex] daemon did not stop in time");
       } else {
         removePid();
+        await sendShutdown();
         writeStdout(`[agendex] daemon stopped (PID ${pid})`);
       }
       return isRunning(pid) ? 1 : 0;
@@ -3713,6 +3747,7 @@ async function main() {
           const allDevices = await fetchDevices();
           if (allDevices.length > 0) {
             const now = Date.now();
+            const localDeviceId = config.deviceId;
             writeStdout(`[agendex] All daemons:`);
             for (const device of allDevices) {
               const age = device.lastSeenAt ? now - device.lastSeenAt : Number.POSITIVE_INFINITY;
@@ -3720,7 +3755,8 @@ async function main() {
               const uptimeStr = device.startedAtMs != null ? formatDuration(now - device.startedAtMs) : "~";
               const pidStr = device.pid != null ? String(device.pid) : "~";
               const hostnameStr = device.hostname ?? "~";
-              writeStdout(`- hostname: ${hostnameStr}
+              const isLocal = localDeviceId && device.deviceId === localDeviceId;
+              writeStdout(`- hostname: ${hostnameStr}${isLocal ? " (this machine)" : ""}
   pid: ${pidStr}
   uptime: ${uptimeStr}
   status: ${status}`);
@@ -3744,6 +3780,8 @@ 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 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.0",
+  "version": "0.10.0",
   "description": "Agendex CLI for login, sync, and daemon workflows",
   "homepage": "https://github.com/Tyru5/Agendex#readme",
   "repository": {