Share what
your team knows.

Your team writes things down. Brain makes those notes findable. It stores markdown in git, indexes it with SQLite FTS5, and lets AI agents access it through MCP.

$ npm install -g @vraspar/brain@alpha
How it works
01
# First person creates a brain
$ brain init --name "Acme Engineering"
✓ Brain "Acme Engineering" is ready!
 
# Teammates join it
$ brain connect https://github.com/acme/brain-hub.git
02
# Push a guide
$ brain push ./guide.md
✓ Pushed: Docker Multi-Stage Builds
Tags: docker (auto-detected)
 
# Or import from a repo
$ brain ingest https://github.com/acme/docs.git
✓ Ingested 24 entries from acme/docs
03
$ brain search "kubernetes"
Found 3 results: K8s Deployment Guide bob guide k8s CI Pipeline carol guide ci, k8s Helm Chart Patterns alice skill helm, k8s
Why brain

Git as storage

Entries are markdown files in a git repo. No server, no database. You get version history and access control for free.

FTS5 search

SQLite full-text search with BM25 ranking. Fast enough that you won't notice it. Works offline. Rebuilt from source on every sync.

MCP for agents

10 tools and 2 resources over Model Context Protocol. Your AI agent can read what your team has written. brain serve starts it.

Knowledge trails

Entries link to each other through tags and content overlap. brain trail <topic> walks the connections.

Also: repo ingest · freshness scoring · Obsidian vault · interactive search · 20 commands · --format json

AI agent integration

Add brain to your MCP client:

mcp.json
{ "mcpServers": { "brain": { "command": "brain", "args": ["serve"] } } }

Works with Claude · Copilot · Cursor · Windsurf

Quick start
# Install
$ npm install -g @vraspar/brain@alpha
 
# Create a brain
$ brain init --name "My Team"
 
# Or join an existing one
$ brain connect <url>

Requires Node.js 20+ and git.

Under the hood

Brain stores entries as markdown files with YAML frontmatter in a git repository. The search index is a local SQLite FTS5 table, rebuilt from the markdown on every sync. Read receipts are JSON files committed alongside entries. Analytics with zero infrastructure.