dbrain CLAUDE.md

dbrain CLAUDE.md is an instructions file for coding agents from ivncmp/dbrain. It costs 3,935 tokens per session, scanned C, original, MIT.

Project instructions for dbrain, a shared identity, conversation, and knowledge store for AI assistants. Different assistants and devices can connect to the same stored information through MCP or REST APIs.

In plain words
What is it for?
Use them when working on shared AI memory, storing conversations, managing user or project knowledge, or connecting assistants from different devices.
Why use it?
They explain how identity, chat history, and organized facts are kept consistent across machines and AI systems.

Instructions file

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add instructions/ivncmp/dbrain/claude-md
Clone the repo
git clone --depth 1 https://github.com/ivncmp/dbrain

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for dbrain CLAUDE.md

README.md
[![agentmods](https://agentmods.dev/badge/instructions/ivncmp/dbrain/claude-md.svg)](https://agentmods.dev/instructions/ivncmp/dbrain/claude-md)
Your own site
<a href="https://agentmods.dev/instructions/ivncmp/dbrain/claude-md"><img src="https://agentmods.dev/badge/instructions/ivncmp/dbrain/claude-md.svg" alt="Measured on agentmods" height="20"></a>
Per session 3,935 This file is loaded in full into every session.
When invoked 3,935 The same file — it is already loaded in full.
Security scan C 3 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.03935 $0.03935
Opus 5 $0.01968 $0.01968
Sonnet 5 $0.00787 $0.00787
Haiku 4.5 $0.00394 $0.00394

Measured 3d ago against content hash 5b4dda9d0b35, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade C, and why

dbrain CLAUDE.md scanned grade C with 3 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 3d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Reads agent configuration directoriesmediumAgent snooping

.claude/, .codex/, .gemini/ hold keys, settings and other credentials a mod has no legitimate need for.

- `~/.claude/settings.json` — Tool permissions

Unrestricted tool accessmediumExcessive agency

A wildcard tool grant or "run any command" leaves no least-privilege boundary at all.

- **Permissions in `~/.claude/settings.json`** — Use `"mcp__dbrain__*"` wildcard to allow all tools globally without per-project prompts.

Makes network callslowCapability

Not a fault in itself. Listed so you know the mod talks to something, and to what.

curl -H "Authorization: Bearer sk-dbr_..." \
CLAUDE.md · 384 lines

How it starts

The opening of the file, as written. The whole thing — 384 lines — stays where its author put it; the contents beside it link to each section on GitHub.

dbrain

Your distributed mind. Wherever you go, I remember.

What is it

dbrain is a brain for your AIs. It stores who they are, who you are, and everything you've done together. Install it once, and every AI you use — at home, at work, on mobile — connects to the same brain. Same identity, same memories, same knowledge. No matter where you are.

[Home]   Claude Code ──MCP──┐
[Work]   Claude Code ──MCP──┤     ┌───────────────────────┐
[Mobile] Gemini ──REST──────┼────→│  dbrain (your mind)   │
[Server] OpenClaw ──REST────┤     │  identity + memory + knowledge
[Other]  Custom AI ──API────┘     └───────────────────────┘

Architecture

The brain has 4 layers:

  1. Identity — Who am I? Who are you? How should I behave? Stored in documents. Every AI reads this first when it connects. One identity, many machines.
  2. Conversations — Raw chat history from every AI session. Every message pair (user <-> assistant) gets stored. The brain remembers every conversation, from every machine.
  3. Knowledge — Structured facts organized by PARA (Projects/Areas/Resources/Archives). Typed entities (person, project, event, system). Hot/warm/cold tiers by access frequency. Memories that matter stay hot, the rest fades — like a real brain.
  4. Recall — Full-text search (FTS5) over all facts. Ask a question, get the memory.

Optional: with an LLM configured, dbrain periodically reviews unprocessed conversations and extracts facts into the knowledge layer. Like a brain consolidating memories during sleep.

Stack

Layer Technology
Language Node.js + TypeScript
API Fastify
DB SQLite + FTS5 (better-sqlite3)
MCP @modelcontextprotocol/sdk (HTTP transport)
Validation Zod
CLI @clack/prompts (interactive wizard)
Dashboard Single-file React app (CDN, no build step)
Port :7878 (REST API + MCP HTTP, same port), :7879 (Dashboard)

Installation & Usage

Two-step process: init the brain (server), then connect clients.

Read the full file on GitHub · 384 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 3d ago First seen · 384 lines · 3,935 tokens per session scan C 5b4dda9d0b35

Subscribe to this mod's changes

dbrain CLAUDE.md is an instructions file published in the GitHub repository ivncmp/dbrain (3 stars, last pushed 3mo ago), licensed MIT. It adds 3,935 tokens to every session, about $0.0197 per session on Opus 5. A static security scan graded it C with 3 findings (reads agent configuration directories, unrestricted tool access, makes network calls). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.