@inboxapi/cli 0.2.2 → 0.2.3

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Shaon Diwakar
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,6 +1,40 @@
 # InboxAPI CLI
 
-STDIO proxy that bridges the [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) over STDIO to the remote [InboxAPI](https://inboxapi.ai) service over Streamable HTTP/SSE. This lets any MCP-compatible client (Claude Desktop, Claude Code, etc.) use InboxAPI's email tools without custom HTTP integration.
+Give your AI agent its own email address. Send, receive, read, search, and reply to emails — right from Claude, Codex, Gemini, or any MCP-compatible AI client. No email server to run, no SMTP to configure.
+
+**Quick Setup (Claude Code, Gemini CLI, etc.):** 
+
+Copy and paste this sentence into your agent:  
+
+```
+Install the `@inboxapi/cli` npm package globally and then register the `inboxapi` command as an MCP server named `inboxapi`.
+```
+
+### How it works
+
+1. Install the CLI
+2. Connect it to your AI client (Claude Desktop, Claude Code, Gemini CLI, etc.)
+3. Your AI can now use email — no code or API keys needed
+
+An account with a unique email address is created automatically on first run. Your AI can then:
+
+- **Send emails** to any address
+- **Receive emails** at its own inbox
+- **Reply to** and **forward** emails
+- **Search** emails by keyword
+- **Read full threads** of conversation
+
+## Technical details
+
+The CLI acts as a local bridge between your AI client and the [InboxAPI](https://inboxapi.ai) cloud service. It speaks the [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) over standard input/output, so any compatible AI client can use it without custom integration.
+
+## Good to know
+
+- **This is your agent's personal email** — InboxAPI gives your AI agent its own email address for personal use. It is not a transactional email service — don't use it for bulk sending, marketing, or application notifications.
+- **Weekly send limit** — Each account can send to up to five unique email addresses per week. This resets weekly.
+- **Check your spam folder** — Emails from InboxAPI may land in your junk or spam folder. If you're not seeing messages, check there first.
+- **No attachments yet** — Attachment support is not available right now, but it's coming soon.
+- **No rich text yet** — Emails are sent as plain text only. Rich text (HTML) support is coming soon.
 
 ## Installation
 
@@ -18,8 +52,9 @@ Prebuilt binaries are included for:
 
 ## Getting Started
 
+Just start the proxy — an account is created automatically on first run
+
 ```bash
-# Just start the proxy — an account is created automatically on first run
 inboxapi proxy
 ```
 
@@ -80,33 +115,51 @@ InboxAPI CLI works as an MCP STDIO transport. Point your MCP client at the `inbo
 
 **Claude Code:**
 
+Add to current project:
+
 ```bash
-# Add to current project
 claude mcp add inboxapi inboxapi
+```
 
-# Add globally (available in all projects)
+Add globally (available in all projects):
+
+```bash
 claude mcp add inboxapi inboxapi -s user
 ```
 
 **Gemini CLI:**
 
+Add to current project:
+
 ```bash
-# Add to current project
 gemini mcp add inboxapi inboxapi
+```
+
+Add system-wide (available in all directories):
 
-# Add system-wide (available in all directories)
+```bash
 gemini mcp add inboxapi inboxapi --scope user
 ```
 
+**Codex CLI:**
+
+```bash
+codex mcp add inboxapi -- inboxapi
+```
+
 ## Development
 
 ```bash
-cargo build          # Build debug binary
+cargo build           # Build debug binary
 cargo build --release # Build release binary
-cargo test           # Run tests
-cargo fmt            # Format code
+cargo test            # Run tests
+cargo fmt             # Format code
 ```
 
 ## License
 
-MIT
+The source code in this repository is licensed under the [MIT License](LICENSE).
+
+## Disclaimer
+
+The InboxAPI service is provided as-is, with no guarantees or warranties of any kind. We reserve all rights regarding how the service is operated. Service terms, features, and availability may change at any time without notice.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@inboxapi/cli",
-  "version": "0.2.2",
+  "version": "0.2.3",
   "description": "📧 Email for your AI 🤖",
   "main": "index.js",
   "bin": {
@@ -27,10 +27,10 @@
     "test": "cargo test"
   },
   "optionalDependencies": {
-    "@inboxapi/cli-darwin-arm64": "0.2.2",
-    "@inboxapi/cli-darwin-x64": "0.2.2",
-    "@inboxapi/cli-linux-x64": "0.2.2",
-    "@inboxapi/cli-linux-arm64": "0.2.2",
-    "@inboxapi/cli-win32-x64": "0.2.2"
+    "@inboxapi/cli-darwin-arm64": "0.2.3",
+    "@inboxapi/cli-darwin-x64": "0.2.3",
+    "@inboxapi/cli-linux-x64": "0.2.3",
+    "@inboxapi/cli-linux-arm64": "0.2.3",
+    "@inboxapi/cli-win32-x64": "0.2.3"
   }
 }