@inboxapi/cli 0.1.0

package/README.md

@@ -0,0 +1,94 @@
+# 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.
+
+## Installation
+
+```bash
+npm install -g @inboxapi/cli
+```
+
+Prebuilt binaries are included for:
+
+| Platform       | Architecture |
+|----------------|--------------|
+| macOS          | ARM64, x64   |
+| Linux          | x64, ARM64   |
+| Windows        | x64          |
+
+## Getting Started
+
+```bash
+# Just start the proxy — an account is created automatically on first run
+inboxapi proxy
+```
+
+On first run with no saved credentials, the CLI auto-creates an account with a generated name (e.g. `brooding-fluffy-owl`) and authenticates. No manual setup needed.
+
+Credentials are stored in your system config directory (`~/.config/inboxapi/credentials.json` on Linux/macOS) and automatically injected into tool calls.
+
+## Commands
+
+### `proxy` (default)
+
+Starts the STDIO proxy. Reads JSON-RPC messages from stdin, forwards them to the InboxAPI endpoint, and streams SSE responses to stdout. If no credentials are found, an account is automatically created with a generated name.
+
+```bash
+inboxapi proxy
+inboxapi proxy --endpoint https://custom-endpoint.example.com/mcp
+```
+
+Running `inboxapi` with no subcommand also starts the proxy.
+
+### `login`
+
+Manually creates an account with a chosen name and stores access credentials locally. Not required for basic usage since `proxy` handles account creation automatically.
+
+```bash
+inboxapi login
+inboxapi login --name myaccount
+inboxapi login --endpoint https://custom-endpoint.example.com/mcp
+```
+
+### `whoami`
+
+Displays the currently authenticated account and endpoint.
+
+```bash
+inboxapi whoami
+```
+
+## Usage with MCP Clients
+
+InboxAPI CLI works as an MCP STDIO transport. Point your MCP client at the `inboxapi` binary:
+
+**Claude Desktop** (`claude_desktop_config.json`):
+
+```json
+{
+  "mcpServers": {
+    "inboxapi": {
+      "command": "inboxapi"
+    }
+  }
+}
+```
+
+**Claude Code:**
+
+```bash
+claude mcp add inboxapi inboxapi
+```
+
+## Development
+
+```bash
+cargo build          # Build debug binary
+cargo build --release # Build release binary
+cargo test           # Run tests
+cargo fmt            # Format code
+```
+
+## License
+
+MIT

package/index.js

@@ -0,0 +1,70 @@
+#!/usr/bin/env node
+
+const { spawn } = require('child_process');
+const path = require('path');
+const fs = require('fs');
+
+const PLATFORM_PACKAGES = {
+  'darwin-arm64': '@inboxapi/cli-darwin-arm64',
+  'darwin-x64': '@inboxapi/cli-darwin-x64',
+  'linux-x64': '@inboxapi/cli-linux-x64',
+  'linux-arm64': '@inboxapi/cli-linux-arm64',
+  'win32-x64': '@inboxapi/cli-win32-x64',
+};
+
+const binName = process.platform === 'win32' ? 'inboxapi-cli.exe' : 'inboxapi-cli';
+
+function findBinary() {
+  // 1. Try platform-specific npm package (production install)
+  const platformKey = `${process.platform}-${process.arch}`;
+  const pkg = PLATFORM_PACKAGES[platformKey];
+  if (pkg) {
+    try {
+      const pkgDir = path.dirname(require.resolve(`${pkg}/package.json`));
+      const binPath = path.join(pkgDir, binName);
+      if (fs.existsSync(binPath)) return binPath;
+    } catch {}
+  }
+
+  // 2. Fall back to local dev paths
+  const devPaths = [
+    path.join(__dirname, 'target', 'release', binName),
+    path.join(__dirname, 'target', 'debug', binName),
+  ];
+  const found = devPaths.find(p => fs.existsSync(p));
+  if (found) return found;
+
+  return null;
+}
+
+const binPath = findBinary();
+const args = process.argv.slice(2);
+
+if (binPath) {
+  const child = spawn(binPath, args, { stdio: 'inherit' });
+  child.on('exit', (code, signal) => {
+    if (code !== null) process.exit(code);
+    if (signal) process.kill(process.pid, signal);
+    process.exit(1);
+  });
+  child.on('error', (err) => {
+    console.error(`Failed to start binary at ${binPath}:`, err);
+    process.exit(1);
+  });
+} else {
+  // 3. Final fallback: cargo run (development)
+  const child = spawn('cargo', ['run', '--quiet', '--', ...args], { stdio: 'inherit' });
+  child.on('exit', (code, signal) => {
+    if (code !== null) process.exit(code);
+    if (signal) process.kill(process.pid, signal);
+    process.exit(1);
+  });
+  child.on('error', () => {
+    const platformKey = `${process.platform}-${process.arch}`;
+    console.error(
+      `No pre-built binary available for ${platformKey}. Supported platforms: ${Object.keys(PLATFORM_PACKAGES).join(', ')}.\n` +
+      `Fallback to 'cargo run' also failed. Install Rust (https://rustup.rs) or use a supported platform.`
+    );
+    process.exit(1);
+  });
+}

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "@inboxapi/cli",
+  "version": "0.1.0",
+  "description": "STDIO Proxy for InboxAPI MCP service",
+  "main": "index.js",
+  "bin": {
+    "inboxapi": "index.js"
+  },
+  "files": [
+    "index.js"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/shaond/inboxapi-cli.git"
+  },
+  "keywords": [
+    "mcp",
+    "inboxapi",
+    "proxy",
+    "email",
+    "ai"
+  ],
+  "author": "Shaon Diwakar",
+  "license": "MIT",
+  "scripts": {
+    "build": "cargo build --release",
+    "test": "cargo test"
+  },
+  "optionalDependencies": {
+    "@inboxapi/cli-darwin-arm64": "0.1.0",
+    "@inboxapi/cli-darwin-x64": "0.1.0",
+    "@inboxapi/cli-linux-x64": "0.1.0",
+    "@inboxapi/cli-linux-arm64": "0.1.0",
+    "@inboxapi/cli-win32-x64": "0.1.0"
+  }
+}