agenticmail 0.5.1 → 0.5.3

package/README.md

@@ -1,8 +1,8 @@
 # agenticmail
 
-The main package for [AgenticMail](https://github.com/agenticmail/agenticmail) — email infrastructure for AI agents. This is the package you install to get started.
+The main package for [AgenticMail](https://github.com/agenticmail/agenticmail) — the first platform to give AI agents real email addresses and phone numbers. This is the package you install to get started.
 
-It bundles a setup wizard, API server launcher, and a full interactive shell with 44 commands for managing agents, sending and receiving email, configuring gateways, and more. It also re-exports everything from `@agenticmail/core` so you can use it as an SDK.
+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.
 
 ## Install
 
@@ -76,6 +76,66 @@ Agent emails use proper addresses like `secretary@yourdomain.com`.
 
 ---
 
+## CLI Commands
+
+All commands are available via `agenticmail <command>` or `npx agenticmail@latest <command>`.
+
+### Core Commands
+
+| Command | Description |
+|---------|-------------|
+| `agenticmail` | **Start the server.** Runs setup first if not initialized, then starts all services and opens the interactive shell. This is the default — just run `agenticmail` with no arguments. |
+| `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 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. |
+
+### Integration Commands
+
+| Command | Description |
+|---------|-------------|
+| `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. |
+
+### Service Management (Auto-Start on Boot)
+
+AgenticMail installs a system service so your email server starts automatically when your computer boots — no manual intervention needed.
+
+| Command | Description |
+|---------|-------------|
+| `agenticmail service` | **Show auto-start status.** Whether the service is installed and running. |
+| `agenticmail service install` | **Install the auto-start service.** On boot, the startup script waits up to 10 minutes for Docker, checks Stalwart (starts it if needed), then launches the API server. |
+| `agenticmail service uninstall` | **Remove the auto-start service.** AgenticMail will no longer start on boot. |
+| `agenticmail service reinstall` | **Reinstall the service.** Use after config changes or updates to refresh the service file. |
+
+**How auto-start works on reboot:**
+1. Computer starts → Docker Desktop launches (its own auto-start)
+2. Stalwart mail server starts (`restart: unless-stopped` in Docker)
+3. AgenticMail startup script waits for Docker to be ready (up to 10 min)
+4. Script verifies Stalwart is running (auto-starts it if needed)
+5. API server starts and begins accepting requests
+6. If the server crashes, the system service automatically restarts it
+
+On macOS this uses a LaunchAgent (`~/Library/LaunchAgents/com.agenticmail.server.plist`). On Linux it uses a systemd user service (`~/.config/systemd/user/agenticmail.service`).
+
+### Maintenance Commands
+
+| Command | Description |
+|---------|-------------|
+| `agenticmail update` | **Update to the latest version.** Checks npm, updates the CLI and OpenClaw plugin, and restarts the gateway. |
+| `agenticmail help` | **Show available commands.** |
+
+### Logs
+
+Server logs are stored in `~/.agenticmail/logs/`:
+
+| File | Contents |
+|------|----------|
+| `server.log` | API server stdout |
+| `server.err.log` | API server stderr |
+| `startup.log` | Boot sequence log — Docker wait times, Stalwart checks, startup events |
+
+---
+
 ## Starting the Server
 
 `agenticmail start` does three things:
@@ -98,6 +158,7 @@ If the server crashes, you get clear error output showing what went wrong.
 - **Account setup** — whether the config file and database exist
 - **Server health** — API server connectivity and Stalwart reachability
 - **Email gateway** — current mode (relay or domain), provider name, domain name, polling status
+- **Auto-start** — whether the system service is installed and running
 
 ---
 

package/dist/cli.js

@@ -4574,28 +4574,33 @@ async function cmdSetup() {
     } catch (err) {
       const msg = err.message;
       if (msg === "DOCKER_MANUAL_START") {
-        spinner.fail(`Docker installed but couldn't start automatically`);
+        spinner.fail(`Docker needs to be set up manually (first time only)`);
         log2("");
-        log2(`  ${c2.pink(c2.bold("Don't worry! Here's how to fix this:"))}`);
+        log2(`  ${c2.pink(c2.bold("No worries! This only takes a minute:"))}`);
         log2("");
-        log2(`  ${c2.pink("Step 1:")} Open a ${c2.bold("new terminal window")}`);
-        log2(`         ${c2.dim("(Command + T on Mac, or open Terminal from your dock)")}`);
+        log2(`  ${c2.pink("Step 1:")} Check if Docker Desktop is installed`);
+        log2(`         ${c2.dim("Look for Docker in your Applications folder or Launchpad.")}`);
+        log2(`         ${c2.dim("If it's not there, install it:")}`);
+        log2(`         ${c2.cyan("brew install --cask docker")}`);
+        log2(`         ${c2.dim("(You'll need to enter your Mac password when prompted)")}`);
         log2("");
-        log2(`  ${c2.pink("Step 2:")} Run this command:`);
+        log2(`  ${c2.pink("Step 2:")} Open Docker Desktop`);
+        log2(`         ${c2.dim("Double-click Docker in Applications, or run:")}`);
         log2(`         ${c2.cyan("open -a Docker")}`);
         log2("");
-        log2(`  ${c2.pink("Step 3:")} Wait for Docker Desktop to fully load`);
-        log2(`         ${c2.dim("You'll see a whale icon in your menu bar (top of screen).")}`);
-        log2(`         ${c2.dim("Wait until it stops animating \u2014 that means it's ready.")}`);
+        log2(`  ${c2.pink("Step 3:")} Accept the license agreement`);
+        log2(`         ${c2.dim("On first launch, Docker shows a license dialog.")}`);
+        log2(`         ${c2.dim('Click "Accept" to continue. It will then start loading.')}`);
         log2("");
-        log2(`  ${c2.pink("Step 4:")} Close that terminal window`);
-        log2(`         ${c2.dim("Just close the window normally (Command + W). Don't press Ctrl+C.")}`);
+        log2(`  ${c2.pink("Step 4:")} Wait for the whale icon`);
+        log2(`         ${c2.dim("You'll see a whale icon in your menu bar (top of screen).")}`);
+        log2(`         ${c2.dim("Wait until it stops animating \u2014 that means Docker is ready.")}`);
         log2("");
         log2(`  ${c2.pink("Step 5:")} Come back here and run:`);
         log2(`         ${c2.green("npx agenticmail@latest")}`);
         log2("");
-        log2(`  ${c2.dim("That's it! Docker only needs this manual start the first time.")}`);
-        log2(`  ${c2.dim("After that, it starts automatically.")}`);
+        log2(`  ${c2.dim("That's it! Docker only needs this manual setup the first time.")}`);
+        log2(`  ${c2.dim("After that, it starts automatically on boot.")}`);
       } else {
         spinner.fail(`Couldn't start Docker: ${msg}`);
         log2("");

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "agenticmail",
-  "version": "0.5.1",
-  "description": "Email infrastructure for AI agents — send and receive real email programmatically",
+  "version": "0.5.3",
+  "description": "Email and SMS infrastructure for AI agents \u2014 the first platform to give agents real email addresses and phone numbers",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -47,6 +47,8 @@
   "bugs": "https://github.com/agenticmail/agenticmail/issues",
   "keywords": [
     "email",
+    "sms",
+    "phone",
     "ai",
     "agent",
     "mail",
@@ -57,7 +59,11 @@
     "agenticmail",
     "llm",
     "gateway",
-    "cloudflare"
+    "cloudflare",
+    "google-voice",
+    "text-message",
+    "verification-code",
+    "openclaw"
   ],
   "publishConfig": {
     "access": "public"