Skip to main content
Glama

br8n

Eigenes, portables Arbeitsgedächtnis. Eine Brain-Vorlage aus einfachen Dateien und ein winziger MCP-Server, der es jedem Modell ermöglicht, sie zu lesen.

Alles, was dein Team einem Chat-Tool darüber beigebracht hat, wie die Arbeit erledigt wird, steckt im Login von jemand anderem. Wenn du das Tool wechselst, bist du wieder ein Fremder. Dieses Repo geht den umgekehrten Weg: Das Gedächtnis lebt in Dateien, die dir gehören, und das Modell ist nur ein Leser.

br8n ist die KI-Delivery-Praxis von Branded Mayhem Collective. Das hier ist der offene Teil: das Dateilayout und die Tür. Die gehostete Installation ergänzt Retrieval, Governance und jemanden, der es mit dir betreibt — auf denselben Dateien, die nie ihre Form ändern. br8n.io

Was es hier gibt

  • template/brain/ — das Brain-Layout: how-we-work/, decisions/, exceptions/, handoffs/, voice/. Nur Markdown. Eine Datei, eine Sache. Schreib das Warum, damit das Modell später widersprechen kann.

  • src/ — ein MCP-Server (stdio) mit drei Tools: brain_list, brain_read, brain_search. Die Suche liefert Datei + Zeile, sodass Antworten ihre Quelle zitieren. Keine Vektoren, kein Index, kein Konto. Grep ist der Punkt.

Related MCP server: Universal Memory MCP Server

Verwendung

git clone https://github.com/Branded-Mayhem-Collective-LLC/br8n
cd br8n && npm install && npm run build
cp -r template/brain ~/my-brain        # now write in it
node dist/cli.js ~/my-brain            # MCP server on stdio

Claude Desktop / Claude Code / Cursor (beliebiger MCP-Client) — hinzufügen:

{ "mcpServers": { "br8n": { "command": "node", "args": ["/path/to/br8n/dist/cli.js", "/path/to/my-brain"] } } }

Dann frag das Modell etwas, das das Brain weiß. Es antwortet aus der Datei und nennt sie. Wechsle das Modell; dieselbe Antwort, dieselbe Datei.

Warum Dateien

  • Portabel. cp -r brain/ new-machine/ ist die gesamte Migration. Wenn du das nicht kannst, gehört es dir nicht.

  • Einsehbar. Du kannst jedes Byte lesen, das das Modell liest.

  • Modell-agnostisch. Dem Ordner ist es egal, welches Modell auf der anderen Seite von MCP sitzt.

  • Es kann widersprechen. Eine Entscheidung, die mit ihrem Warum gespeichert ist, erlaubt einem Modell zu sagen: „Das widerspricht dem, was du im März entschieden hast." Ein Chatverlauf kann das nicht.

Die Methode ist absichtlich öffentlich

Das Layout und dieser Server sind MIT-lizenziert. Wofür br8n Geld verlangt, ist praktische Arbeit an einem echten Betrieb: herauszufinden, was tatsächlich in den Köpfen der Leute steckt, das Retrieval auf die Rolle zuzuschneiden, es zu betreiben und aktuell zu halten. Wenn du es lieber selbst machst, fang hier an — die meisten sollten das. Der erste Kurs ist kostenlos unter br8n.io/lab.

Nicht verbunden

br8n auf PyPI (eine Context-Capture-Engine von einem anderen Autor) ist nicht dieses Projekt.

MIT © 2026 Branded Mayhem Collective LLC

Veröffentlichung (Maintainer)

npm login && npm publish --access public          # 1. claims `br8n` on npm; package.json carries mcpName
mcp-publisher login github                        # 2. GitHub device-flow auth (org member)
mcp-publisher publish                             # 3. lists io.github.Branded-Mayhem-Collective-LLC/br8n in the official MCP registry

Available Tools

3 tools
brain_listA
Read-onlyIdempotent

List every markdown file in the brain (relative path, size, last modified).

Inputs: no named parameters.

brain_readA
Read-onlyIdempotent

Read one file from the brain by relative path (e.g. decisions/2026-03-change-orders.md).

Inputs: path (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.4/5.0

    Scored across 3 tools

    Disambiguation5/5

    Each tool targets a distinct operation: listing all files, reading a specific file, and searching content. There is no overlap or ambiguity in their purposes.

    Naming Consistency5/5

    All tools consistently use the 'brain_' prefix with a simple verb pattern (list/read/search), making the API predictable and easy to navigate.

    Tool Count5/5

    Three tools is minimal but well-scoped for a read-only markdown knowledge base. Each tool serves a necessary and non-redundant function.

    Completeness4/5

    The set fully covers the core retrieval workflows: browsing the structure, reading files, and searching content. Write or management operations are absent, but they appear outside the server's stated read-only scope.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers