buddy

[](LICENSE) [](https://github.com/enki-run/buddy/actions)

> A graph-based knowledge substrate for LLMs and AI agents, with a human-readable dashboard.

buddy is an MCP server that provides 25 tools for managing a knowledge graph. Agents store concepts, facts, decisions, templates, and configs as Nodes, connected by typed Edges. Humans see everything through a server-rendered dashboard.

• Unified Node Model — One entity type replaces 5 (knowledge, documents, memories, variables, skills)
• Knowledge Graph — Typed edges between nodes, projects, and tasks with a validation matrix
• 25 MCP Tools — CRUD, full-text search (FTS5), graph traversal, context loading
• Health Score — Per-project score (A-F) based on momentum, deadlines, freshness
• Dashboard — Node browser, graph visualization (D3.js), project hub, activity log
• OAuth 2.1 — PKCE enforced, compatible with Claude.ai, Gemini CLI, Mistral Le Chat
• Encryption — AES-256-GCM for secret nodes via HKDF key derivation
• Graph Integrity — Automatic validation, orphan detection, health score impact
• Token-optimized — context_load designed for minimal token usage (<800 tokens)

# 1. Clone
git clone git@github.com:enki-run/buddy.git && cd buddy

# 2. Install + configure
npm install
cp wrangler.toml.example wrangler.toml

# 3. Create D1 database
wrangler d1 create buddy
# → Copy database_id into your wrangler.toml

# 4. Create KV namespace
wrangler kv namespace create CACHE
# → Copy id into your wrangler.toml

# 5. Run migrations
npm run migrate

# 6. Set token (min 32 hex chars)
openssl rand -hex 32
wrangler secret put BUDDY_TOKEN

# 7. Deploy
npm run deploy

See docs/installation.md for custom domain, rate limiting, and loca