let-them-talk 3.3.2 → 3.4.0

package/CHANGELOG.md

@@ -1,6 +1,54 @@
 # Changelog
 
-## [3.3.1] - 2026-03-14
+## [3.4.0] - 2026-03-15
+
+### Added — Dashboard Features
+- **Stats Tab** — per-agent message counts, avg response time, peak hours, 24-hour activity chart, conversation velocity. Keyboard shortcut `6`.
+- **Compact View** — toggle button in search bar. Hides avatars, inlines timestamps, reduces padding. Persists to localStorage.
+- **Message Edit** — edit any message via hover action. Full edit history tracked, "edited" badge displayed.
+- **Message Delete** — delete dashboard/system messages with confirmation dialog.
+- **Copy Message** — clipboard button on message hover to copy raw content.
+- **JSON Export** — new export format alongside HTML and Markdown.
+- **Kanban Drag-and-Drop** — drag task cards between columns (pending/in_progress/done/blocked).
+- **SSE Auto-Reconnect** — exponential backoff (1s→30s), yellow "Reconnecting..." indicator, polling fallback.
+- **Conversation Templates** — 4 built-in multi-agent workflow templates (Code Review Pipeline, Debug Squad, Feature Development, Research & Write) in the Launch tab with copyable agent prompts.
+
+### Added — API Endpoints
+- `PUT /api/message` — edit a message (with edit history)
+- `DELETE /api/message` — delete a message (dashboard/system only)
+- `GET /api/conversation-templates` — list conversation templates
+- `POST /api/conversation-templates/launch` — get template agent prompts
+- `GET /api/stats` — analytics data (per-agent stats, velocity, hourly distribution)
+- `GET/POST /api/permissions` — agent permission management
+
+### Added — CLI Commands
+- `npx let-them-talk msg <agent> <text>` — send a message from CLI
+- `npx let-them-talk status` — show active agents and message counts
+
+### Changed — Premium UI Redesign
+- Deeper dark palette with blue undertones (#080b12 background)
+- Inter font from Google Fonts with anti-aliased rendering
+- Glassmorphism header with backdrop-filter blur
+- Gradient accent system (blue→purple) on buttons, active tabs, send button
+- Refined shadow system (sm/md/lg) with colored glows
+- Focus rings on all inputs
+- Smoother transitions (0.2-0.25s) with lift effects on hover
+- Glass effects on modals and popups
+- Inset shadows on code blocks
+- Thinner scrollbars with transparent tracks
+
+### Fixed
+- Task notes crash when `notes` array undefined
+- Message edit always rewrites messages.jsonl regardless of match
+- Permissions API accepted arbitrary fields (now whitelisted)
+- Task status accepted any string (now validated against whitelist)
+- Reset button ignored active project in multi-project mode
+- Edit modal missing error handler on network failure
+- CLI msg command accepted invalid agent names
+- Copy-to-clipboard double-escaped HTML entities in template prompts
+- Duplicate deleteMessage function shadowing
+
+## [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.4.0
                       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,156 @@
-# 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.
+
+## Quick Start
 
-Or use a template for guided setup:
+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 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.
+
+## Highlights
+
+- **27 MCP tools** — messaging, tasks, workflows, profiles, workspaces, branching, plugins
+- **Premium dashboard** — glassmorphism UI, Inter font, gradient accents, SSE real-time (~200ms)
+- **Stats & analytics** — per-agent message counts, response times, hourly activity charts, velocity
+- **Conversation templates** — 4 built-in multi-agent workflows (Code Review, Debug Squad, Feature Dev, Research & Write)
+- **Message management** — edit, delete, copy messages with full edit history
+- **Task management** — drag-and-drop kanban board 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
+- **Compact view** — dense message toggle for power users, persists to localStorage
+- **Multi-format export** — HTML, Markdown, and JSON export
+- **CLI tools** — send messages and check status directly from the command line
+- **Plugin system** — extend with custom tools, 30s sandboxed execution
+- **Zero config** — one `npx` command, auto-detects your CLI, works immediately
+
+## 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
 ```
 
-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.
+| 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`.
+
+**6 main tabs:**
+
+- **Messages** — live feed with full markdown, message grouping, search, bookmarks, pins, emoji reactions, conversation replay, compact view
+- **Tasks** — drag-and-drop kanban board (pending / in progress / done / blocked)
+- **Workspaces** — per-agent key-value storage browser
+- **Workflows** — horizontal pipeline visualization, advance or skip steps
+- **Launch** — spawn new agents with templates, 4 built-in conversation templates with copyable prompts
+- **Stats** — per-agent message counts, avg response times, hourly activity charts, conversation velocity
+
+**Plus:**
 
-## Features
+- Agent monitoring with active / sleeping / dead / listening status
+- Profile popups with avatars and role badges
+- Message edit, delete, and copy actions on hover
+- SSE auto-reconnect with exponential backoff and visual indicator
+- Message injection and broadcast from browser
+- Conversation branching with branch tabs
+- Export as shareable HTML, Markdown, or JSON
+- Multi-project support with auto-discover
+- Premium glassmorphism UI with gradient accents
+- Dark / light theme toggle
+- Mobile responsive with hamburger sidebar
+- Browser notifications and sound alerts
+- LAN mode for phone access
 
-### 27 MCP Tools + Plugins
+## MCP Tools (27 + plugins)
 
-**Messaging**
+<details>
+<summary><strong>Messaging (13 tools)</strong></summary>
 
 | Tool | Description |
 |------|-------------|
@@ -71,112 +164,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) |
 
-**Tasks & Workflows**
+</details>
+
+<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 +223,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
+```
 
-## Supported CLIs
+Plugins run sandboxed with a 30-second timeout. Manage via CLI or dashboard.
 
-| CLI | Config | Auto-detected |
-|-----|--------|---------------|
-| Claude Code | `.mcp.json` | Yes |
-| Gemini CLI | `.gemini/settings.json` | Yes |
-| Codex CLI | `.mcp.json` | Yes |
+## CLI Reference
+
+```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 +280,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
+## Contributing
 
-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.
+See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
 
-### 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
+## Contact
 
-### 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
-
-### 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.
-
-### 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.4.0
   MCP message broker for inter-agent communication
   Supports: Claude Code, Gemini CLI, Codex CLI
 
@@ -28,7 +28,9 @@ function printUsage() {
     npx let-them-talk plugin remove <n> Remove a plugin by name
     npx let-them-talk plugin enable <n> Enable a plugin
     npx let-them-talk plugin disable <n> Disable a plugin
-    npx let-them-talk help              Show this help message
+    npx let-them-talk msg <agent> <text> Send a message to an agent
+    npx let-them-talk status             Show active agents and message count
+    npx let-them-talk help               Show this help message
   `);
 }
 
@@ -416,6 +418,97 @@ function dashboard() {
   require('./dashboard.js');
 }
 
+function resolveDataDirCli() {
+  return process.env.AGENT_BRIDGE_DATA_DIR || path.join(process.cwd(), '.agent-bridge');
+}
+
+function readJsonl(filePath) {
+  if (!fs.existsSync(filePath)) return [];
+  return fs.readFileSync(filePath, 'utf8')
+    .split('\n')
+    .filter(l => l.trim())
+    .map(l => { try { return JSON.parse(l); } catch { return null; } })
+    .filter(Boolean);
+}
+
+function readJson(filePath) {
+  if (!fs.existsSync(filePath)) return {};
+  try { return JSON.parse(fs.readFileSync(filePath, 'utf8')); } catch { return {}; }
+}
+
+function isPidAlive(pid) {
+  if (!pid) return false;
+  try { process.kill(pid, 0); return true; } catch { return false; }
+}
+
+function cliMsg() {
+  const recipient = process.argv[3];
+  const textParts = process.argv.slice(4);
+  if (!recipient || !textParts.length) {
+    console.error('  Usage: npx let-them-talk msg <agent> <text>');
+    process.exit(1);
+  }
+  if (!/^[a-zA-Z0-9_-]{1,20}$/.test(recipient)) {
+    console.error('  Agent name must be 1-20 alphanumeric characters (with _ or -).');
+    process.exit(1);
+  }
+  const text = textParts.join(' ');
+  const dir = resolveDataDirCli();
+  if (!fs.existsSync(dir)) {
+    console.error('  No .agent-bridge/ directory found. Run "npx let-them-talk init" first.');
+    process.exit(1);
+  }
+
+  const msgId = 'm' + Date.now().toString(36) + Math.random().toString(36).slice(2, 6);
+  const msg = {
+    id: msgId,
+    from: 'CLI',
+    to: recipient,
+    content: text,
+    timestamp: new Date().toISOString(),
+  };
+
+  const messagesFile = path.join(dir, 'messages.jsonl');
+  const historyFile = path.join(dir, 'history.jsonl');
+  fs.appendFileSync(messagesFile, JSON.stringify(msg) + '\n');
+  fs.appendFileSync(historyFile, JSON.stringify(msg) + '\n');
+
+  console.log('  Message sent to ' + recipient + ': ' + text);
+}
+
+function cliStatus() {
+  const dir = resolveDataDirCli();
+  if (!fs.existsSync(dir)) {
+    console.error('  No .agent-bridge/ directory found. Run "npx let-them-talk init" first.');
+    process.exit(1);
+  }
+
+  const agents = readJson(path.join(dir, 'agents.json'));
+  const history = readJsonl(path.join(dir, 'history.jsonl'));
+
+  console.log('');
+  console.log('  Agent Bridge Status');
+  console.log('  ===================');
+  console.log('  Messages: ' + history.length);
+  console.log('');
+
+  const names = Object.keys(agents);
+  if (!names.length) {
+    console.log('  No agents registered.');
+  } else {
+    console.log('  Agents:');
+    for (const name of names) {
+      const info = agents[name];
+      const alive = isPidAlive(info.pid);
+      const status = alive ? '\x1b[32monline\x1b[0m' : '\x1b[31moffline\x1b[0m';
+      const lastActivity = info.last_activity || info.timestamp || '';
+      const msgCount = history.filter(m => m.from === name).length;
+      console.log('    ' + name.padEnd(16) + ' ' + status + '  msgs: ' + msgCount + '  last: ' + (lastActivity ? new Date(lastActivity).toLocaleTimeString() : '-'));
+    }
+  }
+  console.log('');
+}
+
 switch (command) {
   case 'init':
     init();
@@ -429,6 +522,14 @@ switch (command) {
   case 'reset':
     reset();
     break;
+  case 'msg':
+  case 'message':
+  case 'send':
+    cliMsg();
+    break;
+  case 'status':
+    cliStatus();
+    break;
   case 'plugin':
   case 'plugins':
     pluginCmd();