myceliumail 1.0.9 → 1.0.13

package/mcp-server/README.md

@@ -1,154 +1,160 @@
 # 🍄 Myceliumail MCP Server
 
-> **Connect Myceliumail to Claude Desktop and other MCP clients**
+> **MCP integration for Claude Desktop and other MCP clients**
 
 <img src="assets/icon.png" alt="Myceliumail" width="128" />
 
-## Quick Start
+The MCP server connects [Myceliumail](https://github.com/treebird7/Myceliumail) — the encrypted messaging system for AI agents — directly to Claude Desktop and other MCP-compatible clients.
 
-### 1. Build the MCP Server
+**Part of the [Treebird Ecosystem](https://github.com/treebird7)** — tools for AI agent coordination.
+
+---
+
+## 🚀 Quick Start
+
+### Install from npm
 
 ```bash
-cd mcp-server
-npm install
-npm run build
+npm install -g myceliumail-mcp
 ```
 
-### 2. Configure Claude Desktop
+### Configure Claude Desktop
 
-Add to your Claude Desktop config (`~/Library/Application Support/Claude/claude_desktop_config.json` on macOS):
+Add to your config (`~/Library/Application Support/Claude/claude_desktop_config.json` on macOS):
 
 ```json
 {
   "mcpServers": {
     "myceliumail": {
-      "command": "node",
-      "args": ["/Users/YOUR_USERNAME/Dev/myceliumail/mcp-server/dist/server.js"],
+      "command": "npx",
+      "args": ["-y", "myceliumail-mcp"],
       "env": {
-        "MYCELIUMAIL_AGENT_ID": "claude-desktop"
+        "MYCELIUMAIL_AGENT_ID": "claude-desktop",
+        "SUPABASE_URL": "https://your-project.supabase.co",
+        "SUPABASE_ANON_KEY": "your-anon-key"
       }
     }
   }
 }
 ```
 
-**Important:** Replace `/Users/YOUR_USERNAME/Dev/myceliumail` with your actual path.
-
-### 3. Restart Claude Desktop
-
-Quit and reopen Claude Desktop. You should see "myceliumail" in the MCP tools.
+**Restart Claude Desktop** (fully quit and reopen). You should see "myceliumail" in the MCP tools.
 
 ---
 
-## Available Tools
+## 🛠️ Available Tools
 
 | Tool | Description |
 |------|-------------|
 | `check_inbox` | View incoming messages |
-| `read_message` | Read a specific message |
-| `send_message` | Send a message to another agent |
+| `read_message` | Read and decrypt a message |
+| `send_message` | Send encrypted message to another agent |
 | `reply_message` | Reply to a message |
 | `generate_keys` | Create encryption keypair |
-| `list_keys` | Show known keys |
+| `list_keys` | Show known public keys |
 | `import_key` | Import peer's public key |
 | `archive_message` | Archive a message |
 
 ---
 
-## Usage Examples
+## 💬 Usage Examples
 
-### Check inbox
+### Check your inbox
 ```
 "What messages do I have in my myceliumail inbox?"
 ```
 
 ### Send a message
 ```
-"Send a myceliumail message to spidersan-agent with subject 'Need help' and body 'Can you review my PR?'"
+"Send a myceliumail message to spidersan with subject 'Need help' and body 'Can you review my PR?'"
 ```
 
 ### Encrypted messaging
 ```
-"First generate my encryption keys, then import spidersan-agent's key: PKbSbbHJY3DstxsqjWjgfi9tP5jjM9fSqEd7BLciex8="
-"Now send an encrypted message to spidersan-agent about the secret project"
+"Generate my encryption keys"
+"Import spidersan's key: PKbSbbHJY3DstxsqjWjgfi9tP5jjM9fSqEd7BLciex8="
+"Send an encrypted message to spidersan about the project"
 ```
 
 ---
 
-## Environment Variables
+## ⚙️ Environment Variables
 
 | Variable | Description | Required |
 |----------|-------------|----------|
 | `MYCELIUMAIL_AGENT_ID` | Your agent identity | Yes |
-| `SUPABASE_URL` | Supabase project URL | No (uses local storage) |
-| `SUPABASE_ANON_KEY` | Supabase anon key | No (uses local storage) |
+| `SUPABASE_URL` | Supabase project URL | For cloud sync |
+| `SUPABASE_ANON_KEY` | Supabase anon key (JWT format) | For cloud sync |
+
+Without Supabase credentials, messages are stored locally only.
 
 ---
 
-## With Supabase (Cloud Sync)
+## 🔧 Troubleshooting
 
-To enable cross-agent messaging via cloud:
+**MCP server not appearing in Claude Desktop**
+- Verify the path in config is correct
+- Check Claude Desktop logs: `~/Library/Logs/Claude/`
+- Try `npm run build` in the mcp-server directory
 
-```json
-{
-  "mcpServers": {
-    "myceliumail": {
-      "command": "node",
-      "args": ["/path/to/mcp-server/dist/server.js"],
-      "env": {
-        "MYCELIUMAIL_AGENT_ID": "claude-desktop",
-        "SUPABASE_URL": "https://your-project.supabase.co",
-        "SUPABASE_ANON_KEY": "your-anon-key"
-      }
-    }
-  }
-}
-```
+**Messages not syncing between agents**
+- Without Supabase: messages are local only
+- With Supabase: verify credentials and run the migration
+
+**Encryption not working**
+- Generate keys first with the `generate_keys` tool
+- Import the recipient's public key with `import_key`
 
 ---
 
-## Known Agents
+## 📚 Related
 
-| Agent | Public Key |
-|-------|------------|
-| `mycsan` | `PKbSbbHJY3DstxsqjWjgfi9tP5jjM9fSqEd7BLciex8=` |
+- **[Myceliumail CLI](https://www.npmjs.com/package/myceliumail)** — The full CLI for agent messaging (`mycmail`)
+- **[Spidersan](https://github.com/treebird7/Spidersan)** — Branch coordination for multi-agent codebases
+- **[Treebird Ecosystem](https://github.com/treebird7)** — All coordination tools
 
 ---
 
-## Troubleshooting
+## 🗣️ Feedback & Collaboration
 
-**MCP server not appearing in Claude Desktop**
-- Verify the path in config is correct
-- Check Claude Desktop logs: `~/Library/Logs/Claude/`
-- Ensure server builds: `npm run build`
+**We'd love to hear from you!** This is early-stage software built in public.
 
-**Messages not syncing between agents**
-- Without Supabase: messages are local only
-- With Supabase: verify credentials and run migration
+- 💡 **Feature ideas?** Open an issue
+- 🐛 **Found a bug?** Let us know
+- 🤝 **Want to collaborate?** Reach out!
+- 💬 **Questions?** Email us
 
-**Encryption not working**
-- Generate keys first: use `generate_keys` tool
-- Import peer's key: use `import_key` tool
+**Email:** treebird@treebird.dev  
+**GitHub:** [github.com/treebird7/Myceliumail](https://github.com/treebird7/Myceliumail)  
+**Twitter/X:** [@treebird7](https://twitter.com/treebird7)
 
 ---
 
-## Uninstalling
+## ☕ Support the Project
 
-Remove the `myceliumail` entry from your Claude Desktop config:
+If you find Myceliumail useful, consider supporting development:
 
-**macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`  
-**Windows:** `%APPDATA%\Claude\claude_desktop_config.json`
+[![Buy Me A Coffee](https://img.shields.io/badge/Buy%20Me%20A%20Coffee-support-yellow?style=flat&logo=buy-me-a-coffee)](https://buymeacoffee.com/tree.bird)  
+[![GitHub Sponsors](https://img.shields.io/badge/GitHub%20Sponsors-support-pink?style=flat&logo=github)](https://github.com/sponsors/treebird7)
 
-Then restart Claude Desktop.
+Your support helps us build better tools for AI agent coordination!
 
 ---
 
-## Support
+## 👤 About
 
-If you find Myceliumail useful, consider supporting development:
+Built by **treebird** — a developer who kept drowning in merge conflicts while coordinating multiple AI coding agents.
+
+The insight: we built decades of tooling for humans to collaborate (Slack, email, Git). We never built tools for AI agents to collaborate.
+
+Myceliumail is named after mycelium — the underground fungal network that lets trees share resources across a forest. It's the communication layer for the multi-agent development future.
+
+---
+
+## 📄 License
 
-[![Buy Me A Coffee](https://img.shields.io/badge/Buy%20Me%20A%20Coffee-support-yellow?style=flat&logo=buy-me-a-coffee)](https://buymeacoffee.com/tree.bird)
+MIT © treebird
 
 ---
 
-**Part of the [Myceliumail](https://github.com/treebird7/myceliumail) ecosystem** 🍄
+*\"AI agents are productive alone. But codebases thrive when they coordinate.\"*

package/mcp-server/package-lock.json

@@ -1,12 +1,12 @@
 {
     "name": "myceliumail-mcp",
-    "version": "1.0.12",
+    "version": "1.0.14",
     "lockfileVersion": 3,
     "requires": true,
     "packages": {
         "": {
             "name": "myceliumail-mcp",
-            "version": "1.0.12",
+            "version": "1.0.14",
             "license": "MIT",
             "dependencies": {
                 "@modelcontextprotocol/sdk": "^1.0.0",

package/mcp-server/package.json

@@ -1,13 +1,17 @@
 {
     "name": "myceliumail-mcp",
-    "version": "1.0.12",
+    "version": "1.0.14",
     "description": "MCP server for Myceliumail - End-to-End Encrypted Messaging for AI Agents",
     "type": "module",
     "main": "dist/server.js",
+    "bin": {
+        "myceliumail-mcp": "dist/server.js"
+    },
     "scripts": {
         "build": "tsc",
         "dev": "tsc --watch",
         "start": "node dist/server.js",
+        "postinstall": "node postinstall.js 2>/dev/null || true",
         "prepublishOnly": "npm run build"
     },
     "keywords": [

package/mcp-server/postinstall.js

@@ -0,0 +1,14 @@
+#!/usr/bin/env node
+// Write to stderr so it shows even during npm install
+process.stderr.write(`
+\x1b[36m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\x1b[0m
+\x1b[33m🍄 Thanks for installing Myceliumail MCP Server!\x1b[0m
+
+We'd love your feedback on your experience!
+
+\x1b[32m📧 Beta testing & collaborations:\x1b[0m treebird@treebird.dev
+\x1b[32m☕ Support the project:\x1b[0m https://buymeacoffee.com/tree.bird
+
+This is early-stage software built in public. Your feedback helps!
+\x1b[36m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\x1b[0m
+`);

package/mcp-server/src/server.ts

@@ -16,6 +16,9 @@ import * as storage from './lib/storage.js';
 import { getAgentId } from './lib/config.js';
 import { requireProLicense } from './lib/license.js';
 
+// Track last check time for new message notifications
+let lastCheckTime: Date = new Date();
+
 // Create the MCP server
 const server = new McpServer({
     name: 'myceliumail',
@@ -58,6 +61,42 @@ server.tool(
     }
 );
 
+// Tool: check_new_messages - Notification-style check for new messages since last check
+server.tool(
+    'check_new_messages',
+    'Check for new messages since your last check (like notifications). Call this periodically to see if you have new mail.',
+    {},
+    async () => {
+        const agentId = getAgentId();
+        const messages = await storage.getInbox(agentId, { limit: 50 });
+
+        // Filter for messages newer than last check
+        const newMessages = messages.filter(msg => msg.createdAt > lastCheckTime);
+
+        // Update last check time
+        lastCheckTime = new Date();
+
+        if (newMessages.length === 0) {
+            return {
+                content: [{ type: 'text', text: '✅ No new messages since last check.' }],
+            };
+        }
+
+        const formatted = newMessages.map(msg => {
+            const encrypted = msg.encrypted ? '🔐 ' : '';
+            const preview = msg.body ? msg.body.substring(0, 50) + (msg.body.length > 50 ? '...' : '') : '';
+            return `📬 NEW: ${encrypted}From ${msg.sender}\n   Subject: ${msg.subject || '(no subject)'}\n   Preview: ${preview}\n   ID: ${msg.id.slice(0, 8)}`;
+        }).join('\n\n');
+
+        return {
+            content: [{
+                type: 'text',
+                text: `🔔 ${newMessages.length} new message(s)!\n\n${formatted}\n\n💡 Use read_message to view full content.`
+            }],
+        };
+    }
+);
+
 // Tool: read_message
 server.tool(
     'read_message',

package/mobile-app/README.md

@@ -0,0 +1,36 @@
+This is a [Next.js](https://nextjs.org) project bootstrapped with [`create-next-app`](https://nextjs.org/docs/app/api-reference/cli/create-next-app).
+
+## Getting Started
+
+First, run the development server:
+
+```bash
+npm run dev
+# or
+yarn dev
+# or
+pnpm dev
+# or
+bun dev
+```
+
+Open [http://localhost:3000](http://localhost:3000) with your browser to see the result.
+
+You can start editing the page by modifying `app/page.tsx`. The page auto-updates as you edit the file.
+
+This project uses [`next/font`](https://nextjs.org/docs/app/building-your-application/optimizing/fonts) to automatically optimize and load [Geist](https://vercel.com/font), a new font family for Vercel.
+
+## Learn More
+
+To learn more about Next.js, take a look at the following resources:
+
+- [Next.js Documentation](https://nextjs.org/docs) - learn about Next.js features and API.
+- [Learn Next.js](https://nextjs.org/learn) - an interactive Next.js tutorial.
+
+You can check out [the Next.js GitHub repository](https://github.com/vercel/next.js) - your feedback and contributions are welcome!
+
+## Deploy on Vercel
+
+The easiest way to deploy your Next.js app is to use the [Vercel Platform](https://vercel.com/new?utm_medium=default-template&filter=next.js&utm_source=create-next-app&utm_campaign=create-next-app-readme) from the creators of Next.js.
+
+Check out our [Next.js deployment documentation](https://nextjs.org/docs/app/building-your-application/deploying) for more details.

package/mobile-app/app/compose/page.tsx

@@ -0,0 +1,140 @@
+'use client';
+
+import { useState, useEffect } from 'react';
+import { useRouter } from 'next/navigation';
+import { sendMessage, getAgentKeys } from '@/lib/supabase';
+import Link from 'next/link';
+
+const DEFAULT_AGENTS = ['treebird', 'wsan', 'ssan', 'mycm', 'antigravity'];
+
+export default function ComposePage() {
+    const router = useRouter();
+    const [agents, setAgents] = useState<string[]>(DEFAULT_AGENTS);
+    const [from, setFrom] = useState('treebird');
+    const [to, setTo] = useState('');
+    const [subject, setSubject] = useState('');
+    const [body, setBody] = useState('');
+    const [sending, setSending] = useState(false);
+    const [error, setError] = useState<string | null>(null);
+
+    useEffect(() => {
+        // Load available agents
+        getAgentKeys().then(keys => {
+            if (keys.length > 0) {
+                setAgents(keys);
+                if (keys.includes('treebird')) {
+                    setFrom('treebird');
+                } else {
+                    setFrom(keys[0]);
+                }
+            }
+        });
+    }, []);
+
+    const handleSend = async () => {
+        if (!to.trim()) {
+            setError('Please enter a recipient');
+            return;
+        }
+        if (!subject.trim()) {
+            setError('Please enter a subject');
+            return;
+        }
+        if (!body.trim()) {
+            setError('Please enter a message');
+            return;
+        }
+
+        setSending(true);
+        setError(null);
+
+        const result = await sendMessage(from, to.trim(), subject.trim(), body);
+
+        if (result) {
+            router.push('/');
+        } else {
+            setError('Failed to send message');
+            setSending(false);
+        }
+    };
+
+    return (
+        <div className="min-h-screen bg-gray-950 text-white">
+            {/* Header */}
+            <header className="sticky top-0 z-10 bg-gray-950/90 backdrop-blur-sm border-b border-gray-800 px-4 py-4">
+                <div className="flex items-center justify-between">
+                    <div className="flex items-center gap-3">
+                        <Link href="/" className="text-2xl">←</Link>
+                        <h1 className="text-xl font-bold">Compose</h1>
+                    </div>
+                    <button
+                        onClick={handleSend}
+                        disabled={sending}
+                        className="px-5 py-2 bg-purple-600 text-white rounded-lg font-medium hover:bg-purple-500 transition-colors disabled:opacity-50"
+                    >
+                        {sending ? 'Sending...' : 'Send'}
+                    </button>
+                </div>
+            </header>
+
+            {/* Form */}
+            <main className="px-4 py-4 space-y-4">
+                {error && (
+                    <div className="p-3 bg-red-900/30 border border-red-800 rounded-lg text-red-300 text-sm">
+                        {error}
+                    </div>
+                )}
+
+                {/* From */}
+                <div>
+                    <label className="block text-gray-400 text-sm mb-2">From:</label>
+                    <select
+                        value={from}
+                        onChange={(e) => setFrom(e.target.value)}
+                        className="w-full bg-gray-800 border border-gray-700 rounded-xl px-4 py-3 text-white focus:border-purple-500 focus:outline-none"
+                    >
+                        {agents.map(agent => (
+                            <option key={agent} value={agent}>{agent}</option>
+                        ))}
+                    </select>
+                </div>
+
+                {/* To */}
+                <div>
+                    <label className="block text-gray-400 text-sm mb-2">To:</label>
+                    <input
+                        type="text"
+                        value={to}
+                        onChange={(e) => setTo(e.target.value)}
+                        placeholder="recipient agent ID"
+                        className="w-full bg-gray-800 border border-gray-700 rounded-xl px-4 py-3 text-white placeholder-gray-500 focus:border-purple-500 focus:outline-none"
+                    />
+                </div>
+
+                {/* Subject */}
+                <div>
+                    <label className="block text-gray-400 text-sm mb-2">Subject:</label>
+                    <input
+                        type="text"
+                        value={subject}
+                        onChange={(e) => setSubject(e.target.value)}
+                        placeholder="Message subject"
+                        className="w-full bg-gray-800 border border-gray-700 rounded-xl px-4 py-3 text-white placeholder-gray-500 focus:border-purple-500 focus:outline-none"
+                    />
+                </div>
+
+                {/* Body */}
+                <div>
+                    <label className="block text-gray-400 text-sm mb-2">Message:</label>
+                    <textarea
+                        value={body}
+                        onChange={(e) => setBody(e.target.value)}
+                        rows={10}
+                        placeholder="Write your message..."
+                        className="w-full bg-gray-800 border border-gray-700 rounded-xl px-4 py-3 text-white placeholder-gray-500 focus:border-purple-500 focus:outline-none resize-none"
+                    />
+                </div>
+            </main>
+        </div>
+    );
+}

package/mobile-app/app/globals.css

@@ -0,0 +1,26 @@
+@import "tailwindcss";
+
+:root {
+  --background: #ffffff;
+  --foreground: #171717;
+}
+
+@theme inline {
+  --color-background: var(--background);
+  --color-foreground: var(--foreground);
+  --font-sans: var(--font-geist-sans);
+  --font-mono: var(--font-geist-mono);
+}
+
+@media (prefers-color-scheme: dark) {
+  :root {
+    --background: #0a0a0a;
+    --foreground: #ededed;
+  }
+}
+
+body {
+  background: var(--background);
+  color: var(--foreground);
+  font-family: Arial, Helvetica, sans-serif;
+}

package/mobile-app/app/layout.tsx

@@ -0,0 +1,42 @@
+import type { Metadata, Viewport } from "next";
+import { Geist, Geist_Mono } from "next/font/google";
+import "./globals.css";
+
+const geistSans = Geist({
+  variable: "--font-geist-sans",
+  subsets: ["latin"],
+});
+
+const geistMono = Geist_Mono({
+  variable: "--font-geist-mono",
+  subsets: ["latin"],
+});
+
+export const metadata: Metadata = {
+  title: "🍄 Myceliumail",
+  description: "Mobile messaging for Treebird agents",
+};
+
+export const viewport: Viewport = {
+  width: "device-width",
+  initialScale: 1,
+  maximumScale: 1,
+  userScalable: false,
+  themeColor: "#030712",
+};
+
+export default function RootLayout({
+  children,
+}: Readonly<{
+  children: React.ReactNode;
+}>) {
+  return (
+    <html lang="en">
+      <body
+        className={`${geistSans.variable} ${geistMono.variable} antialiased`}
+      >
+        {children}
+      </body>
+    </html>
+  );
+}