@agenticmail/cli 0.6.0 → 0.7.0

package/README.md

@@ -94,6 +94,7 @@ All commands are available via `agenticmail <command>` or `npx @agenticmail/cli@
 
 | Command | Description |
 |---------|-------------|
+| `agenticmail bootstrap` | ✨ **One-shot, zero-question install.** Designed to be runnable by an AI agent (Claude Code itself) on a user's behalf — no prompts, no decisions, no human in the loop. Provisions Stalwart, generates keys, starts the API as a launchd service, wires Claude Code in, starts the dispatcher daemon. External email relay and SMS are SKIPPED (run `agenticmail setup` interactively later to add them). See [Autonomous install](#autonomous-install) below. |
 | `agenticmail openclaw` | **Set up AgenticMail for OpenClaw.** Starts infrastructure, creates an agent, configures the plugin, enables agent auto-spawn via hooks, and restarts the OpenClaw gateway. |
 | `agenticmail claudecode` | **Set up AgenticMail for Claude Code.** ✨ NEW — wires AgenticMail into Claude Code so every agent (Fola, John, …) becomes a callable subagent via the `Agent` tool, AND wakes automatically on incoming mail or tasks. No separate Anthropic key needed — workers ride on your existing Claude OAuth. See the [Claude Code Integration](#claude-code-integration) section below. |
 
@@ -353,6 +354,51 @@ The `call_agent` tool intelligently spawns sub-agents with:
 
 ---
 
+## Autonomous install
+
+> ✨ **New in 0.7** — `agenticmail bootstrap` lets an AI agent (e.g. Claude Code itself) install AgenticMail from scratch on a user's behalf, with **zero human-in-the-loop prompts**. Designed for the workflow: "User says to Claude Code: install AgenticMail. Claude Code does it. Done."
+
+```bash
+npm install -g @agenticmail/cli
+agenticmail bootstrap
+```
+
+That's the whole flow. The pipeline:
+
+1. `agenticmail setup --yes` — auto-installs Colima/Docker via brew or apt, starts Stalwart, generates a master key, creates a default agent. **Skips email relay and SMS setup** (those need user-owned credentials and aren't required for local multi-agent coordination).
+2. `agenticmail service install` — registers the launchd plist (or equivalent) so the API auto-starts on boot, and starts it now.
+3. Waits up to 60 s for the API to answer `/health`.
+4. `agenticmail claudecode` — provisions the Claude Code bridge agent, writes `~/.claude.json` + `~/.claude/agents/agenticmail-*.md`, starts the dispatcher daemon under PM2.
+
+After it finishes, you restart Claude Code and you've got 62 `mcp__agenticmail__*` tools plus one Claude Code subagent per AgenticMail agent.
+
+### What it does NOT set up
+
+- **External email relay.** No outbound mail to the public internet. Agents email each other on `@localhost` through Stalwart, which is what the Claude Code integration needs. Run `agenticmail setup` interactively later to add a Gmail relay or a custom domain.
+- **SMS / phone numbers.** Same reason — requires Google Voice credentials.
+
+### 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.
+- **`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.
+
+### Real example — what to tell Claude Code
+
+```
+User: "Install AgenticMail on this machine and wire it into Claude Code."
+Claude Code: [runs Bash]
+  npm install -g @agenticmail/cli@latest pm2
+  agenticmail bootstrap
+[~2 minutes later]
+Claude Code: "Done. Restart me and you'll have AgenticMail's full toolbelt
+plus every agent as a callable subagent."
+```
+
+Zero questions, zero clicks, zero decisions for the user.
+
+---
+
 ## Claude Code Integration
 
 > ✨ **New in 0.6** — `@agenticmail/claudecode` brings the full AgenticMail multi-agent platform inside [Claude Code](https://claude.com/claude-code). Every AgenticMail agent becomes a callable Claude Code subagent, and agents auto-wake on incoming mail or tasks. **No separate Anthropic API key required — workers reuse your existing Claude OAuth.**

package/dist/cli.js

@@ -4547,7 +4547,34 @@ function stopApiServer() {
     return false;
   }
 }
+var NON_INTERACTIVE = false;
+function nonInteractiveDefault(value) {
+  return NON_INTERACTIVE ? value : null;
+}
 async function cmdSetup() {
+  const setupArgs = process.argv.slice(3);
+  if (setupArgs.some((a) => a === "--help" || a === "-h" || a === "help")) {
+    log2("");
+    log2(`  ${c2.pinkBg(" \u{1F380} agenticmail setup ")}`);
+    log2("");
+    log2(`  ${c2.bold("Usage:")} agenticmail setup [flags]`);
+    log2("");
+    log2(`  ${c2.bold("Flags:")}`);
+    log2(`    ${c2.green("-y, --yes, --non-interactive")}`);
+    log2(`        Skip every prompt and use safe defaults. Provisions Stalwart +`);
+    log2(`        master key + a default "secretary" agent; SKIPS external email`);
+    log2(`        and SMS setup. Run \`agenticmail setup\` interactively later to`);
+    log2(`        add a Gmail relay or your own domain.`);
+    log2(`    ${c2.green("-h, --help")}`);
+    log2(`        Show this help and exit.`);
+    log2("");
+    return;
+  }
+  if (setupArgs.some((a) => a === "--yes" || a === "-y" || a === "--non-interactive")) {
+    NON_INTERACTIVE = true;
+    log2("");
+    log2(`  ${c2.dim("[non-interactive mode \u2014 using safe defaults for every prompt]")}`);
+  }
   log2("");
   log2(`   ${c2.bold("\u{1F380} AgenticMail Setup")} `);
   log2("");
@@ -4563,47 +4590,49 @@ async function cmdSetup() {
   log2(`    ${c2.dim("4.")} Connect your email`);
   if (hasOpenClaw) log2(`    ${c2.dim("5.")} Configure OpenClaw integration`);
   log2("");
-  await pick(`  ${c2.magenta("Press any key to get started...")} `, [
-    "1",
-    "2",
-    "3",
-    "4",
-    "5",
-    "6",
-    "7",
-    "8",
-    "9",
-    "0",
-    "a",
-    "b",
-    "c",
-    "d",
-    "e",
-    "f",
-    "g",
-    "h",
-    "i",
-    "j",
-    "k",
-    "l",
-    "m",
-    "n",
-    "o",
-    "p",
-    "q",
-    "r",
-    "s",
-    "t",
-    "u",
-    "v",
-    "w",
-    "x",
-    "y",
-    "z",
-    " ",
-    "\r",
-    "\n"
-  ]);
+  if (!NON_INTERACTIVE) {
+    await pick(`  ${c2.magenta("Press any key to get started...")} `, [
+      "1",
+      "2",
+      "3",
+      "4",
+      "5",
+      "6",
+      "7",
+      "8",
+      "9",
+      "0",
+      "a",
+      "b",
+      "c",
+      "d",
+      "e",
+      "f",
+      "g",
+      "h",
+      "i",
+      "j",
+      "k",
+      "l",
+      "m",
+      "n",
+      "o",
+      "p",
+      "q",
+      "r",
+      "s",
+      "t",
+      "u",
+      "v",
+      "w",
+      "x",
+      "y",
+      "z",
+      " ",
+      "\r",
+      "\n"
+    ]);
+  }
   log2("");
   const setup = new SetupManager();
   log2(`  ${c2.bold(`Step 1 of ${totalSteps}`)} ${c2.dim("\u2014")} ${c2.bold("Checking your system")}`);
@@ -4774,7 +4803,7 @@ async function cmdSetup() {
     log2(`  ${c2.cyan("2.")} Remove and connect a different email`);
     log2(`  ${c2.cyan("3.")} Set up a custom domain instead`);
     log2("");
-    const existChoice = await pick(`  ${c2.magenta(">")} `, ["1", "2", "3"]);
+    const existChoice = nonInteractiveDefault("1") ?? await pick(`  ${c2.magenta(">")} `, ["1", "2", "3"]);
     if (existChoice === "1") {
       choice = "3";
       log2("");
@@ -4798,7 +4827,7 @@ async function cmdSetup() {
     log2(`  ${c2.cyan("3.")} Skip for now`);
     log2(`     ${c2.dim("You can always set this up later.")}`);
     log2("");
-    choice = await pick(`  ${c2.magenta(">")} `, ["1", "2", "3"]);
+    choice = nonInteractiveDefault("3") ?? await pick(`  ${c2.magenta(">")} `, ["1", "2", "3"]);
   }
   log2("");
   if (choice === "1" || choice === "2") {
@@ -4846,7 +4875,7 @@ async function cmdSetup() {
     log2(`  ${c2.dim("Give your AI agent a phone number via Google Voice.")}`);
     log2(`  ${c2.dim("This lets agents receive verification codes and send texts.")}`);
     log2("");
-    const wantSms = await ask(`  ${c2.bold("Set up phone number access?")} ${c2.dim("(y/N)")} `);
+    const wantSms = nonInteractiveDefault("N") ?? await ask(`  ${c2.bold("Set up phone number access?")} ${c2.dim("(y/N)")} `);
     if (wantSms.toLowerCase().startsWith("y")) {
       log2("");
       log2(`  ${c2.bold("What this does:")}`);
@@ -5591,6 +5620,101 @@ function mergePluginConfig(existing, apiUrl, masterKey, agentApiKey, pluginDir)
   }
   return result;
 }
+async function cmdBootstrap() {
+  const sub = process.argv.slice(3);
+  if (sub.includes("--help") || sub.includes("-h")) {
+    log2("");
+    log2(`  ${c2.pinkBg(" \u{1F380} agenticmail bootstrap ")}`);
+    log2("");
+    log2(`  ${c2.bold("Usage:")} agenticmail bootstrap`);
+    log2("");
+    log2("  One-shot, zero-question install. Designed for AI agents (like Claude");
+    log2("  Code) to run on a user's behalf without any prompts.");
+    log2("");
+    log2("  Pipeline:");
+    log2(`    ${c2.dim("1.")} agenticmail setup --yes        ${c2.dim("(skips email/SMS; local-only)")}`);
+    log2(`    ${c2.dim("2.")} agenticmail service install    ${c2.dim("(auto-start the API)")}`);
+    log2(`    ${c2.dim("3.")} wait for API on http://127.0.0.1:3200/api/agenticmail/health`);
+    log2(`    ${c2.dim("4.")} agenticmail claudecode         ${c2.dim("(wire Claude Code integration)")}`);
+    log2("");
+    log2(`  ${c2.bold("Notes:")}`);
+    log2("    - Docker (or Colima on macOS) will be auto-installed via brew/apt");
+    log2("      if missing. No GUI gates \u2014 uses Colima on macOS, not Docker Desktop.");
+    log2("    - External email relay and SMS setup are SKIPPED. The local");
+    log2("      multi-agent flow works without them. Run `agenticmail setup`");
+    log2("      interactively later if you want outbound mail to the real internet.");
+    log2("");
+    return;
+  }
+  log2("");
+  log2(`  ${c2.pinkBg(" \u{1F380} AgenticMail bootstrap \u2014 fully autonomous install ")}`);
+  log2("");
+  log2(`  ${c2.dim("No prompts. No human in the loop. Everything is auto-configured.")}`);
+  log2("");
+  log2(`  ${c2.bold("Phase 1 of 4")} ${c2.dim("\u2014")} ${c2.bold("Provisioning infrastructure (Stalwart + master key)")}`);
+  log2("");
+  const savedArgv = process.argv.slice();
+  process.argv = [savedArgv[0], savedArgv[1], "setup", "--yes"];
+  try {
+    await cmdSetup();
+  } finally {
+    process.argv = savedArgv;
+  }
+  log2("");
+  log2(`  ${c2.bold("Phase 2 of 4")} ${c2.dim("\u2014")} ${c2.bold("Installing the auto-start service")}`);
+  log2("");
+  const savedArgvSvc = process.argv.slice();
+  process.argv = [savedArgvSvc[0], savedArgvSvc[1], "service", "install"];
+  try {
+    await cmdService();
+  } finally {
+    process.argv = savedArgvSvc;
+  }
+  log2("");
+  log2(`  ${c2.bold("Phase 3 of 4")} ${c2.dim("\u2014")} ${c2.bold("Waiting for the API to come online")}`);
+  log2("");
+  const apiHealthOk = await waitForApiHealth(6e4);
+  if (!apiHealthOk) {
+    fail2(`API did not respond on http://127.0.0.1:3200/api/agenticmail/health within 60 s`);
+    info2("Check the logs: tail -f ~/.agenticmail/logs/server.log");
+    process.exit(1);
+  }
+  ok2("API server is online and healthy");
+  log2("");
+  log2(`  ${c2.bold("Phase 4 of 4")} ${c2.dim("\u2014")} ${c2.bold("Wiring Claude Code integration")}`);
+  log2("");
+  const savedArgvCc = process.argv.slice();
+  process.argv = [savedArgvCc[0], savedArgvCc[1], "claudecode"];
+  try {
+    await cmdClaudeCode();
+  } finally {
+    process.argv = savedArgvCc;
+  }
+  log2("");
+  log2(`  ${c2.pinkBg(" \u2705 Bootstrap complete ")}`);
+  log2("");
+  log2(`  ${c2.bold("Restart Claude Code")} and you'll have:`);
+  log2(`    - 62 ${c2.cyan("mcp__agenticmail__*")} tools in every session`);
+  log2(`    - The ${c2.cyan("Agent")} tool surfaces each AgenticMail agent as a subagent`);
+  log2(`    - Send mail to ${c2.cyan("<agent>@localhost")} or call_agent \u2192 dispatcher auto-wakes them`);
+  log2("");
+  log2(`  ${c2.dim("To add an external email relay later:")} ${c2.green("agenticmail setup")}`);
+  log2("");
+}
+async function waitForApiHealth(timeoutMs) {
+  const deadline = Date.now() + timeoutMs;
+  while (Date.now() < deadline) {
+    try {
+      const res = await fetch("http://127.0.0.1:3200/api/agenticmail/health", {
+        signal: AbortSignal.timeout(3e3)
+      });
+      if (res.ok) return true;
+    } catch {
+    }
+    await new Promise((r) => setTimeout(r, 1e3));
+  }
+  return false;
+}
 async function cmdClaudeCode() {
   const sub = process.argv.slice(3);
   if (sub.includes("--help") || sub.includes("-h") || sub.includes("help")) {
@@ -6021,7 +6145,7 @@ async function cmdOpenClaw() {
     }
   }
   if (!smsAlreadyConfigured) {
-    const wantSms = await ask(`  ${c2.bold("Set up phone number access?")} ${c2.dim("(y/N)")} `);
+    const wantSms = nonInteractiveDefault("N") ?? await ask(`  ${c2.bold("Set up phone number access?")} ${c2.dim("(y/N)")} `);
     if (wantSms.toLowerCase().startsWith("y")) {
       log2("");
       const hasVoice = await ask(`  ${c2.bold("Do you already have a Google Voice number?")} ${c2.dim("(y/N)")} `);
@@ -6851,6 +6975,13 @@ switch (command) {
       process.exit(1);
     });
     break;
+  case "bootstrap":
+  case "quickstart":
+    cmdBootstrap().catch((err) => {
+      console.error(err);
+      process.exit(1);
+    });
+    break;
   case "service":
     cmdService().then(() => {
       process.exit(0);
@@ -6888,7 +7019,8 @@ switch (command) {
     log2("");
     log2("  Commands:");
     log2(`    ${c2.green("agenticmail")}           Get started (setup + start)`);
-    log2(`    ${c2.green("agenticmail setup")}     Re-run the setup wizard`);
+    log2(`    ${c2.green("agenticmail bootstrap")} ${c2.dim("Zero-question install \u2014 for AI agents (Claude Code) to run on a user's behalf")}`);
+    log2(`    ${c2.green("agenticmail setup")}     Re-run the setup wizard ${c2.dim("(use --yes for non-interactive)")}`);
     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`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agenticmail/cli",
-  "version": "0.6.0",
+  "version": "0.7.0",
   "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",