brain
+
+ Share what your team knows.
+ A CLI that stores knowledge as markdown in git, makes it searchable with FTS5, and exposes it to your AI agent through MCP.
+
$ npm install -g @vraspar/brain@alpha
+
+ How it works
- -Why brain?
+FTS5 search
MCP-native
10 tools and 2 resources via Model Context Protocol. Your AI agent can search, read, edit, and publish entries. brain serve starts the server.
Knowledge trails
+Auto-computed links between entries. brain trail <topic> follows connections across your team’s knowledge graph.
Also: repo ingest · freshness scoring · knowledge trails · Obsidian vault · 20 commands
- -
- Zero infrastructure. One command to start.
- brain connect https://github.com/acme/brain-hub.git
-
Also: repo ingest · freshness scoring · Obsidian vault · interactive search · 20 commands · --format json
Works with your AI agent
+Add to your MCP client config:
+Add brain to your MCP client:
-Works with your AI agent
}10 tools: push_knowledge · search_knowledge · whats_new · get_entry · brain_stats · get_recommendations · update_entry · list_entries · explore_topic · retract_entry
2 resources: brain://digest · brain://stats
Your agent can search team knowledge, publish findings, and check what's new.
- -Claude · Copilot · Cursor · Windsurf
+ +10 tools · 2 resources · Your agent can search team knowledge, publish findings, and check what’s new.
Quick start
+Requires Node.js 20+ and git.
@@ -180,40 +192,28 @@Quick start
-Under the hood
- -- brain push / brain search / brain digest - │ - ┌──────▼──────┐ - │ CLI │ - └──────┬──────┘ - │ - ┌────────────────┼────────────────┐ - ▼ ▼ ▼ - ┌──────────┐ ┌────────────┐ ┌──────────┐ - │ Git repo │ │ SQLite │ │ Receipts │ - │ (storage)│ │ FTS5 │ │ (analytics│ - │ │ │ (search) │ │ │ - └──────────┘ └────────────┘ └──────────┘ -- -
Entries are markdown with YAML frontmatter, stored in a git repo. The search index is a local SQLite cache, rebuilt from source on every sync. Read receipts track who reads what.