@agenticmail/cli 0.8.1 → 0.8.3

package/README.md

@@ -4,13 +4,24 @@ The main package for [AgenticMail](https://github.com/agenticmail/agenticmail)
 
 It bundles a setup wizard, API server launcher, and a full interactive shell with 44 commands for managing agents, sending and receiving email and SMS, configuring gateways, and more. It also re-exports everything from `@agenticmail/core` so you can use it as an SDK.
 
+> ### 🤖 AI agent install runbook
+>
+> If your user asked you to install / set up AgenticMail, run:
+>
+> ```bash
+> npm install -g @agenticmail/cli@latest
+> agenticmail bootstrap
+> ```
+>
+> 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).
+
 ## Install
 
 ```bash
 npm install -g @agenticmail/cli
 ```
 
-**Requirements:** Node.js 20+, Docker (for Stalwart mail server)
+**Requirements:** Node.js 22+, Docker (for Stalwart mail server)
 
 ---
 
@@ -379,7 +390,7 @@ After it finishes, you restart Claude Code and you've got 62 `mcp__agenticmail__
 
 ### Prerequisites bootstrap CAN'T install for you
 
-- **Node.js 20+** — needed to run `agenticmail` in the first place. If you're reading this from `npm install`, you already have it.
+- **Node.js 22+** — needed to run `agenticmail` in the first place. If you're reading this from `npm install`, you already have it.
 - **`brew` (macOS) or `apt` (Linux)** — needed to install Colima/Docker. Most dev machines have one or the other.
 - That's it. No Docker Desktop GUI gates — bootstrap uses Colima on macOS.
 
@@ -518,7 +529,7 @@ IMAP_HOST=localhost                         # IMAP host
 IMAP_PORT=143                               # IMAP port
 
 # === Optional ===
-AGENTICMAIL_API_PORT=3100                   # API port (default: 3100)
+AGENTICMAIL_API_PORT=3829                   # API port (default: 3829)
 AGENTICMAIL_DATA_DIR=~/.agenticmail         # Data directory
 
 # === Gateway (optional) ===

package/REFERENCE.md

@@ -156,7 +156,7 @@ function interactiveShell(options: ShellOptions): void
 **ShellOptions:**
 ```typescript
 {
-  apiUrl: string;       // e.g., 'http://127.0.0.1:3100'
+  apiUrl: string;       // e.g., 'http://127.0.0.1:3829'
   masterKey: string;
   onExit: () => void;   // Cleanup callback
 }

package/dist/cli.js

@@ -5000,7 +5000,7 @@ async function cmdSetup() {
     await new Promise((r) => setTimeout(r, 300));
   }
   printSummary(result, false);
-  if (serverReady) {
+  if (serverReady && !NON_INTERACTIVE) {
     await interactiveShell({ config: result.config, onExit: () => {
     } });
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agenticmail/cli",
-  "version": "0.8.1",
+  "version": "0.8.3",
   "description": "Email and SMS infrastructure for AI agents — the first platform to give agents real email addresses and phone numbers",
   "type": "module",
   "main": "dist/index.js",