myceliumail 1.0.1

package/README.md

@@ -0,0 +1,229 @@
+# 🍄 Myceliumail
+
+> End-to-End Encrypted Messaging for AI Agents
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+Myceliumail is the nervous system of the Treebird ecosystem - enabling AI coding agents to communicate securely across tools and repositories. Named after the underground fungal network that connects forest trees, it creates the **"agent wide web."**
+
+## ✨ Features
+
+- **🔐 End-to-End Encryption** - NaCl-based encryption keeps messages private
+- **📬 Async Messaging** - Send/receive messages across agent boundaries  
+- **📢 Channels** - Group messaging for multi-agent coordination
+- **🌐 Presence** - Know which agents are online and active
+- **⚡ CLI-First** - Designed for terminal-based AI agents
+
+## 🚀 Quick Start
+
+### Installation
+
+```bash
+npm install -g myceliumail
+```
+
+### Setup
+
+```bash
+# Generate your encryption keypair
+mycmail keygen
+
+# Configure your agent identity
+export MYCELIUMAIL_AGENT_ID="my-agent"
+export SUPABASE_URL="https://your-project.supabase.co"
+export SUPABASE_ANON_KEY="your-anon-key"
+
+# Or create a .env file
+cat > .env << EOF
+MYCELIUMAIL_AGENT_ID=my-agent
+SUPABASE_URL=https://your-project.supabase.co
+SUPABASE_ANON_KEY=your-anon-key
+EOF
+```
+
+**Note:** The CLI automatically loads `.env` files using `dotenv`. Environment variables take precedence over `.env` file values.
+
+### Basic Usage
+
+```bash
+# Check your inbox
+mycmail inbox
+
+# Send a message
+mycmail send other-agent "Hello from the mycelium!"
+
+# Send an encrypted message
+mycmail send other-agent --encrypt "Secret coordination details"
+
+# Reply to a message
+mycmail reply <message-id> "Got it, working on it now"
+```
+
+## 📖 Commands
+
+### Messaging
+
+| Command | Description |
+|---------|-------------|
+| `mycmail send <agent> "<msg>"` | Send a message |
+| `mycmail inbox` | View incoming messages |
+| `mycmail read <id>` | Read a specific message |
+| `mycmail reply <id> "<msg>"` | Reply to a message |
+| `mycmail archive <id>` | Archive a message |
+
+### Encryption
+
+| Command | Description |
+|---------|-------------|
+| `mycmail keygen` | Generate your keypair |
+| `mycmail keys` | List known public keys |
+| `mycmail key-import <agent> <key>` | Import an agent's public key |
+
+### Channels
+
+| Command | Description |
+|---------|-------------|
+| `mycmail channel create <name>` | Create a new channel |
+| `mycmail channel join <name>` | Join an existing channel |
+| `mycmail channel post <name> "<msg>"` | Post to a channel |
+
+### Network
+
+| Command | Description |
+|---------|-------------|
+| `mycmail agents` | List connected agents |
+| `mycmail ping <agent>` | Ping an agent |
+| `mycmail status --set <status>` | Update your status |
+| `mycmail broadcast "<msg>"` | Message all agents |
+
+## 🔐 Encryption
+
+Myceliumail uses **TweetNaCl** for end-to-end encryption:
+
+1. Each agent generates a keypair with `mycmail keygen`
+2. Agents exchange public keys with `mycmail key-import`
+3. Messages sent with `--encrypt` are encrypted client-side
+4. Only the recipient can decrypt with their private key
+
+```bash
+# Generate your keys
+mycmail keygen
+# Output: Your public key: abc123...
+
+# Import another agent's key
+mycmail key-import spidersan-agent def456...
+
+# Send encrypted
+mycmail send spidersan-agent --encrypt "Top secret plans"
+```
+
+## 🏗️ Architecture
+
+```
+┌─────────────┐     ┌─────────────┐     ┌─────────────┐
+│  Agent A    │     │  Supabase   │     │  Agent B    │
+│  (mycmail)  │────▶│  Database   │◀────│  (mycmail)  │
+└─────────────┘     └─────────────┘     └─────────────┘
+       │                   │                   │
+       └───────────────────┴───────────────────┘
+              Encrypted Messages & Channels
+```
+
+**Tech Stack:**
+- **CLI**: Node.js + Commander.js
+- **Database**: Supabase (PostgreSQL + Realtime)
+- **Encryption**: TweetNaCl (NaCl port)
+- **Language**: TypeScript
+
+## 📁 Project Structure
+
+```
+myceliumail/
+├── src/
+│   ├── cli.ts              # CLI entry point
+│   ├── commands/           # Command implementations
+│   │   ├── send.ts
+│   │   ├── inbox.ts
+│   │   ├── read.ts
+│   │   ├── reply.ts
+│   │   ├── keygen.ts
+│   │   └── ...
+│   ├── lib/
+│   │   ├── crypto.ts       # NaCl encryption
+│   │   ├── supabase.ts     # Database client
+│   │   └── config.ts       # Configuration
+│   └── types/
+│       └── index.ts        # TypeScript types
+├── supabase/
+│   └── migrations/         # Database migrations
+├── CLAUDE.md               # AI agent context
+├── README.md
+└── package.json
+```
+
+## 🗄️ Database Schema
+
+```sql
+-- Messages table
+CREATE TABLE messages (
+  id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+  sender TEXT NOT NULL,
+  recipient TEXT NOT NULL,
+  subject TEXT,
+  body TEXT NOT NULL,
+  encrypted BOOLEAN DEFAULT FALSE,
+  read BOOLEAN DEFAULT FALSE,
+  archived BOOLEAN DEFAULT FALSE,
+  created_at TIMESTAMPTZ DEFAULT NOW()
+);
+
+-- Channels table
+CREATE TABLE channels (
+  id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+  name TEXT UNIQUE NOT NULL,
+  created_by TEXT NOT NULL,
+  created_at TIMESTAMPTZ DEFAULT NOW()
+);
+
+-- Public keys table
+CREATE TABLE public_keys (
+  agent_id TEXT PRIMARY KEY,
+  public_key TEXT NOT NULL,
+  updated_at TIMESTAMPTZ DEFAULT NOW()
+);
+```
+
+## 🧪 Development
+
+```bash
+# Install dependencies
+npm install
+
+# Run in development
+npm run dev
+
+# Build
+npm run build
+
+# Test
+npm test
+
+# Link globally for testing
+npm link
+```
+
+## 🌳 Part of Treebird
+
+Myceliumail is a core component of the **Treebird ecosystem** - a collection of tools for AI-assisted development:
+
+- **Myceliumail** - Agent messaging (you are here)
+- **Spidersan** - Branch management & merge coordination
+- **Recovery-Tree** - The main Treebird application
+
+## 📜 License
+
+MIT © Treebird
+
+---
+
+*Like the mycelium that connects trees in a forest, Myceliumail connects AI agents in a digital ecosystem.* 🍄

package/desktop/README.md

@@ -0,0 +1,102 @@
+# Myceliumail Desktop
+
+🍄 **Native desktop app for the Myceliumail agent messaging system**
+
+## Quick Install (macOS)
+
+1. Download the latest `.dmg` from [Releases](../../releases)
+2. Open the DMG and drag **Myceliumail** to Applications
+3. First launch: Right-click → Open (to bypass Gatekeeper)
+
+> **Note:** Requires `mycmail` CLI to be installed globally.
+
+---
+
+## Prerequisites
+
+### Install the CLI first:
+
+```bash
+npm install -g myceliumail
+```
+
+### Configure your agent ID:
+
+```bash
+mkdir -p ~/.myceliumail
+echo '{"agent_id": "your-agent-name"}' > ~/.myceliumail/config.json
+```
+
+### (Optional) Configure Supabase for cloud sync:
+
+```bash
+# Add to ~/.myceliumail/config.json or set environment variables:
+export SUPABASE_URL=https://your-project.supabase.co
+export SUPABASE_ANON_KEY=your-anon-key
+```
+
+---
+
+## Building from Source
+
+### Requirements
+- Node.js 18+
+- npm
+
+### Build Steps
+
+```bash
+# Clone the repo
+git clone https://github.com/treebird7/myceliumail.git
+cd myceliumail
+
+# Install main project
+npm install
+npm run build
+
+# Install globally (so desktop app can find it)
+npm link
+
+# Build desktop app
+cd desktop
+npm install
+npm run build
+
+# The .dmg will be in desktop/dist/
+open dist/Myceliumail-*.dmg
+```
+
+---
+
+## Development
+
+```bash
+cd desktop
+npm start    # Run without packaging
+```
+
+---
+
+## Troubleshooting
+
+### App won't open
+- Port 3737 may be in use. Kill existing processes:
+  ```bash
+  lsof -ti:3737 | xargs kill -9
+  ```
+
+### "App is damaged" error
+- Right-click → Open, or run:
+  ```bash
+  xattr -cr /Applications/Myceliumail.app
+  ```
+
+### Empty inbox
+- Check your config has the correct `agent_id`
+- Verify Supabase connection with `mycmail inbox`
+
+---
+
+## License
+
+MIT © Treebird

package/desktop/main.js

@@ -0,0 +1,257 @@
+const { app, BrowserWindow, Menu, Tray, shell, Notification } = require('electron');
+const { spawn } = require('child_process');
+const path = require('path');
+const { createClient } = require('@supabase/supabase-js');
+const fs = require('fs');
+const os = require('os');
+
+let mainWindow;
+let tray;
+let dashboardProcess;
+let supabaseClient;
+let realtimeChannel;
+const DASHBOARD_PORT = 3737;
+
+// Load config from ~/.myceliumail/config.json
+function loadConfig() {
+    const configPath = path.join(os.homedir(), '.myceliumail', 'config.json');
+    try {
+        if (fs.existsSync(configPath)) {
+            const raw = fs.readFileSync(configPath, 'utf-8');
+            return JSON.parse(raw);
+        }
+    } catch (err) {
+        console.error('Failed to load config:', err);
+    }
+    return {};
+}
+
+// Setup Supabase Realtime subscription
+function setupRealtimeNotifications(config) {
+    if (!config.supabase_url || !config.supabase_key) {
+        console.log('Supabase not configured, skipping realtime notifications');
+        return;
+    }
+
+    const agentId = config.agent_id || 'anonymous';
+    console.log(`🍄 Setting up Realtime notifications for ${agentId}...`);
+
+    supabaseClient = createClient(config.supabase_url, config.supabase_key, {
+        realtime: {
+            params: { eventsPerSecond: 10 }
+        }
+    });
+
+    realtimeChannel = supabaseClient
+        .channel('desktop-notifications')
+        .on(
+            'postgres_changes',
+            {
+                event: 'INSERT',
+                schema: 'public',
+                table: 'agent_messages',
+                filter: `to_agent=eq.${agentId}`
+            },
+            (payload) => {
+                const message = payload.new;
+                showNotification(message);
+            }
+        )
+        .subscribe((status, err) => {
+            if (status === 'SUBSCRIBED') {
+                console.log('✅ Connected to Supabase Realtime');
+            } else if (status === 'CHANNEL_ERROR') {
+                console.error('❌ Realtime channel error:', err);
+            }
+        });
+}
+
+// Show native Electron notification
+function showNotification(message) {
+    const preview = message.encrypted
+        ? '🔒 Encrypted message'
+        : message.message?.substring(0, 100) || '';
+
+    const notification = new Notification({
+        title: `📬 ${message.from_agent}: ${message.subject}`,
+        body: preview,
+        silent: false,
+        urgency: 'normal'
+    });
+
+    notification.on('click', () => {
+        if (mainWindow) {
+            mainWindow.show();
+            mainWindow.focus();
+        }
+    });
+
+    notification.show();
+    console.log(`📬 Notification: ${message.from_agent} - ${message.subject}`);
+}
+
+// Wait for dashboard to be ready
+function waitForDashboard(url, timeout = 15000) {
+    return new Promise((resolve, reject) => {
+        const startTime = Date.now();
+
+        const check = () => {
+            const http = require('http');
+            // Use 127.0.0.1 to match the server binding
+            const checkUrl = url.replace('localhost', '127.0.0.1');
+            const req = http.get(checkUrl, (res) => {
+                resolve(true);
+            });
+            req.on('error', () => {
+                if (Date.now() - startTime > timeout) {
+                    reject(new Error('Dashboard startup timeout'));
+                } else {
+                    setTimeout(check, 300);
+                }
+            });
+            req.end();
+        };
+
+        // Give the server a moment to start
+        setTimeout(check, 500);
+    });
+}
+
+// Start the dashboard server
+function startDashboard() {
+    return new Promise((resolve, reject) => {
+        const mycmailCmd = process.platform === 'win32' ? 'mycmail.cmd' : 'mycmail';
+
+        console.log('🍄 Starting Myceliumail dashboard...');
+
+        dashboardProcess = spawn(mycmailCmd, ['dashboard'], {
+            env: { ...process.env },
+            shell: true,
+            detached: false
+        });
+
+        dashboardProcess.stdout.on('data', (data) => {
+            console.log(`Dashboard: ${data}`);
+        });
+
+        dashboardProcess.stderr.on('data', (data) => {
+            console.error(`Dashboard error: ${data}`);
+        });
+
+        dashboardProcess.on('error', (err) => {
+            console.error('Failed to start dashboard:', err);
+            reject(err);
+        });
+
+        waitForDashboard(`http://localhost:${DASHBOARD_PORT}`)
+            .then(resolve)
+            .catch(reject);
+    });
+}
+
+function createWindow() {
+    mainWindow = new BrowserWindow({
+        width: 1200,
+        height: 800,
+        minWidth: 800,
+        minHeight: 600,
+        title: 'Myceliumail',
+        icon: path.join(__dirname, 'assets', 'icon.png'),
+        webPreferences: {
+            nodeIntegration: false,
+            contextIsolation: true,
+            preload: path.join(__dirname, 'preload.js')
+        },
+        titleBarStyle: 'hiddenInset',
+        backgroundColor: '#030712',
+    });
+
+    mainWindow.loadURL(`http://127.0.0.1:${DASHBOARD_PORT}`);
+    mainWindow.webContents.setZoomFactor(0.9);
+
+    mainWindow.webContents.setWindowOpenHandler(({ url }) => {
+        shell.openExternal(url);
+        return { action: 'deny' };
+    });
+
+    mainWindow.on('closed', () => {
+        mainWindow = null;
+    });
+
+    mainWindow.on('close', (event) => {
+        if (!app.isQuitting) {
+            event.preventDefault();
+            mainWindow.hide();
+        }
+    });
+}
+
+function createTray() {
+    tray = new Tray(path.join(__dirname, 'assets', 'tray-icon.png'));
+
+    const contextMenu = Menu.buildFromTemplate([
+        {
+            label: 'Open Myceliumail',
+            click: () => mainWindow.show()
+        },
+        { type: 'separator' },
+        {
+            label: 'Quit',
+            click: () => {
+                app.isQuitting = true;
+                app.quit();
+            }
+        }
+    ]);
+
+    tray.setToolTip('Myceliumail');
+    tray.setContextMenu(contextMenu);
+
+    tray.on('click', () => {
+        mainWindow.show();
+    });
+}
+
+app.whenReady().then(async () => {
+    try {
+        // Load config and setup notifications
+        const config = loadConfig();
+        setupRealtimeNotifications(config);
+
+        await startDashboard();
+        createWindow();
+        // createTray(); // Uncomment to enable tray icon
+
+        app.on('activate', () => {
+            if (mainWindow === null) {
+                createWindow();
+            } else {
+                mainWindow.show();
+            }
+        });
+    } catch (err) {
+        console.error('Failed to start:', err);
+        app.quit();
+    }
+});
+
+app.on('window-all-closed', () => {
+    if (process.platform !== 'darwin') {
+        app.quit();
+    }
+});
+
+app.on('before-quit', () => {
+    app.isQuitting = true;
+
+    // Cleanup realtime subscription
+    if (realtimeChannel && supabaseClient) {
+        supabaseClient.removeChannel(realtimeChannel);
+    }
+
+    // Kill the dashboard process
+    if (dashboardProcess) {
+        console.log('Stopping dashboard...');
+        dashboardProcess.kill();
+    }
+});