@timmeck/brain 1.9.0 → 2.1.0

package/README.md

@@ -1,5 +1,10 @@
 # Brain
 
+[![npm version](https://img.shields.io/npm/v/@timmeck/brain)](https://www.npmjs.com/package/@timmeck/brain)
+[![npm downloads](https://img.shields.io/npm/dm/@timmeck/brain)](https://www.npmjs.com/package/@timmeck/brain)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
+[![GitHub stars](https://img.shields.io/github/stars/timmeck/brain)](https://github.com/timmeck/brain)
+
 **Adaptive Error Memory & Code Intelligence System for Claude Code**
 
 ![Synapse Network](assets/synapse-network.png)
@@ -185,6 +190,8 @@ Brain scans for source files (TypeScript, JavaScript, Python, Rust, Go, Shell, H
          |     SQLite (DB)      |
          |  better-sqlite3      |
          +----------------------+
+
+Cross-brain peering via IPC named pipes (\\.\pipe\brain-*, /tmp/brain-*)
 ```
 
 ### Core Components
@@ -220,6 +227,7 @@ brain config             View and manage Brain configuration
 brain export             Export Brain data as JSON
 brain import <dir>       Import a project directory into Brain
 brain dashboard          Generate interactive HTML dashboard (--live for SSE)
+brain peers              Show status of peer brains in the ecosystem
 ```
 
 ## MCP Tools
@@ -242,6 +250,9 @@ These tools are available to Claude Code (and other MCP clients) when Brain is c
 | `brain_suggest` | Get suggestions on what to build or improve |
 | `brain_status` | Current Brain stats |
 | `brain_notifications` | Get pending notifications |
+| `brain_ecosystem_status` | Get status of all brains in the ecosystem |
+| `brain_query_peer` | Query another brain in the ecosystem (method + params) |
+| `brain_error_trading_context` | Correlate an error with trading outcomes from Trading Brain |
 
 ## REST API
 
@@ -366,6 +377,28 @@ This happens silently in the background — no manual intervention needed.
 - **Winston** — Structured logging
 - **Vitest** — Testing
 
+## Brain Ecosystem
+
+Brain is part of the **Brain Ecosystem** — a family of standalone MCP servers that give Claude Code persistent, self-learning memory.
+
+| Brain | Purpose | Ports |
+|-------|---------|-------|
+| **Brain** | Error memory & code intelligence | **7777** / 7778 |
+| [Trading Brain](https://github.com/timmeck/trading-brain) | Adaptive trading intelligence | 7779 / 7780 |
+| [Marketing Brain](https://github.com/timmeck/marketing-brain) | Content strategy & engagement | 7781 / 7782 |
+| [Brain Core](https://github.com/timmeck/brain-core) v1.6.0 | Shared infrastructure (IPC, MCP, REST, CLI, math, synapses) | — |
+| [Brain Hub](https://timmeck.github.io/brain-hub/) | Ecosystem landing page | — |
+
+Each brain is **fully standalone** — [Brain Core](https://www.npmjs.com/package/@timmeck/brain-core) provides shared infrastructure (IPC, MCP, REST API, CLI, math, synapse algorithms) used by all brains, eliminating ~2,800 lines of duplicated code.
+
+### Cross-Brain Communication
+
+Brains discover and query each other at runtime via IPC named pipes. Use `brain peers` to see online peers, or the `brain_query_peer` / `brain_ecosystem_status` MCP tools to access peer data from Claude Code. Brains also push event notifications to each other — when Brain reports an error, Trading Brain and Marketing Brain are notified automatically.
+
+### Ecosystem Dashboard
+
+The interactive HTML dashboard (`brain dashboard`) includes an Ecosystem Peers section showing the live status of all connected brains.
+
 ## License
 
 [MIT](LICENSE)