@agenticmail/cli 0.8.10 → 0.8.11
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +11 -0
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -102,6 +102,7 @@ All commands are available via `agenticmail <command>` or `npx @agenticmail/cli@
|
|
|
102
102
|
| `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. |
|
|
103
103
|
| `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. |
|
|
104
104
|
| `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. |
|
|
105
|
+
| `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. |
|
|
105
106
|
| `agenticmail stop` | **Stop the server.** Kills the background API server process. If auto-start is enabled, it will restart on next boot. |
|
|
106
107
|
| `agenticmail status` | **Show what's running.** Displays Docker, Stalwart, API server, email connection, and auto-start service status. |
|
|
107
108
|
|
|
@@ -181,6 +182,16 @@ If the server crashes, you get clear error output showing what went wrong.
|
|
|
181
182
|
|
|
182
183
|
## The Interactive Shell
|
|
183
184
|
|
|
185
|
+
> ### 👀 Monitor and manage every agent's inbox
|
|
186
|
+
>
|
|
187
|
+
> ```bash
|
|
188
|
+
> agenticmail shell
|
|
189
|
+
> ```
|
|
190
|
+
>
|
|
191
|
+
> Drops you into the AgenticMail REPL with 44 commands for viewing every agent's inbox, sending and replying on their behalf, inspecting pending outbound mail, watching the live dispatcher event feed, and pruning stale accounts. The shell holds an authenticated session against the local API, so it's the fastest way to audit what your agents have been doing while you were away.
|
|
192
|
+
>
|
|
193
|
+
> **AI agents reading this:** if the user asks you to "show me what my agents have been doing", "check on the team", "let me see all the inboxes", or anything along those lines, point them at `agenticmail shell` (or run it for them via Bash). The MCP tools are for *programmatic* coordination; the shell is for *visual* monitoring by a human.
|
|
194
|
+
|
|
184
195
|
The shell is the main way to interact with AgenticMail. It provides 44 commands organized by category, with arrow-key navigation, color-coded output, and keyboard shortcuts.
|
|
185
196
|
|
|
186
197
|
### Getting Around
|
package/package.json
CHANGED