@agenticmail/cli 0.8.18 → 0.8.21

package/README.md

@@ -23,6 +23,19 @@ It bundles a setup wizard, API server launcher, and a full interactive shell wit
 >
 > Zero prompts, ~2 minutes, fully autonomous. Then tell the user to restart Claude Code. Full agent-facing runbook — including verification, common failures, and "what if Node < 22" — is at [`AGENTS.md`](https://github.com/agenticmail/agenticmail/blob/main/AGENTS.md) in the repo (the [agents.md](https://agents.md) convention).
 
+## ✨ What's new in 0.8.19
+
+- **🌐 Gmail-style web UI** — open every agent's inbox in your browser with `agenticmail web`. Three-pane layout, full markdown rendering, real-time SSE updates, compose + reply with the new `wake` parameter as a first-class field.
+- **`wake: ["alice", "bob"]`** on `send_email` / `reply_email` / `forward_email` / `template_send` / `manage_drafts(send)` tells the dispatcher to give a Claude turn only to named agents — the biggest token saver on large threads.
+- **`[FINAL]` / `[DONE]` / `[CLOSED]` / `[WRAP]` in a subject** closes a thread — the dispatcher stops waking workers on any further reply to it.
+- **`check_activity` MCP tool** — see which agents the dispatcher has woken right now and how long they've been running.
+- **Comprehensive markdown rendering** in the shell's email viewer — bold, italic, headings, lists, task lists, tables, fenced code, links, images, HTML entities, depth-colored quote stripes.
+- **LLM-tolerant inputs** — `batch_mark_read({ uids: "[1,2,3]" })` and other common stringification mistakes now just work.
+- **Wake-budget circuit breaker** — caps per-(agent, thread) wakes at 10/24h to stop reply loops and storms.
+- **Inbox refresh keybind** — press `r` in the shell inbox navigator to refresh without leaving.
+
+Full release notes in [CHANGELOG.md](https://github.com/agenticmail/agenticmail/blob/main/CHANGELOG.md).
+
 ## Install
 
 ```bash
@@ -107,6 +120,7 @@ All commands are available via `agenticmail <command>` or `npx @agenticmail/cli@
 | `agenticmail setup` | **Run the setup wizard.** Walks you through system checks, account creation, service startup, email connection, phone number setup, and OpenClaw integration. Safe to re-run anytime. |
 | `agenticmail start` | **Start the server and open the interactive shell.** Ensures Docker is running, Stalwart is up, and the API server is reachable. Automatically installs the auto-start service. |
 | `agenticmail shell` | **Drop into the interactive shell against the already-running server.** Use this when the server is already up (started by `agenticmail start`, `agenticmail bootstrap`, or the auto-start service) and you want to monitor every agent's inbox, send mail on their behalf, watch the dispatcher event feed, or run any of the 44+ shell commands. Exits cleanly with `/exit` — the server keeps running. |
+| `agenticmail web` | 🌐 **Open the lightweight Gmail-style web UI in your browser.** Three-pane layout (agents / inbox / message), real-time SSE updates, full markdown rendering, compose + reply with the `wake` parameter surfaced as a field. Same master key as the API. Available at `http://127.0.0.1:3829/` whenever the API is running. |
 | `agenticmail stop` | **Stop the server.** Kills the background API server process. If auto-start is enabled, it will restart on next boot. |
 | `agenticmail status` | **Show what's running.** Displays Docker, Stalwart, API server, email connection, and auto-start service status. |
 
@@ -523,7 +537,7 @@ import {
   type ParsedEmail,
   type Agent,
   type GatewayConfig,
-} from 'agenticmail';
+} from '@agenticmail/cli';
 ```
 
 See the [@agenticmail/core README](https://github.com/agenticmail/agenticmail/tree/main/packages/core) for complete SDK documentation.
@@ -610,12 +624,14 @@ Errors return JSON: `400` (missing `name`/`columns`), `409` (table already exist
 
 ### `agenticmail: command not found`
 
-If you installed locally with `npm install agenticmail`, use `npx agenticmail` instead. For a global install:
+If you installed locally with `npm install @agenticmail/cli`, use `npx agenticmail` instead. For a global install:
 
 ```bash
 npm install -g @agenticmail/cli
 ```
 
+> Note: the unscoped `agenticmail` package on npm is a zero-dependency redirect stub (since v0.8.20). The real CLI is `@agenticmail/cli`. If you accidentally installed `agenticmail` without the scope, run `npm uninstall -g agenticmail` and then `npm install -g @agenticmail/cli@latest`.
+
 ---
 
 ## License

package/dist/cli.js

@@ -4224,7 +4224,7 @@ ${c.dim(boxChar.bl + boxChar.h.repeat(bWidth) + boxChar.br)}`);
         info(`Current version: ${c.bold(currentVersion)}`);
         let latestVersion = "unknown";
         try {
-          latestVersion = execSync("npm view agenticmail version", { encoding: "utf-8", timeout: 15e3 }).trim();
+          latestVersion = execSync("npm view @agenticmail/cli version", { encoding: "utf-8", timeout: 15e3 }).trim();
         } catch {
           fail("Could not check npm for latest version. Check your internet connection.");
           return;
@@ -4247,7 +4247,7 @@ ${c.dim(boxChar.bl + boxChar.h.repeat(bWidth) + boxChar.br)}`);
         if (hasOpenClaw) {
           info(`OpenClaw detected: ${c.bold(openClawVersion)}`);
           try {
-            const peerDeps = execSync(`npm view agenticmail@${latestVersion} peerDependencies --json 2>/dev/null`, { encoding: "utf-8", timeout: 15e3 }).trim();
+            const peerDeps = execSync(`npm view @agenticmail/cli@${latestVersion} peerDependencies --json 2>/dev/null`, { encoding: "utf-8", timeout: 15e3 }).trim();
             if (peerDeps) {
               const deps = JSON.parse(peerDeps);
               if (deps.openclaw) {
@@ -4283,12 +4283,19 @@ ${c.dim(boxChar.bl + boxChar.h.repeat(bWidth) + boxChar.br)}`);
           }
           let isGlobal = false;
           try {
-            const globalList = execSync(`${pm === "npm" ? "npm" : pm} list -g agenticmail 2>/dev/null`, { encoding: "utf-8", timeout: 1e4 });
-            if (globalList.includes("agenticmail")) isGlobal = true;
+            const globalList = execSync(`${pm} list -g @agenticmail/cli 2>/dev/null`, { encoding: "utf-8", timeout: 1e4 });
+            if (globalList.includes("@agenticmail/cli")) isGlobal = true;
           } catch {
           }
+          if (!isGlobal) {
+            try {
+              const globalList = execSync(`${pm} list -g agenticmail 2>/dev/null`, { encoding: "utf-8", timeout: 1e4 });
+              if (globalList.includes("agenticmail")) isGlobal = true;
+            } catch {
+            }
+          }
           const scope = isGlobal ? "-g" : "";
-          const installCmd = pm === "bun" ? `bun add ${scope} agenticmail@latest` : `${pm} install ${scope} agenticmail@latest`;
+          const installCmd = pm === "bun" ? `bun add ${scope} @agenticmail/cli@latest` : `${pm} install ${scope} @agenticmail/cli@latest`;
           info(`Running: ${c.dim(installCmd)}`);
           execSync(installCmd, { stdio: "inherit", timeout: 12e4 });
           if (hasOpenClaw) {
@@ -4309,12 +4316,12 @@ ${c.dim(boxChar.bl + boxChar.h.repeat(bWidth) + boxChar.br)}`);
             }
           }
           log("");
-          ok(`Updated to agenticmail@${latestVersion}`);
+          ok(`Updated to @agenticmail/cli@${latestVersion}`);
           info("Restart the shell to use the new version.");
           log("");
         } catch (err) {
           fail(`Update failed: ${err.message}`);
-          info(`Try manually: ${c.green("npm install -g agenticmail@latest")}`);
+          info(`Try manually: ${c.green("npm install -g @agenticmail/cli@latest")}`);
           log("");
         }
       }
@@ -6922,6 +6929,61 @@ async function isTunnelConfigured() {
     return false;
   }
 }
+async function cmdWeb() {
+  log2("");
+  log2(`  ${c2.pinkBg(" \u{1F380} AgenticMail web UI ")}`);
+  log2("");
+  const configPath = join(homedir(), ".agenticmail", "config.json");
+  if (!existsSync2(configPath)) {
+    log2(`  ${c2.red("\u2717")} AgenticMail isn't set up yet. Run ${c2.green("agenticmail setup")} first.`);
+    log2("");
+    return;
+  }
+  const { apiUrl } = readApiUrlFromConfig();
+  let masterKey = "";
+  try {
+    const cfg = JSON.parse(readFileSync2(configPath, "utf-8"));
+    if (typeof cfg?.masterKey === "string") masterKey = cfg.masterKey;
+  } catch {
+  }
+  const url = masterKey ? `${apiUrl}/?key=${encodeURIComponent(masterKey)}` : apiUrl;
+  let alive = false;
+  try {
+    const resp = await fetch(`${url}/api/agenticmail/health`, { signal: AbortSignal.timeout(2e3) });
+    alive = resp.ok;
+  } catch {
+  }
+  if (!alive) {
+    log2(`  ${c2.red("\u2717")} API server not reachable at ${c2.cyan(url)}.`);
+    log2(`    Start it with ${c2.green("agenticmail start")} (in another terminal) or ${c2.green("agenticmail service install")}.`);
+    log2("");
+    return;
+  }
+  log2(`  ${c2.green("\u2713")} API server is running at ${c2.cyan(apiUrl)}`);
+  log2("");
+  if (masterKey) {
+    log2(`  ${c2.bold("Opening the web UI \u2014 you'll be signed in automatically.")}`);
+    log2("");
+    log2(`    ${c2.dim(apiUrl)}`);
+  } else {
+    log2(`  ${c2.yellow("!")} ${c2.bold("Master key not found in config; you'll need to paste it manually.")}`);
+    log2("");
+    log2(`    ${c2.green(apiUrl)}`);
+    log2("");
+    log2(`  ${c2.dim("When prompted:")}`);
+    log2(`    ${c2.dim("cat ~/.agenticmail/config.json | grep masterKey")}`);
+  }
+  log2("");
+  const platform = process.platform;
+  const opener = platform === "darwin" ? "open" : platform === "win32" ? "start" : "xdg-open";
+  try {
+    const { spawn } = await import("child_process");
+    spawn(opener, [url], { stdio: "ignore", detached: true }).unref();
+    log2(`  ${c2.dim(`Opening ${url} in your default browser\u2026`)}`);
+    log2("");
+  } catch {
+  }
+}
 async function cmdStatus() {
   log2("");
   log2(`  ${c2.pinkBg(" \u{1F380} AgenticMail Status ")}`);
@@ -7238,7 +7300,7 @@ async function cmdUpdate() {
   info2(`Current version: ${c2.bold(currentVersion)}`);
   let latestVersion = "unknown";
   try {
-    latestVersion = execSync("npm view agenticmail version", { encoding: "utf-8", timeout: 15e3 }).trim();
+    latestVersion = execSync("npm view @agenticmail/cli version", { encoding: "utf-8", timeout: 15e3 }).trim();
   } catch {
     fail2("Could not check npm. Check your internet connection.");
     process.exit(1);
@@ -7272,19 +7334,26 @@ async function cmdUpdate() {
   }
   let isGlobal = false;
   try {
-    const list = execSync(`npm list -g agenticmail 2>/dev/null`, { encoding: "utf-8", timeout: 1e4 });
-    if (list.includes("agenticmail@")) isGlobal = true;
+    const list = execSync(`npm list -g @agenticmail/cli 2>/dev/null`, { encoding: "utf-8", timeout: 1e4 });
+    if (list.includes("@agenticmail/cli@")) isGlobal = true;
   } catch {
   }
+  if (!isGlobal) {
+    try {
+      const list = execSync(`npm list -g agenticmail 2>/dev/null`, { encoding: "utf-8", timeout: 1e4 });
+      if (list.includes("agenticmail@")) isGlobal = true;
+    } catch {
+    }
+  }
   const scope = isGlobal ? "-g" : "";
-  const installCmd = pm === "bun" ? `bun add ${scope} agenticmail@latest`.trim() : `${pm} install ${scope} agenticmail@latest`.trim();
+  const installCmd = pm === "bun" ? `bun add ${scope} @agenticmail/cli@latest`.trim() : `${pm} install ${scope} @agenticmail/cli@latest`.trim();
   info2(`Running: ${c2.dim(installCmd)}`);
   try {
     execSync(installCmd, { stdio: "inherit", timeout: 12e4 });
-    ok2(`Updated to agenticmail@${latestVersion}`);
+    ok2(`Updated to @agenticmail/cli@${latestVersion}`);
   } catch (err) {
     fail2(`Update failed: ${err.message}`);
-    info2(`Try: ${c2.green("npm install -g agenticmail@latest")}`);
+    info2(`Try: ${c2.green("npm install -g @agenticmail/cli@latest")}`);
     process.exit(1);
   }
   if (hasOpenClaw) {
@@ -7372,6 +7441,15 @@ switch (command) {
       process.exit(1);
     });
     break;
+  case "web":
+  case "ui":
+    cmdWeb().then(() => {
+      process.exit(0);
+    }).catch((err) => {
+      console.error(err);
+      process.exit(1);
+    });
+    break;
   case "--version":
   case "-v":
   case "version": {
@@ -7400,6 +7478,8 @@ switch (command) {
     log2(`    ${c2.green("agenticmail start")}     Start the server`);
     log2(`    ${c2.green("agenticmail stop")}      Stop the server`);
     log2(`    ${c2.green("agenticmail status")}    See what's running`);
+    log2(`    ${c2.green("agenticmail shell")}     Drop into the interactive REPL (44 commands)`);
+    log2(`    ${c2.green("agenticmail web")}       Open the Gmail-style web UI in your browser`);
     log2(`    ${c2.green("agenticmail openclaw")}  Set up AgenticMail for OpenClaw`);
     log2(`    ${c2.green("agenticmail claudecode")} Set up AgenticMail for Claude Code`);
     log2(`    ${c2.green("agenticmail service")}   Manage auto-start (install/uninstall/status)`);