moeba-claude-channel 0.0.5 → 0.0.7

package/README.md

@@ -0,0 +1,98 @@
+# moeba-claude-channel
+
+Claude Code channel for [Moeba](https://moeba.co.za) — chat with Claude Code from the Moeba mobile app.
+
+## What it does
+
+Bridges your Claude Code session to the Moeba app. Send messages from your phone, Claude Code processes them and replies back.
+
+```
+Moeba App → Moeba Server → SSE → Local MCP Channel → Claude Code
+                        ← HTTP reply ← moeba_reply tool ←
+```
+
+## Install
+
+```bash
+npm install -g moeba-claude-channel
+```
+
+## Setup
+
+Add to `~/.claude.json`:
+
+```json
+{
+  "mcpServers": {
+    "moeba": {
+      "command": "moeba-claude-channel",
+      "args": ["--login"],
+      "autoApprove": ["moeba_reply", "moeba_progress"]
+    }
+  }
+}
+```
+
+### First run
+
+1. Start Claude Code — the channel starts automatically
+2. Browser opens for Google/Apple sign-in (same account as your Moeba app)
+3. Credentials cached at `~/.moeba/channel-<project>.json`
+4. A **"Claude Code — \<project\>"** agent appears in your Moeba app
+
+### Headless mode (SSH, CI, or setting up for another user)
+
+No browser needed — pass an API key and email via env vars:
+
+```json
+{
+  "mcpServers": {
+    "moeba": {
+      "command": "moeba-claude-channel",
+      "args": ["--login"],
+      "env": {
+        "MOEBA_API_KEY": "mba_your_key_here",
+        "MOEBA_EMAIL": "user@example.com"
+      },
+      "autoApprove": ["moeba_reply", "moeba_progress"]
+    }
+  }
+}
+```
+
+## Multi-project support
+
+Each project directory gets its own agent in the Moeba app:
+
+- `Claude Code — kepler`
+- `Claude Code — moeba`
+- `Claude Code — roxy`
+
+The project name is detected from the git repo. Override with `MOEBA_PROJECT` env var.
+
+## Tools
+
+| Tool | Description |
+|------|-------------|
+| `moeba_reply` | Send a reply back to the Moeba user |
+| `moeba_progress` | Show a typing indicator while working |
+
+## Channel notifications
+
+To enable Claude Code to auto-respond to incoming messages:
+
+```bash
+claude --dangerously-load-development-channels server:moeba
+```
+
+## Requirements
+
+- [Claude Code](https://claude.ai/code) v2.1.80+
+- [Moeba](https://moeba.co.za) account (free)
+- Node.js 20+
+
+## Links
+
+- [Moeba App (iOS)](https://apps.apple.com/za/app/moeba/id6758993423)
+- [Moeba App (Android)](https://play.google.com/store/apps/details?id=za.co.moeba.app)
+- [Moeba Web](https://web.moeba.co.za)

package/dist/moeba-channel.js

@@ -237,11 +237,47 @@ function connectSSE(c, mcp) {
 // Main — authenticate first, then connect MCP
 // ---------------------------------------------------------------------------
 async function main() {
-    // 1. Load cached credentials — never open browser automatically
-    //    User must run `npx moeba-claude-channel --login` to authenticate new projects
+    // 1. Authenticate — three modes:
+    //    a. Cached credentials (fastest, no network)
+    //    b. API key + email env vars (headless — SSH, CI, inviting others)
+    //    c. Browser OAuth (--login flag)
     const loginMode = process.argv.includes('--login');
+    const envApiKey = process.env.MOEBA_API_KEY;
+    const envEmail = process.env.MOEBA_EMAIL;
     let creds = loadCredentials();
-    if (!creds && loginMode) {
+    if (!creds && envApiKey && envEmail) {
+        // Mode B: headless auth via API key + email
+        console.error(`Authenticating as ${envEmail} via API key...`);
+        try {
+            const response = await fetch(`${MOEBA_API_URL}/channel/auth`, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({ apiKey: envApiKey, email: envEmail, projectName: PROJECT_NAME }),
+            });
+            if (!response.ok) {
+                const err = await response.text();
+                console.error(`API key auth failed: ${err}`);
+            }
+            else {
+                const data = (await response.json());
+                creds = {
+                    token: data.token,
+                    email: data.email,
+                    businessId: data.businessId,
+                    agentId: data.agentId,
+                    connectionId: data.connectionId,
+                    agentApiKey: data.agentApiKey,
+                    projectName: PROJECT_NAME,
+                };
+                saveCredentials(creds);
+            }
+        }
+        catch (err) {
+            console.error(`API key auth error: ${err.message}`);
+        }
+    }
+    else if (!creds && loginMode) {
+        // Mode C: browser OAuth
         console.error('No Moeba credentials found — opening browser to sign in...');
         creds = await authenticate();
     }
@@ -249,7 +285,7 @@ async function main() {
         console.error(`Authenticated as ${creds.email} (project: ${PROJECT_NAME})`);
     }
     else {
-        console.error(`Moeba channel: no credentials for project "${PROJECT_NAME}" — run with --login to authenticate`);
+        console.error(`Moeba channel: no credentials for project "${PROJECT_NAME}" — run with --login or set MOEBA_API_KEY + MOEBA_EMAIL`);
     }
     // 2. Create MCP channel server
     const mcp = new Server({ name: 'moeba', version: '0.0.1' }, {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "moeba-claude-channel",
-  "version": "0.0.5",
+  "version": "0.0.7",
   "description": "Claude Code channel for Moeba — chat with Claude Code from the Moeba app",
   "type": "module",
   "main": "dist/moeba-channel.js",
@@ -8,7 +8,8 @@
     "moeba-claude-channel": "dist/moeba-channel.js"
   },
   "files": [
-    "dist"
+    "dist",
+    "README.md"
   ],
   "scripts": {
     "build": "tsc",