agendex-cli 0.4.0 → 0.5.0

package/README.md

@@ -14,15 +14,39 @@ bun install -g agendex-cli
 ## Commands
 
 ```bash
-agendex login
-agendex login --url https://agendex.yourdomain.com
-agendex configure
-agendex start
-agendex stop
-agendex sync
-agendex status
-agendex logout
+agendex login                  # Authenticate via browser OAuth (agendex.dev)
+agendex login --url <url>      # Login to a self-hosted instance
+agendex logout                 # Clear stored cloud token
+agendex configure              # Select which agents/adapters to index
+agendex start                  # Start daemon (backgrounds itself)
+agendex stop                   # Stop the running daemon
+agendex sync                   # One-shot scan + sync to cloud
+agendex status                 # Show config state, daemon status, uptime & hostname
+agendex help                   # Show help message
+agendex --version / -v         # Print CLI version
+```
+
+## Status Output
+
+`agendex status` prints a rich overview:
+
+- Config version, local/cloud token state, Convex URL
+- Enabled adapters
+- Daemon running state with PID
+- **Uptime** — how long the daemon has been running
+- **Hostname** — machine the daemon is running on
+- CLI version
+
+## Auto-Update Check
+
+Before running `start`, `configure`, or `sync`, the CLI checks for a newer published version. If an update is required the command is blocked and you are prompted to upgrade:
+
 ```
+[agendex] update required: v0.1.0 → v0.2.0
+[agendex] run: npm i -g agendex-cli
+```
+
+The check is skipped for `stop`, `status`, `login`, `logout`, and `help`.
 
 ## Supported Runtime
 

package/dist/cli.js

@@ -2800,19 +2800,35 @@ function requestText(urlString, options) {
 
 // src/pid.ts
 import { existsSync as existsSync6, mkdirSync as mkdirSync2, readFileSync as readFileSync3, unlinkSync, writeFileSync as writeFileSync2 } from "node:fs";
-import { homedir as homedir9 } from "node:os";
+import { homedir as homedir9, hostname } from "node:os";
 import { dirname, join as join10 } from "node:path";
 var pidPath = join10(homedir9(), ".agendex", "daemon.pid");
 function writePid() {
   mkdirSync2(dirname(pidPath), { recursive: true });
-  writeFileSync2(pidPath, String(process.pid));
+  const info = {
+    pid: process.pid,
+    startedAtMs: Date.now(),
+    hostname: hostname()
+  };
+  writeFileSync2(pidPath, JSON.stringify(info));
 }
-function readPid() {
+function readPidInfo() {
   if (!existsSync6(pidPath))
     return null;
   const raw = readFileSync3(pidPath, "utf-8").trim();
-  const pid = Number(raw);
-  return Number.isFinite(pid) && pid > 0 ? pid : null;
+  const asNumber = Number(raw);
+  if (Number.isFinite(asNumber) && asNumber > 0 && !raw.startsWith("{")) {
+    return { pid: asNumber };
+  }
+  try {
+    const parsed = JSON.parse(raw);
+    if (Number.isFinite(parsed.pid) && parsed.pid > 0)
+      return parsed;
+  } catch {}
+  return null;
+}
+function readPid() {
+  return readPidInfo()?.pid ?? null;
 }
 function removePid() {
   try {
@@ -3013,7 +3029,7 @@ import { join as join11 } from "node:path";
 // package.json
 var package_default = {
   name: "agendex-cli",
-  version: "0.4.0",
+  version: "0.5.0",
   description: "Agendex CLI for login, sync, and daemon workflows",
   homepage: "https://github.com/Tyru5/Agendex#readme",
   repository: {
@@ -3119,6 +3135,10 @@ var command = args[0] ?? "start";
 var cliEntry = resolve5(process.argv[1] ?? fileURLToPath2(import.meta.url));
 async function main() {
   const isInternal = args.includes("--daemon") || args.includes("--worker");
+  if (command === "--version" || command === "-v") {
+    writeStdout(CLI_VERSION);
+    return 0;
+  }
   const isPassthrough = ["stop", "status", "login", "logout", "help", "--help", "-h"].includes(command);
   if (!isInternal && !isPassthrough) {
     const { updateAvailable, current, latest } = await checkForUpdate();
@@ -3196,7 +3216,8 @@ async function main() {
     }
     case "status": {
       const config = loadConfig();
-      const pid = readPid();
+      const pidInfo = readPidInfo();
+      const pid = pidInfo?.pid ?? null;
       const running = pid ? isRunning(pid) : false;
       writeStdout(`[agendex] Config version: ${config?.configVersion ?? "none"}`);
       writeStdout(`[agendex] Local token: ${config?.token ? "set" : "not set"}`);
@@ -3204,6 +3225,20 @@ async function main() {
       writeStdout(`[agendex] Convex URL: ${config?.convexUrl ?? "not set"}`);
       writeStdout(`[agendex] Enabled adapters: ${config?.enabledAdapters.join(", ") || "none"}`);
       writeStdout(`[agendex] Daemon: ${running ? `running (PID ${pid})` : "not running"}`);
+      if (running && pidInfo?.startedAtMs) {
+        writeStdout(`[agendex] Uptime: ${formatDuration(Date.now() - pidInfo.startedAtMs)}`);
+      } else if (running) {
+        writeStdout(`[agendex] Uptime: unknown (restart daemon to populate)`);
+      } else {
+        writeStdout(`[agendex] Uptime: n/a`);
+      }
+      if (running && pidInfo?.hostname) {
+        writeStdout(`[agendex] Hostname: ${pidInfo.hostname}`);
+      } else if (running) {
+        writeStdout(`[agendex] Hostname: unknown (restart daemon to populate)`);
+      } else {
+        writeStdout(`[agendex] Hostname: n/a`);
+      }
       writeStdout(`[agendex] CLI version: ${CLI_VERSION}`);
       return 0;
     }
@@ -3224,6 +3259,8 @@ Usage:
   agendex sync         One-shot scan + sync to cloud
   agendex status       Show current config state + daemon status
   agendex help         Show this help message
+  agendex --version    Print CLI version
+  agendex -v           Print CLI version
 `.trim());
       return 0;
     }
@@ -3264,3 +3301,17 @@ function writeStderr(message) {
   writeSync(process.stderr.fd, `${message}
 `);
 }
+function formatDuration(ms) {
+  const totalSeconds = Math.max(0, Math.floor(ms / 1000));
+  const days = Math.floor(totalSeconds / 86400);
+  const hours = Math.floor(totalSeconds % 86400 / 3600);
+  const minutes = Math.floor(totalSeconds % 3600 / 60);
+  const seconds = totalSeconds % 60;
+  if (days > 0)
+    return `${days}d ${hours}h ${minutes}m ${seconds}s`;
+  if (hours > 0)
+    return `${hours}h ${minutes}m ${seconds}s`;
+  if (minutes > 0)
+    return `${minutes}m ${seconds}s`;
+  return `${seconds}s`;
+}

package/package.json

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