@agenticmail/cli 0.5.62 → 0.7.0

package/README.md

@@ -94,7 +94,9 @@ 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. |
 
 ### Service Management (Auto-Start on Boot)
 
@@ -352,6 +354,118 @@ 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.**
+
+```bash
+agenticmail claudecode             # install
+agenticmail claudecode --status    # check
+agenticmail claudecode --remove    # uninstall
+```
+
+### What it gives you
+
+- **Every AgenticMail agent is callable from Claude Code via the native `Agent` tool.**
+  Inside any Claude Code session: `Agent { subagent_type: "agenticmail-fola", prompt: "..." }` — the subagent IS Fola, reads Fola's real inbox, sends mail from `fola@localhost`.
+
+- **All 62 AgenticMail MCP tools available in Claude Code.**
+  `mcp__agenticmail__send_email`, `call_agent`, `list_inbox`, `sms_send`, … — works in any Claude Code session, no further setup.
+
+- **Auto-wake on inbox / task events.**
+  Send an email to `fola@localhost`, post a `/tasks/rpc` for Fola, or `CC` her on a thread — a background dispatcher daemon (managed by PM2) spawns a Claude-powered worker to handle it. The worker submits results / replies; threads keep flowing.
+
+- **Multi-agent coordination on email threads.**
+  Because every cross-agent reply lands in the recipient's inbox and wakes them, fan-out (CC three teammates) and reply chains "just work." No new infrastructure to learn — it's email.
+
+- **Provision agents on the fly.**
+  `mcp__agenticmail__create_account({ name: "worker-7" })` — the new agent's API key is resolved on-demand by the MCP server, and the dispatcher picks it up within ~1 minute. No restart required.
+
+- **Headless HTTP install endpoint** at `POST /api/agenticmail/integrations/claudecode/install`.
+  Lets an agent (or any script) wire itself in with a single curl. No master key needed for the install endpoint — see security model in the [package README](https://www.npmjs.com/package/@agenticmail/claudecode).
+
+### The "Claude Code is the brain" architecture
+
+Each AgenticMail agent is a mailbox + persistent state + identity inside AgenticMail. This integration supplies the *thinking* by spawning a fresh Claude Code session for each wake — that session uses Claude Code's own Claude OAuth (the same auth `claude` itself uses), operates the target agent's mailbox via MCP tools scoped with `_account: "<name>"`, and exits when done.
+
+```
+Anyone (you, an agent, a curl):
+   send mail to fola@localhost         POST /tasks/rpc { target: "Fola", task: ... }
+              │                                      │
+              ▼                                      ▼
+   AgenticMail master API           ──── task event ────→ dispatcher daemon (PM2)
+              │                                      │
+              │           SSE for fola's inbox       ▼
+              └──────────────────────────────→ spawns worker via Claude Agent SDK
+                                                     │
+                                                     ▼
+                                         Worker IS Fola for this turn:
+                                         - reads inbox / claims task
+                                         - sends mail / submits result
+                                         - exits
+```
+
+One Anthropic connection (your Claude OAuth). Many AgenticMail identities. Real email between them, real task RPC, real persistence.
+
+### Quick example
+
+After `agenticmail claudecode`, restart Claude Code and try in any session:
+
+```
+Agent { subagent_type: "agenticmail-fola", prompt: "Use call_agent to ask the 'researcher' agent to summarise AgenticMail in two sentences, then email me the summary." }
+```
+
+Fola will use the AgenticMail RPC pipeline to delegate to `researcher`, get a structured result back, and email the summary to her caller — all powered by Claude Code's OAuth, no separate keys, no broken enterprise dependencies.
+
+See [`@agenticmail/claudecode` on npm](https://www.npmjs.com/package/@agenticmail/claudecode) for the full design doc, security model, and HTTP API reference.
+
+---
+
 ## Programmatic Usage
 
 The package re-exports everything from `@agenticmail/core`, so you can use it as an SDK:

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,212 @@ 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")) {
+    log2("");
+    log2(`  ${c2.pinkBg(" \u{1F380} AgenticMail for Claude Code ")}`);
+    log2("");
+    log2(`  ${c2.bold("Usage:")} agenticmail claudecode [flags]`);
+    log2("");
+    log2("  Registers AgenticMail with Claude Code so every Claude Code session");
+    log2("  can call AgenticMail agents (Fola, John, \u2026) the same way it calls");
+    log2("  native subagents via the Agent tool.");
+    log2("");
+    log2("  Specifically, this command:");
+    log2(`    ${c2.dim("1.")} Provisions a dedicated "claudecode" AgenticMail agent (Claude Code's identity)`);
+    log2(`    ${c2.dim("2.")} Writes an MCP server entry into ~/.claude.json`);
+    log2(`    ${c2.dim("3.")} Generates one Claude Code subagent file per AgenticMail agent`);
+    log2(`        (in ${c2.cyan("~/.claude/agents/agenticmail-<name>.md")})`);
+    log2("");
+    log2(`  ${c2.bold("Flags:")}`);
+    log2(`    ${c2.green("--status")}        Show what's currently installed and exit`);
+    log2(`    ${c2.green("--remove")}        Uninstall (keeps the bridge agent by default)`);
+    log2(`    ${c2.green("--purge-bridge")}  When used with --remove, also delete the bridge agent`);
+    log2(`    ${c2.green("-h, --help")}      Show this help and exit`);
+    log2("");
+    log2(`  After install, restart Claude Code so it picks up the new MCP server.`);
+    log2("");
+    return;
+  }
+  let mod;
+  try {
+    mod = await import("@agenticmail/claudecode");
+  } catch (err) {
+    fail2(`Could not load @agenticmail/claudecode: ${err.message}`);
+    log2("");
+    info2(`Install it with: ${c2.green("npm install -g @agenticmail/claudecode")}`);
+    process.exit(1);
+    return;
+  }
+  if (sub.includes("--status")) {
+    const s = await mod.status();
+    log2("");
+    log2(`  ${c2.pinkBg(" \u{1F380} AgenticMail for Claude Code ")}`);
+    log2("");
+    const stateLabel = s.state === "installed" ? c2.green("installed") : s.state === "partial" ? c2.yellow("partial") : c2.dim("not installed");
+    log2(`  Status: ${stateLabel}`);
+    log2(`  MCP server registered: ${s.mcpInstalled ? c2.green("yes") : c2.dim("no")}`);
+    log2(`  Bridge agent in AgenticMail: ${s.bridgeAgentExists ? c2.green("yes") : c2.dim("no")}`);
+    log2(`  Subagent files: ${s.subagents.length > 0 ? c2.green(String(s.subagents.length)) : c2.dim("0")}`);
+    if (s.subagents.length > 0) for (const name of s.subagents) info2(`  \u2022 ${name}`);
+    if (s.notes.length > 0) {
+      log2("");
+      log2(`  ${c2.bold("Notes:")}`);
+      for (const n of s.notes) info2(`  \u2022 ${n}`);
+    }
+    log2("");
+    process.exit(s.state === "installed" ? 0 : 1);
+  }
+  if (sub.includes("--remove") || sub.includes("--uninstall")) {
+    log2("");
+    log2(`  ${c2.pinkBg(" \u{1F380} Removing AgenticMail from Claude Code ")}`);
+    log2("");
+    const purgeBridge = sub.includes("--purge-bridge");
+    const result2 = await mod.uninstall({ purgeBridgeAgent: purgeBridge });
+    if (result2.mcpBlockRemoved) ok2("Removed MCP server entry from Claude Code config");
+    else info2("No MCP server entry was registered.");
+    if (result2.removedSubagents.length > 0) ok2(`Removed ${result2.removedSubagents.length} subagent file(s)`);
+    else info2("No subagent files were registered.");
+    if (result2.bridgeAgentDeleted) ok2("Deleted bridge agent from AgenticMail");
+    else if (purgeBridge) info2("Bridge agent could not be deleted (already gone or AgenticMail unreachable).");
+    log2("");
+    if (!result2.changed) info2("Nothing to remove.");
+    log2("");
+    return;
+  }
+  log2("");
+  log2(`  ${c2.pinkBg(" \u{1F380} AgenticMail for Claude Code ")}`);
+  log2("");
+  log2(`  ${c2.bold("Wiring AgenticMail into Claude Code.")} This will:`);
+  log2(`    ${c2.dim("1.")} Provision a "claudecode" agent inside AgenticMail`);
+  log2(`    ${c2.dim("2.")} Add an MCP server entry to ~/.claude.json`);
+  log2(`    ${c2.dim("3.")} Generate one Claude Code subagent file per AgenticMail agent`);
+  log2("");
+  const spinner = new Spinner("general", "Talking to AgenticMail\u2026");
+  spinner.start();
+  let result;
+  try {
+    result = await mod.install();
+    spinner.succeed("Integration installed");
+  } catch (err) {
+    spinner.fail(`Install failed: ${err.message}`);
+    log2("");
+    if (err.status === 0) {
+      info2(`Is the AgenticMail server running? Try: ${c2.green("agenticmail start")}`);
+    }
+    log2("");
+    process.exit(1);
+    return;
+  }
+  ok2(`Bridge agent ${c2.bold(result.bridgeAgent.name)} ${c2.dim("(" + result.bridgeAgent.email + ")")}`);
+  ok2(`MCP server registered in ${c2.cyan(result.claudeConfigPath)}`);
+  ok2(`${result.registeredAgents.length} Claude Code subagent${result.registeredAgents.length === 1 ? "" : "s"} written to ${c2.cyan(result.agentsDir)}`);
+  for (const a of result.registeredAgents) info2(`  \u2022 agenticmail-${a.name.toLowerCase()}  \u2192  ${a.email}`);
+  log2("");
+  if (!result.changed) {
+    info2("Already up to date \u2014 no files were modified.");
+  } else {
+    log2(`  ${c2.bold("Next:")} restart Claude Code so it picks up the new MCP server.`);
+    info2(`Try inside Claude Code: ${c2.green('Agent { subagent_type: "agenticmail-fola", prompt: "hi" }')}`);
+  }
+  log2("");
+}
 async function cmdOpenClaw() {
   const sub = process.argv.slice(3);
   if (sub.includes("--help") || sub.includes("-h") || sub.includes("help")) {
@@ -5910,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)")} `);
@@ -6732,6 +6967,21 @@ switch (command) {
       process.exit(1);
     });
     break;
+  case "claudecode":
+  case "claude-code":
+  case "claude":
+    cmdClaudeCode().catch((err) => {
+      console.error(err);
+      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);
@@ -6769,11 +7019,13 @@ 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`);
     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)`);
     log2(`    ${c2.green("agenticmail update")}    Update to the latest version`);
     log2("");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agenticmail/cli",
-  "version": "0.5.62",
+  "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",
@@ -22,16 +22,19 @@
     "LICENSE"
   ],
   "scripts": {
-    "build": "tsup src/index.ts src/cli.ts --format esm --dts --clean",
+    "build": "tsup src/index.ts src/cli.ts --format esm --dts --clean --external @agenticmail/claudecode",
     "test": "vitest run --passWithNoTests",
     "preuninstall": "node scripts/uninstall.mjs",
     "prepublishOnly": "npm run build"
   },
   "dependencies": {
-    "@agenticmail/api": "^0.5.62",
+    "@agenticmail/api": "^0.6.0",
     "@agenticmail/core": "^0.5.61",
     "json5": "^2.2.3"
   },
+  "optionalDependencies": {
+    "@agenticmail/claudecode": "^0.1.0"
+  },
   "devDependencies": {
     "tsup": "^8.4.0",
     "typescript": "^5.7.0",