let-them-talk 3.3.2 → 3.3.3

package/CHANGELOG.md

@@ -1,6 +1,6 @@
 # Changelog
 
-## [3.3.1] - 2026-03-14
+## [3.3.2] - 2026-03-14
 
 ### Changed
 - License changed from MIT to Business Source License 1.1 (BSL)

package/LICENSE

@@ -6,7 +6,7 @@ License text copyright (c) 2017 MariaDB Corporation Ab, All Rights Reserved.
 Parameters
 
 Licensor:             Dekelelz
-Licensed Work:        Let Them Talk v3.3.1
+Licensed Work:        Let Them Talk v3.3.3
                       The Licensed Work is (c) 2024-2026 Dekelelz.
 Additional Use Grant: You may make use of the Licensed Work, provided that
                       you may not use the Licensed Work for a Commercial
@@ -27,7 +27,7 @@ Change Date:          2028-03-14
 Change License:       Apache License, Version 2.0
 
 For information about alternative licensing arrangements for the Licensed Work,
-please contact: dekelelz@gmail.com
+please contact: contact@talk.unrealai.studio
 
 Notice
 

package/README.md

@@ -1,63 +1,148 @@
-# Let Them Talk
+<p align="center">
+  <img src="agent-bridge/logo.png" alt="Let Them Talk" width="120">
+</p>
 
-[![npm version](https://img.shields.io/npm/v/let-them-talk.svg)](https://www.npmjs.com/package/let-them-talk)
-[![License: BSL 1.1](https://img.shields.io/badge/License-BSL%201.1-orange.svg)](https://github.com/Dekelelz/let-them-talk/blob/master/LICENSE)
-[![Discord](https://img.shields.io/discord/1482478651000885359?color=5865F2&label=Discord&logo=discord&logoColor=white)](https://discord.gg/6Y9YgkFNJP)
+<h1 align="center">Let Them Talk</h1>
 
-**MCP server + web dashboard that lets AI CLI agents talk to each other.**
+<p align="center">
+  <strong>Multi-agent collaboration for AI CLI terminals.</strong><br>
+  Let your AI agents talk, delegate, review, and build together.
+</p>
 
-Open two (or more) Claude Code, Gemini CLI, or Codex CLI terminals — and let them collaborate, debate, review code, or divide tasks. Watch the conversation unfold in a real-time web dashboard with a kanban board, agent monitoring, and message injection.
+<p align="center">
+  <a href="https://www.npmjs.com/package/let-them-talk"><img src="https://img.shields.io/npm/v/let-them-talk.svg?style=flat&color=58a6ff" alt="npm"></a>
+  <a href="https://github.com/Dekelelz/let-them-talk/blob/master/LICENSE"><img src="https://img.shields.io/badge/License-BSL%201.1-f59e0b.svg?style=flat" alt="BSL 1.1"></a>
+  <a href="https://discord.gg/6Y9YgkFNJP"><img src="https://img.shields.io/discord/1482478651000885359?color=5865F2&label=Discord&logo=discord&logoColor=white&style=flat" alt="Discord"></a>
+  <a href="https://www.npmjs.com/package/let-them-talk"><img src="https://img.shields.io/npm/dm/let-them-talk.svg?style=flat&color=3fb950" alt="Downloads"></a>
+</p>
 
-## Quick Start
+<p align="center">
+  <a href="https://talk.unrealai.studio">Website</a> ·
+  <a href="#quick-start">Quick Start</a> ·
+  <a href="VISION.md">Vision</a> ·
+  <a href="#agent-templates">Templates</a> ·
+  <a href="#web-dashboard">Dashboard</a> ·
+  <a href="https://discord.gg/6Y9YgkFNJP">Discord</a>
+</p>
 
-```bash
-# 1. Install in any project
-npx let-them-talk init
+---
 
-# 2. Launch the web dashboard
-npx let-them-talk dashboard
+Let Them Talk is an MCP server that connects multiple AI CLI terminals through a shared filesystem. Open Claude Code, Gemini CLI, or Codex CLI in separate terminals — they discover each other, exchange messages, share files, assign tasks, and coordinate through workflows. A real-time web dashboard lets you watch everything unfold, inject messages, and manage the conversation.
 
-# 3. In Terminal 1: tell the agent to register as "A", say hello, then call listen()
-# 4. In Terminal 2: tell the agent to register as "B", then call listen()
-```
+If you want your AI agents to stop working in isolation and start collaborating like a team, this is it.
 
-Or use a template for guided setup:
+## Quick Start
+
+Preferred setup: one command to install, one to launch the dashboard.
 
 ```bash
-npx let-them-talk init --template team    # Coordinator + Researcher + Coder
-npx let-them-talk init --template review  # Author + Reviewer
-npx let-them-talk init --template debate  # Pro + Con
-npx let-them-talk templates               # List all templates
+npx let-them-talk init        # auto-detects your CLI and configures MCP
+npx let-them-talk dashboard   # opens the web dashboard at localhost:3000
 ```
 
+Then open two terminals and tell each agent to register:
+
+**Terminal 1:** `Register as "A", say hello to B, then call listen()`
+
+**Terminal 2:** `Register as "B", then call listen()`
+
+That's it. They'll start talking. Watch it live in the dashboard.
+
+> **Templates:** Skip the manual setup with `npx let-them-talk init --template team` — gives you ready-to-paste prompts for a Coordinator + Researcher + Coder team. [See all templates](#agent-templates).
+
+## Supported CLIs
+
+| CLI | Config File | Auto-detected |
+|-----|-------------|:-------------:|
+| Claude Code | `.mcp.json` | Yes |
+| Gemini CLI | `.gemini/settings.json` | Yes |
+| Codex CLI | `.codex/config.toml` | Yes |
+
+Run `npx let-them-talk init --all` to configure all three at once.
+
 ## How It Works
 
 ```
-Terminal 1 (Claude Code)          Terminal 2 (Gemini CLI)          Terminal 3 (Codex CLI)
-        |                                 |                                |
-        v                                 v                                v
-   MCP Server                        MCP Server                      MCP Server
-   (stdio process)                   (stdio process)                 (stdio process)
-        |                                 |                                |
-        +------------- Shared Filesystem (.agent-bridge/) ----------------+
-                       |  messages.jsonl  |  history.jsonl  |
-                       |  agents.json     |  tasks.json     |
-                       |  profiles.json   |  workflows.json |
-                       |  workspaces/     |  plugins/       |
-                                    |
-                                    v
-                        Web Dashboard (localhost:3000)
-                        Real-time SSE + Agent monitoring
-                        Tasks + Workspaces + Workflows + Plugins
+  Terminal 1              Terminal 2              Terminal 3
+  (Claude Code)           (Gemini CLI)            (Codex CLI)
+       |                       |                       |
+       v                       v                       v
+  MCP Server              MCP Server              MCP Server
+  (stdio)                 (stdio)                 (stdio)
+       |                       |                       |
+       +----------- .agent-bridge/ directory ----------+
+                    messages · agents · tasks
+                    profiles · workflows · plugins
+                              |
+                              v
+                    Web Dashboard :3000
+                    SSE real-time · Kanban
+                    Agent monitoring · Injection
 ```
 
-Each CLI terminal spawns its own MCP server process via stdio. All processes read/write to a shared `.agent-bridge/` directory. The dashboard monitors the same files via Server-Sent Events for real-time updates.
+Each terminal spawns its own MCP server process. All processes share a `.agent-bridge/` directory in your project root. The dashboard reads the same files via Server-Sent Events for instant updates.
 
-## Features
+## Highlights
 
-### 27 MCP Tools + Plugins
+- **27 MCP tools** — messaging, tasks, workflows, profiles, workspaces, branching, plugins
+- **Real-time dashboard** — SSE-powered (~200ms latency), markdown rendering, dark/light theme
+- **Multi-agent** — 2 agents auto-route, 3+ agents specify recipients, broadcast to all
+- **Task management** — kanban board with create/assign/track between agents
+- **Workflow pipelines** — multi-step automation with auto-handoff
+- **Agent profiles** — display names, SVG avatars, roles, bios
+- **Conversation branching** — fork at any point, isolated history per branch
+- **File sharing** — send code, diffs, and results directly between agents
+- **Plugin system** — extend with custom tools, 30s sandboxed execution
+- **Zero config** — one `npx` command, auto-detects your CLI, works immediately
 
-**Messaging**
+## Agent Templates
+
+Pre-built team configurations. Each template gives you ready-to-paste prompts for every terminal.
+
+```bash
+npx let-them-talk init --template pair     # A + B
+npx let-them-talk init --template team     # Coordinator + Researcher + Coder
+npx let-them-talk init --template review   # Author + Reviewer
+npx let-them-talk init --template debate   # Pro + Con
+npx let-them-talk templates                # List all available templates
+```
+
+| Template | Agents | Best For |
+|----------|--------|----------|
+| **pair** | A, B | Brainstorming, Q&A, simple conversations |
+| **team** | Coordinator, Researcher, Coder | Complex features needing research + implementation |
+| **review** | Author, Reviewer | Code review with structured feedback loops |
+| **debate** | Pro, Con | Evaluating trade-offs, architecture decisions |
+
+## Web Dashboard
+
+Launch with `npx let-them-talk dashboard` — opens at `http://localhost:3000`.
+
+**4 main tabs:**
+
+- **Messages** — live feed with full markdown, message grouping, search, bookmarks, pins, emoji reactions, conversation replay
+- **Tasks** — kanban board (pending / in progress / done / blocked), update status from dashboard
+- **Workspaces** — per-agent key-value storage browser
+- **Workflows** — horizontal pipeline visualization, advance or skip steps
+
+**Plus:**
+
+- Agent monitoring with active / sleeping / dead / listening status
+- Profile popups with avatars and role badges
+- Activity heatmap and per-agent stats
+- Message injection and broadcast from browser
+- Conversation branching with branch tabs
+- Export as shareable HTML or Markdown
+- Multi-project support with auto-discover
+- Dark / light theme toggle
+- Mobile responsive with hamburger sidebar
+- Browser notifications and sound alerts
+- LAN mode for phone access
+
+## MCP Tools (27 + plugins)
+
+<details>
+<summary><strong>Messaging (13 tools)</strong></summary>
 
 | Tool | Description |
 |------|-------------|
@@ -71,112 +156,54 @@ Each CLI terminal spawns its own MCP server process via stdio. All processes rea
 | `ack_message` | Confirm message was processed |
 | `get_history` | View conversation with thread/branch filter |
 | `get_summary` | Condensed conversation recap |
-| `handoff` | Transfer work to another agent with context |
-| `share_file` | Send file contents to another agent |
-| `reset` | Clear data (auto-archives first) |
+| `handoff` | Transfer work with context |
+| `share_file` | Send file contents (max 100KB) |
+| `reset` | Clear all data (auto-archives first) |
+
+</details>
 
-**Tasks & Workflows**
+<details>
+<summary><strong>Tasks & Workflows (6 tools)</strong></summary>
 
 | Tool | Description |
 |------|-------------|
 | `create_task` | Create and assign tasks |
-| `update_task` | Update task status (pending/in_progress/done/blocked) |
+| `update_task` | Update status: pending / in_progress / done / blocked |
 | `list_tasks` | View tasks with filters |
 | `create_workflow` | Create multi-step pipeline with assignees |
 | `advance_workflow` | Complete current step, auto-handoff to next |
-| `workflow_status` | Get workflow progress |
+| `workflow_status` | Get workflow progress percentage |
+
+</details>
 
-**Profiles & Workspaces**
+<details>
+<summary><strong>Profiles & Workspaces (4 tools)</strong></summary>
 
 | Tool | Description |
 |------|-------------|
 | `update_profile` | Set display name, avatar, bio, role |
-| `workspace_write` | Write to your key-value workspace (50 keys, 100KB/value) |
-| `workspace_read` | Read workspace entries (yours or another agent's) |
+| `workspace_write` | Write key-value data (50 keys, 100KB/value) |
+| `workspace_read` | Read your workspace or another agent's |
 | `workspace_list` | List workspace keys |
 
-**Conversation Branching**
+</details>
+
+<details>
+<summary><strong>Branching (3 tools)</strong></summary>
 
 | Tool | Description |
 |------|-------------|
-| `fork_conversation` | Fork conversation at any message point |
+| `fork_conversation` | Fork at any message point |
 | `switch_branch` | Switch to a different branch |
 | `list_branches` | List all branches with message counts |
 
-### Web Dashboard (4 tabs)
-
-- **Messages** — SSE-powered real-time feed, full markdown, message grouping, date separators, bookmarks, pins, emoji reactions, search, conversation replay
-- **Tasks** — Kanban board (pending/in_progress/done/blocked), status updates from dashboard
-- **Workspaces** — Per-agent key-value browser with collapsible accordion UI
-- **Workflows** — Horizontal pipeline visualization, advance/skip steps from dashboard
-- **Agent monitoring** — active/sleeping/dead/listening status, profile popups with avatars, provider badges, activity heatmap
-- **Conversation branching** — branch tabs, switch between conversation forks
-- **Message injection** — send messages or broadcast to agents from the browser
-- **Plugin management** — plugin cards with enable/disable toggles
-- **Export** — shareable HTML or Markdown download
-- **Multi-project** — monitor multiple folders + auto-discover
-- **Dark/light theme** — toggle with localStorage persistence
-- **Mobile responsive** — hamburger sidebar, works on phones and tablets
-
-### Reliability
-
-- **Heartbeat** — 10s pings track agent liveness
-- **Auto-compact** — message queue cleaned when > 500 lines
-- **Auto-archive** — conversations saved before reset
-- **Context hints** — warns agents when conversation gets long
-- **Dead recipient warnings** — alerts when sending to offline agents
-- **Clean exit** — agents deregister on process exit
-
-## Agent Templates
-
-Pre-built team configurations with ready-to-paste prompts:
-
-| Template | Agents | Best For |
-|----------|--------|----------|
-| `pair` | A, B | Simple conversations, brainstorming |
-| `team` | Coordinator, Researcher, Coder | Complex features, research + implementation |
-| `review` | Author, Reviewer | Code review with structured feedback |
-| `debate` | Pro, Con | Evaluating trade-offs and decisions |
-
-## CLI Commands
-
-```bash
-npx let-them-talk init                    # Auto-detect CLI and configure
-npx let-them-talk init --all              # Configure for all CLIs
-npx let-them-talk init --template <name>  # Use a team template
-npx let-them-talk templates               # List available templates
-npx let-them-talk dashboard               # Launch web dashboard
-npx let-them-talk reset                   # Clear conversation data
-npx let-them-talk plugin list             # List installed plugins
-npx let-them-talk plugin add <file.js>    # Install a plugin
-npx let-them-talk plugin remove <name>    # Remove a plugin
-npx let-them-talk plugin enable <name>    # Enable a plugin
-npx let-them-talk plugin disable <name>   # Disable a plugin
-npx let-them-talk help                    # Show help
-```
-
-## Updating
-
-```bash
-# If using npx (recommended) — clear cache to get latest version
-npx clear-npx-cache
-npx let-them-talk init    # Re-run to update MCP config paths
-
-# If installed globally
-npm update -g let-them-talk
-
-# Check your version
-npx let-them-talk help    # Shows version in header
-```
-
-After updating, restart your CLI terminals to pick up the new MCP server.
+</details>
 
 ## Plugins
 
-Extend Let Them Talk with custom tools. Plugins are `.js` files in the `.agent-bridge/plugins/` directory.
+Extend Let Them Talk with custom tools. Drop a `.js` file in `.agent-bridge/plugins/`.
 
 ```javascript
-// plugins/my-tool.js
 module.exports = {
   name: 'my-tool',
   description: 'What this tool does',
@@ -188,21 +215,56 @@ module.exports = {
     required: ['query']
   },
   handler(args, ctx) {
-    // ctx provides: sendMessage, getAgents, getHistory, readFile, registeredName, dataDir
+    // ctx: sendMessage, getAgents, getHistory, readFile, registeredName, dataDir
     return { result: 'done', query: args.query };
   }
 };
 ```
 
-Plugins run sandboxed with a 30-second timeout. Manage them via CLI or the dashboard.
+```bash
+npx let-them-talk plugin add my-tool.js    # install
+npx let-them-talk plugin list              # list installed
+npx let-them-talk plugin remove my-tool    # remove
+npx let-them-talk plugin enable my-tool    # enable
+npx let-them-talk plugin disable my-tool   # disable
+```
+
+Plugins run sandboxed with a 30-second timeout. Manage via CLI or dashboard.
 
-## Supported CLIs
+## CLI Reference
 
-| CLI | Config | Auto-detected |
-|-----|--------|---------------|
-| Claude Code | `.mcp.json` | Yes |
-| Gemini CLI | `.gemini/settings.json` | Yes |
-| Codex CLI | `.mcp.json` | Yes |
+```bash
+npx let-them-talk init                     # auto-detect CLI, configure MCP
+npx let-them-talk init --all               # configure all CLIs
+npx let-them-talk init --template <name>   # use a team template
+npx let-them-talk templates                # list templates
+npx let-them-talk dashboard                # launch web dashboard
+npx let-them-talk reset                    # clear conversation data
+npx let-them-talk plugin <subcommand>      # manage plugins
+npx let-them-talk help                     # show help
+```
+
+## Updating
+
+```bash
+npx clear-npx-cache                        # clear cached version
+npx let-them-talk init                     # re-run to update config
+npx let-them-talk help                     # verify version
+```
+
+After updating, restart your CLI terminals to pick up the new MCP server.
+
+## Security
+
+Let Them Talk is a **local message broker**. It passes text messages between CLI terminals via shared files on your machine. It does **not** give agents any capabilities beyond what they already have.
+
+**Does not:** access the internet, store API keys, run cloud services, or grant new filesystem access.
+
+**Built-in protections:** CORS restriction, XSS prevention, path traversal protection, symlink validation, origin enforcement, SSE connection limits, input validation, message size limits (1MB), plugin sandboxing (30s timeout).
+
+**LAN mode:** Optional phone access exposes the dashboard to your local WiFi only. Requires explicit activation.
+
+Full details: [SECURITY.md](SECURITY.md)
 
 ## Environment Variables
 
@@ -210,34 +272,27 @@ Plugins run sandboxed with a 30-second timeout. Manage them via CLI or the dashb
 |----------|---------|-------------|
 | `AGENT_BRIDGE_DATA_DIR` | `{cwd}/.agent-bridge/` | Data directory path |
 | `AGENT_BRIDGE_PORT` | `3000` | Dashboard port |
+| `AGENT_BRIDGE_LAN` | `false` | Enable LAN mode |
 | `NODE_ENV` | — | Set to `development` for hot-reload |
 
-## Security
-
-Let Them Talk is a **local message broker** — it passes text messages between CLI terminals via shared files. It does **not** give agents any new capabilities beyond what they already have.
-
-### What it does NOT do
-- Does not give agents filesystem access (they already have it via their CLI)
-- Does not expose anything to the internet (dashboard binds to localhost only)
-- Does not store or transmit API keys
-- Does not run any cloud services
+## Contributing
 
-### Built-in protections
-- **CSRF protection** — external websites cannot send requests to the dashboard
-- **XSS prevention** — all inputs are escaped before rendering
-- **Path traversal protection** — agents cannot read files outside the project directory
-- **Symlink protection** — follows symlinks and validates the real path
-- **Origin enforcement** — POST/DELETE requests require valid localhost/LAN origin
-- **SSE connection limits** — prevents connection exhaustion DoS
-- **Forced sender identity** — dashboard messages are always marked as "Dashboard"
-- **Input validation** — branch names, agent names, and paths are validated
+See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
 
-### LAN mode
-LAN mode (phone access) only exposes the dashboard to your local WiFi network, not the internet. It requires explicit activation and a firewall rule. A warning is shown when enabled.
+## Contact
 
-### Plugins
-Plugins run with full Node.js access. Only install plugins you trust. This is the same trust model as npm packages.
+For business inquiries, licensing, and partnerships: **contact@talk.unrealai.studio**
 
 ## License
 
 [Business Source License 1.1](LICENSE) — Free to use, self-host, and modify. Cannot be offered as a competing commercial hosted service. Converts to Apache 2.0 on March 14, 2028.
+
+---
+
+<p align="center">
+  Built by <a href="https://github.com/Dekelelz">Dekelelz</a> ·
+  <a href="https://talk.unrealai.studio">Website</a> ·
+  <a href="https://discord.gg/6Y9YgkFNJP">Discord</a> ·
+  <a href="https://www.npmjs.com/package/let-them-talk">npm</a> ·
+  <a href="mailto:contact@talk.unrealai.studio">Contact</a>
+</p>

package/SECURITY.md

@@ -14,7 +14,7 @@ If you discover a security vulnerability in Let Them Talk, please report it resp
 
 **Do NOT open a public GitHub issue for security vulnerabilities.**
 
-Instead, please email **security@dos-technology.com** or use [GitHub's private vulnerability reporting](https://github.com/Dekelelz/let-them-talk/security/advisories/new).
+Instead, please email **contact@talk.unrealai.studio** or use [GitHub's private vulnerability reporting](https://github.com/Dekelelz/let-them-talk/security/advisories/new).
 
 ### What to include
 

package/cli.js

@@ -8,7 +8,7 @@ const command = process.argv[2];
 
 function printUsage() {
   console.log(`
-  Let Them Talk — Agent Bridge v3.3.1
+  Let Them Talk — Agent Bridge v3.3.3
   MCP message broker for inter-agent communication
   Supports: Claude Code, Gemini CLI, Codex CLI
 

package/dashboard.html

@@ -1737,9 +1737,11 @@
   }
 
   /* ===== RESPONSIVE ===== */
+  /* ===== MOBILE: TABLET (768px) ===== */
   @media (max-width: 768px) {
     :root {
-      --sidebar-w: 260px;
+      --sidebar-w: 280px;
+      --header-h: 50px;
     }
 
     .mobile-toggle { display: block; }
@@ -1752,6 +1754,7 @@
       z-index: 90;
       transform: translateX(-100%);
       box-shadow: 4px 0 20px rgba(0,0,0,0.3);
+      transition: transform 0.25s ease;
     }
 
     .sidebar.open { transform: translateX(0); }
@@ -1769,19 +1772,143 @@
 
     .header-stats { display: none; }
 
+    /* Header: compact layout */
+    .header { padding: 0 10px; gap: 6px; }
+    .header-left { gap: 8px; }
+    .header-actions { gap: 4px; }
+
+    /* Hide non-essential header buttons on mobile */
+    .header-actions .connection { display: none; }
+    .header-actions .btn { display: none; }
+    .header-actions .phone-btn,
+    .header-actions .theme-toggle,
+    .header-actions .notif-toggle { display: inline-flex; }
+    .header-actions .sound-toggle { display: none; }
+
+    /* Show mobile project selector in header */
+    #mobile-project-name { display: none !important; }
+    .mobile-project-select {
+      display: inline-block !important;
+      background: var(--surface-2);
+      color: var(--orange);
+      border: 1px solid var(--orange-dim);
+      border-radius: 8px;
+      padding: 3px 6px;
+      font-size: 11px;
+      font-weight: 600;
+      max-width: 140px;
+      cursor: pointer;
+      outline: none;
+    }
+    .mobile-project-select:focus { border-color: var(--orange); }
+
+    /* Messages: better mobile spacing */
+    .messages-area { padding: 8px; gap: 1px; }
+    .message { padding: 8px 10px; gap: 8px; }
+    .msg-avatar { width: 28px; height: 28px; font-size: 11px; }
+    .msg-from { font-size: 12px; }
+    .msg-content { font-size: 13px; line-height: 1.5; }
+    .msg-time { font-size: 9px; }
+
+    /* Message actions: always visible on mobile (no hover) */
+    .message .msg-actions { display: flex; opacity: 0.4; }
+    .message .msg-actions .msg-action-btn { opacity: 1; padding: 4px 6px; font-size: 14px; }
+
+    /* Input bar: stack vertically */
     .msg-input-bar {
-      flex-wrap: wrap;
+      flex-direction: column;
+      padding: 8px 10px;
+      gap: 6px;
+    }
+    .input-target {
+      flex-direction: row;
+      align-items: center;
+      min-width: unset;
+    }
+    .input-target label { display: none; }
+    .input-target select { flex: 1; padding: 8px 10px; font-size: 13px; }
+    .input-msg label { display: none; }
+    .input-msg textarea { padding: 10px; font-size: 14px; min-height: 40px; }
+    .send-btn { padding: 10px 16px; font-size: 13px; align-self: flex-end; }
+
+    /* View tabs: scrollable on mobile */
+    .view-tabs {
+      overflow-x: auto;
+      -webkit-overflow-scrolling: touch;
+      scrollbar-width: none;
+      flex-wrap: nowrap;
     }
+    .view-tabs::-webkit-scrollbar { display: none; }
+    .view-tab { white-space: nowrap; flex-shrink: 0; flex: none; padding: 8px 14px; font-size: 12px; }
 
-    .input-target { min-width: 80px; }
+    /* Search bar */
+    .search-input { font-size: 14px; padding: 8px 10px; }
 
-    .messages-area { padding: 12px; }
+    /* Phone modal: full-width on mobile */
+    .phone-modal { width: 95vw; max-width: 95vw; }
+
+    /* Scroll-to-bottom button: bigger touch target */
+    .scroll-bottom { width: 44px; height: 44px; font-size: 18px; bottom: 80px; }
   }
 
+  /* ===== MOBILE: PHONE (480px) ===== */
   @media (max-width: 480px) {
-    .header { padding: 0 12px; }
-    .logo { font-size: 15px; }
-    .msg-input-bar { padding: 10px 12px; }
+    :root {
+      --header-h: 46px;
+    }
+
+    .header { padding: 0 8px; }
+    .logo { font-size: 14px; }
+    .header-left { gap: 6px; }
+
+    /* Compact header buttons */
+    .header-actions { gap: 2px; }
+    .phone-btn { padding: 4px 6px; font-size: 13px; }
+    .theme-toggle, .notif-toggle { font-size: 16px; padding: 4px; }
+
+    /* Mobile project select: compact */
+    .mobile-project-select { font-size: 10px; padding: 2px 4px; max-width: 110px; }
+
+    /* Messages: tighter for small screens */
+    .messages-area { padding: 6px; }
+    .message { padding: 6px 8px; gap: 6px; border-radius: 6px; }
+    .msg-avatar { width: 24px; height: 24px; font-size: 10px; }
+    .msg-header { gap: 4px; }
+    .msg-from { font-size: 11px; }
+    .msg-to { font-size: 11px; }
+    .msg-content { font-size: 12px; }
+    .msg-content pre { font-size: 11px; padding: 8px; }
+    .msg-content code { font-size: 11px; }
+
+    /* Reactions: smaller */
+    .reaction-chip { font-size: 11px; padding: 1px 5px; }
+
+    /* Input bar: full-width, compact */
+    .msg-input-bar { padding: 6px 8px; gap: 4px; }
+    .input-target select { padding: 7px 8px; font-size: 12px; }
+    .input-msg textarea { padding: 8px; font-size: 13px; }
+    .send-btn { padding: 8px 14px; font-size: 12px; }
+
+    /* Sidebar: full-width on very small phones */
+    .sidebar { width: 100vw; }
+
+    /* Thread items */
+    .thread-item { padding: 6px 8px; font-size: 11px; }
+
+    /* Pinned messages */
+    .pinned-section .message { padding: 4px 10px; }
+    .pinned-section .msg-content { font-size: 11px; }
+
+    /* View tabs */
+    .view-tab { padding: 7px 12px; font-size: 11px; }
+  }
+
+  /* ===== MOBILE: VERY SMALL PHONE (360px) ===== */
+  @media (max-width: 360px) {
+    .logo { font-size: 13px; }
+    .mobile-project-select { max-width: 80px; font-size: 9px; }
+    .msg-avatar { display: none; }
+    .message { gap: 0; }
   }
 
   /* ===== v3.0: PROFILE AVATAR ===== */
@@ -2308,7 +2435,10 @@
     <button class="mobile-toggle" onclick="toggleSidebar()" aria-label="Menu">&#9776;</button>
     <img src="data:image/svg+xml,<svg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 100 100'><rect rx='20' width='100' height='100' fill='%230d1117'/><path d='M20 30 Q20 20 30 20 H70 Q80 20 80 30 V55 Q80 65 70 65 H55 L40 80 V65 H30 Q20 65 20 55Z' fill='%2358a6ff'/><circle cx='38' cy='42' r='5' fill='%230d1117'/><circle cx='55' cy='42' r='5' fill='%230d1117'/></svg>" alt="" style="height:28px;margin-right:4px;vertical-align:middle">
     <div class="logo">Let Them Talk</div>
-    <span id="mobile-project-name" style="display:none;font-size:11px;color:var(--orange);font-weight:600;background:var(--orange-dim);padding:2px 8px;border-radius:10px"></span>
+    <span id="mobile-project-name" style="display:none;font-size:11px;color:var(--orange);font-weight:600;background:var(--orange-dim);padding:2px 8px;border-radius:10px" onclick="toggleSidebar()"></span>
+    <select id="mobile-project-select" class="mobile-project-select" onchange="mobileSelectProject(this.value)" style="display:none">
+      <option value="">Select project...</option>
+    </select>
     <div class="header-stats">
       <div class="h-stat"><span class="h-stat-val" id="stat-messages">0</span> msgs</div>
       <div class="h-stat"><span class="h-stat-val" id="stat-agents">0</span> agents</div>
@@ -2472,7 +2602,7 @@
   </div>
 </div>
 <div class="app-footer">
-  <span>Let Them Talk v3.3.1</span>
+  <span>Let Them Talk v3.3.3</span>
 </div>
 <div class="profile-popup" id="profile-popup" onclick="event.stopPropagation()">
   <div class="profile-popup-header">
@@ -2531,6 +2661,8 @@ var activeThread = null;
 var activeProject = ''; // empty = default/local
 var cachedHistory = [];
 var cachedAgents = {};
+var isMobile = window.innerWidth <= 768 || /Mobi|Android|iPhone|iPad/i.test(navigator.userAgent);
+window.addEventListener('resize', function() { isMobile = window.innerWidth <= 768; });
 
 // Agent color palette
 var COLORS = [
@@ -2970,20 +3102,32 @@ function renderThreads(messages) {
 function renderMessages(messages) {
   var el = document.getElementById('messages');
 
+
   if (!messages.length) {
-    el.innerHTML = '<div class="empty-state">' +
-      '<div class="empty-icon">&#x1f4ac;</div>' +
-      '<div class="empty-text">No messages yet</div>' +
-      '<div class="empty-sub">Get two AI agents talking in minutes</div>' +
-      '<div class="onboard-steps">' +
-        '<div class="onboard-step"><span class="onboard-num">1</span><span>Open two terminals and run <code>claude</code> in each</span></div>' +
-        '<div class="onboard-step"><span class="onboard-num">2</span><span>Paste this in Terminal 1:</span></div>' +
-        '<div class="copy-block" onclick="copyText(this)" data-text="You are Agent A. Register as &quot;A&quot;. Say hello to Agent B, then call listen()."><span class="copy-hint">click to copy</span>You are Agent A. Register as "A". Say hello to Agent B, then call listen().</div>' +
-        '<div class="onboard-step"><span class="onboard-num">3</span><span>Paste this in Terminal 2:</span></div>' +
-        '<div class="copy-block" onclick="copyText(this)" data-text="You are Agent B. Register as &quot;B&quot;. Call listen() to wait for messages. When you receive one, respond, then listen() again."><span class="copy-hint">click to copy</span>You are Agent B. Register as "B". Call listen() to wait for messages. When you receive one, respond, then listen() again.</div>' +
-        '<div class="onboard-step"><span class="onboard-num">4</span><span>Watch them talk here in real time!</span></div>' +
-      '</div>' +
-    '</div>';
+    if (isMobile) {
+      var mobileHint = !activeProject
+        ? '<div class="empty-sub">Select a project above to see agent conversations</div>'
+        : '<div class="empty-sub">Waiting for messages in: ' + activeProject.split(/[/\\]/).pop() + '</div>';
+      el.innerHTML = '<div class="empty-state">' +
+        '<div class="empty-icon">&#x1f4ac;</div>' +
+        '<div class="empty-text">No messages yet</div>' +
+        mobileHint +
+      '</div>';
+    } else {
+      el.innerHTML = '<div class="empty-state">' +
+        '<div class="empty-icon">&#x1f4ac;</div>' +
+        '<div class="empty-text">No messages yet</div>' +
+        '<div class="empty-sub">Get two AI agents talking in minutes</div>' +
+        '<div class="onboard-steps">' +
+          '<div class="onboard-step"><span class="onboard-num">1</span><span>Open two terminals and run <code>claude</code> in each</span></div>' +
+          '<div class="onboard-step"><span class="onboard-num">2</span><span>Paste this in Terminal 1:</span></div>' +
+          '<div class="copy-block" onclick="copyText(this)" data-text="You are Agent A. Register as &quot;A&quot;. Say hello to Agent B, then call listen()."><span class="copy-hint">click to copy</span>You are Agent A. Register as "A". Say hello to Agent B, then call listen().</div>' +
+          '<div class="onboard-step"><span class="onboard-num">3</span><span>Paste this in Terminal 2:</span></div>' +
+          '<div class="copy-block" onclick="copyText(this)" data-text="You are Agent B. Register as &quot;B&quot;. Call listen() to wait for messages. When you receive one, respond, then listen() again."><span class="copy-hint">click to copy</span>You are Agent B. Register as "B". Call listen() to wait for messages. When you receive one, respond, then listen() again.</div>' +
+          '<div class="onboard-step"><span class="onboard-num">4</span><span>Watch them talk here in real time!</span></div>' +
+        '</div>' +
+      '</div>';
+    }
     return;
   }
 
@@ -3142,6 +3286,7 @@ function filterThread(tid) {
   lastMessageCount = 0;
   renderThreads(cachedHistory);
   renderMessages(cachedHistory);
+  if (isMobile) closeSidebar();
 }
 
 function clearThreadFilter() {
@@ -3156,6 +3301,11 @@ function toggleSidebar() {
   document.getElementById('sidebar-overlay').classList.toggle('open');
 }
 
+function closeSidebar() {
+  document.getElementById('sidebar').classList.remove('open');
+  document.getElementById('sidebar-overlay').classList.remove('open');
+}
+
 var newWhileScrolled = 0;
 
 document.getElementById('messages').addEventListener('scroll', function() {
@@ -3611,6 +3761,8 @@ function switchView(view) {
   if (view === 'workspaces') fetchWorkspaces();
   if (view === 'workflows') fetchWorkflows();
   if (view === 'launch') renderLaunchPanel();
+  // Auto-close sidebar on mobile after view switch
+  if (isMobile) closeSidebar();
 }
 
 // ==================== TASKS ====================
@@ -4172,9 +4324,21 @@ function loadProjects() {
       sel.appendChild(opt);
     }
 
-    // Auto-select: if only one project and nothing selected, use it
-    if (!activeProject && projects.length === 1) {
+    // Auto-select first project if none selected
+    if (!activeProject && projects.length > 0) {
       activeProject = projects[0].path;
+      console.log('[LTT] auto-selected first project:', activeProject);
+    }
+
+    // If project came from URL param, try fuzzy match (handles path separator differences)
+    if (activeProject && sel.value !== activeProject) {
+      var normalizedActive = activeProject.replace(/\\/g, '/').toLowerCase();
+      for (var j = 0; j < projects.length; j++) {
+        if (projects[j].path.replace(/\\/g, '/').toLowerCase() === normalizedActive) {
+          activeProject = projects[j].path; // use server's canonical path
+          break;
+        }
+      }
     }
 
     if (activeProject) {
@@ -4187,21 +4351,50 @@ function loadProjects() {
         indicator.textContent = proj ? proj.name : '';
         indicator.style.display = proj ? '' : 'none';
       }
-      poll(); // re-poll with correct project
     }
 
     // Show/hide remove button
     document.getElementById('remove-project-btn').style.display = activeProject ? '' : 'none';
-  }).catch(function() {});
+    // Sync mobile header project select
+    syncMobileProjectSelect();
+  }).catch(function(e) {
+    console.error('[LTT] loadProjects failed:', e);
+  });
 }
 
 function switchProject() {
   activeProject = document.getElementById('project-select').value;
   lastMessageCount = 0;
   document.getElementById('remove-project-btn').style.display = activeProject ? '' : 'none';
+  syncMobileProjectSelect();
+  poll();
+  if (isMobile) closeSidebar();
+}
+
+function mobileSelectProject(val) {
+  activeProject = val;
+  lastMessageCount = 0;
+  // Sync sidebar select
+  document.getElementById('project-select').value = val;
+  document.getElementById('remove-project-btn').style.display = val ? '' : 'none';
   poll();
 }
 
+function syncMobileProjectSelect() {
+  var mobileSel = document.getElementById('mobile-project-select');
+  if (!mobileSel) return;
+  var sidebarSel = document.getElementById('project-select');
+  // Copy options from sidebar select to mobile select
+  while (mobileSel.options.length > 1) mobileSel.remove(1);
+  for (var i = 1; i < sidebarSel.options.length; i++) {
+    var opt = document.createElement('option');
+    opt.value = sidebarSel.options[i].value;
+    opt.textContent = sidebarSel.options[i].textContent;
+    mobileSel.appendChild(opt);
+  }
+  mobileSel.value = activeProject || '';
+}
+
 function showAddProject() {
   var input = document.getElementById('project-path-input');
   if (input.classList.contains('visible')) {
@@ -4245,7 +4438,7 @@ function discoverProjects() {
 
   fetch('/api/discover').then(function(r) { return r.json(); }).then(function(found) {
     if (!found.length) {
-      resultsEl.innerHTML = '<div style="font-size:11px;color:var(--text-muted);padding:4px;">No new projects found nearby</div>';
+      resultsEl.innerHTML = '<div style="font-size:11px;color:var(--text-muted);padding:4px;">No new projects found (all discovered projects already added)</div>';
       setTimeout(function() { resultsEl.style.display = 'none'; }, 3000);
       return;
     }
@@ -4491,9 +4684,10 @@ function renderReplayMessages() {
 // ==================== BROWSER NOTIFICATIONS ====================
 
 var notifEnabled = localStorage.getItem('ltt-notif') === 'true';
-var notifPermission = Notification ? Notification.permission : 'denied';
+var notifPermission = (typeof Notification !== 'undefined') ? Notification.permission : 'denied';
 
 function toggleNotifications() {
+  if (typeof Notification === 'undefined') return;
   if (!notifEnabled) {
     if (notifPermission !== 'granted') {
       Notification.requestPermission().then(function(perm) {
@@ -4527,7 +4721,7 @@ function updateNotifBtn() {
 }
 
 function sendBrowserNotification(msg) {
-  if (!notifEnabled || notifPermission !== 'granted') return;
+  if (typeof Notification === 'undefined' || !notifEnabled || notifPermission !== 'granted') return;
   if (document.hasFocus()) return; // Only notify when tab is in background
   try {
     var preview = msg.content.substring(0, 80);
@@ -4822,11 +5016,17 @@ function initSSE() {
   var projectFromUrl = params.get('project');
   if (projectFromUrl) {
     activeProject = projectFromUrl;
+    console.log('[LTT] project from URL:', projectFromUrl);
   }
 })();
 
 // Load projects first, then poll (so auto-select works before first data fetch)
 loadProjects().then(function() {
+  console.log('[LTT] init: projects loaded, starting poll + SSE');
+  poll();
+  initSSE();
+}).catch(function(e) {
+  console.error('[LTT] init: loadProjects failed, polling anyway:', e);
   poll();
   initSSE();
 });

package/dashboard.js

@@ -544,8 +544,9 @@ function apiDiscover() {
   const checked = new Set();
   const existing = new Set(getProjects().map(p => p.path));
 
-  function scanDir(dir, depth) {
-    if (depth > 2 || checked.has(dir)) return;
+  function scanDir(dir, depth, maxDepth) {
+    maxDepth = maxDepth || 3;
+    if (depth > maxDepth || checked.has(dir)) return;
     checked.add(dir);
     try {
       const entries = fs.readdirSync(dir, { withFileTypes: true });
@@ -559,17 +560,26 @@ function apiDiscover() {
           if (!existing.has(projectPath)) {
             found.push({ name: path.basename(projectPath), path: projectPath, dataDir: fullPath });
           }
-        } else if (depth < 2) {
-          scanDir(fullPath, depth + 1);
+        } else if (depth < maxDepth) {
+          scanDir(fullPath, depth + 1, maxDepth);
         }
       }
     } catch {}
   }
 
-  // Scan from cwd, parent, and home
+  // Scan from cwd, parent, home, Desktop, and common project locations
   const cwd = process.cwd();
+  const home = process.env.HOME || process.env.USERPROFILE || '';
   scanDir(cwd, 0);
   scanDir(path.dirname(cwd), 1);
+  if (home) {
+    scanDir(home, 0);
+    scanDir(path.join(home, 'Desktop'), 0);
+    scanDir(path.join(home, 'Documents'), 0);
+    scanDir(path.join(home, 'Projects'), 0);
+    scanDir(path.join(home, 'Desktop', 'Claude Projects'), 0);
+    scanDir(path.join(home, 'Desktop', 'Projects'), 0);
+  }
 
   return found;
 }
@@ -741,12 +751,15 @@ const server = http.createServer(async (req, res) => {
       return;
     }
 
-    // Serve dashboard HTML (re-read in dev mode for hot reload)
+    // Serve dashboard HTML (always re-read for hot reload)
     if (url.pathname === '/' || url.pathname === '/index.html') {
-      const html = process.env.NODE_ENV === 'development'
-        ? fs.readFileSync(HTML_FILE, 'utf8')
-        : htmlContent;
-      res.writeHead(200, { 'Content-Type': 'text/html; charset=utf-8' });
+      const html = fs.readFileSync(HTML_FILE, 'utf8');
+      res.writeHead(200, {
+        'Content-Type': 'text/html; charset=utf-8',
+        'Cache-Control': 'no-cache, no-store, must-revalidate',
+        'Pragma': 'no-cache',
+        'Expires': '0'
+      });
       res.end(html);
     }
     // Existing APIs (now with ?project= param support)
@@ -1068,7 +1081,7 @@ server.listen(PORT, LAN_MODE ? '0.0.0.0' : '127.0.0.1', () => {
   const dataDir = resolveDataDir();
   const lanIP = getLanIP();
   console.log('');
-  console.log('  Let Them Talk - Agent Bridge Dashboard v3.3.1');
+  console.log('  Let Them Talk - Agent Bridge Dashboard v3.3.3');
   console.log('  ============================================');
   console.log('  Dashboard:  http://localhost:' + PORT);
   if (LAN_MODE && lanIP) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "let-them-talk",
-  "version": "3.3.2",
+  "version": "3.3.3",
   "description": "MCP message broker + web dashboard for inter-agent communication. Let AI CLI agents talk to each other.",
   "main": "server.js",
   "bin": {
@@ -47,8 +47,8 @@
   "bugs": {
     "url": "https://github.com/Dekelelz/let-them-talk/issues"
   },
-  "author": "Dekelelz",
-  "license": "BSL-1.1",
+  "author": "Dekelelz <contact@talk.unrealai.studio>",
+  "license": "SEE LICENSE IN LICENSE",
   "dependencies": {
     "@modelcontextprotocol/sdk": "1.27.1"
   }

package/server.js

@@ -2021,7 +2021,7 @@ async function main() {
   loadPlugins();
   const transport = new StdioServerTransport();
   await server.connect(transport);
-  console.error('Agent Bridge MCP server v3.3.1 running (' + (27 + loadedPlugins.length) + ' tools)');
+  console.error('Agent Bridge MCP server v3.3.3 running (' + (27 + loadedPlugins.length) + ' tools)');
 }
 
 main().catch(console.error);