Workbrain

Deine persönliche Betriebsebene für KI-gestützte Arbeit.

Workbrain ist ein lokaler Model Context Protocol (MCP)-Server für Claude Code. Er gibt Claude persistenten Kontext darüber, wie du arbeitest, worauf du diese Woche fokussiert bist und was du ausgeliefert hast – ohne diese Daten in die Cloud zu senden oder mit deinem Team zu teilen.

Überblick

Die meisten KI-Coding-Setups sagen dem Modell, wie es sich verhalten soll (Regeln, Prompts). Workbrain sagt ihm, was du tust – und lässt es dieses Bild während der Arbeit aktuell halten.

Alles liegt auf deinem Rechner unter ~/.workbrain/. Nichts wird in Projekt-Repositories committet, außer du möchtest das.

Related MCP server: Melchizedek

Funktionen

• Einheitlicher Kontext – get_context liefert Playbook, Agenda, Arbeitslog und Commits in einem einzigen Aufruf

• Lebendiges Wochen-Board – Claude kann Agenda-Punkte während einer Sitzung hinzufügen, aktualisieren und abschließen

• Automatische Arbeitsprotokollierung – Das Abschließen eines Agenda-Punkts erstellt einen verknüpften Arbeitslog-Eintrag

• Lokal zuerst & privat – SQLite + Markdown auf der Festplatte; keine Konten, keine Cloud-Synchronisierung erforderlich

• Projektübergreifend – Auf Benutzerebene registriert; folgt dir über jedes Repository

• Git-Integration – Optionaler Post-Commit-Hook erfasst Commits automatisch

• CLI – Überprüfe deine Woche vom Terminal aus, ohne Claude zu öffnen

Voraussetzungen

• Node.js 22+ (verwendet eingebautes node:sqlite – keine nativen Abhängigkeiten)

• Claude Code CLI oder Erweiterung (Cursor, VS Code oder Terminal)

Schnellstart

git clone https://github.com/himanshu-sharma-55/work-brain.git
cd work-brain
npm install
node bin/install.js

Registriere den MCP-Server (Servername ist workbrain; Repository-Ordner ist work-brain):

claude mcp add --scope user workbrain -- node /absolute/path/to/work-brain/src/index.js

Füge zu deinem Shell-Profil hinzu (~/.zshrc oder ~/.bashrc):

export WORKBRAIN_ROOT=/absolute/path/to/work-brain

Überprüfe in Claude Code: Tippe /mcp und bestätige, dass workbrain verbunden ist.

Bearbeite dein Playbook: ~/.workbrain/playbook.md

So funktioniert es

┌─────────────────────────────────────────────────────────┐
│                     Claude Code                         │
│              (Cursor / VS Code / CLI)                   │
└────────────────────────┬────────────────────────────────┘
                         │ MCP (stdio)
                         ▼
┌─────────────────────────────────────────────────────────┐
│                  Workbrain Server                       │
│  get_context · get_agenda · log_work · get_commits …   │
└────────────────────────┬────────────────────────────────┘
                         │
          ┌──────────────┼──────────────┐
          ▼              ▼              ▼
   playbook.md       data.db      git hook (optional)
   (how you work)   (agenda,       (commit capture)
                     work log,
                     commits)
          └──────────────┴──────────────┘
                         │
                    ~/.workbrain/
                    (or WORKBRAIN_HOME)

Claude ruft Workbrain-Tools bei Bedarf auf – deine Regeln werden nicht in jede Nachricht geladen, wodurch der Kontext schlank bleibt, bis er benötigt wird.

MCP-Tools

Empfohlener Sitzungsablauf

Füge dies zu deinen persönlichen Cursor- oder Claude-Regeln hinzu:

Zu Beginn einer Arbeitssitzung get_context aufrufen. Wenn wir eine klare Aufgabe abschließen, die Agenda aktualisieren und Arbeit protokollieren. Einen Agenda-Punkt als erledigt zu markieren reicht aus – es protokolliert automatisch.

Beispiel-Prompts

CLI

Status ohne Claude prüfen:

node bin/workbrain.js status     # current week at a glance
node bin/workbrain.js summary    # full week recap
npm run status                   # shortcut via package script

Konfiguration

Umgebungsvariablen

Layout des Datenverzeichnisses

~/.workbrain/
├── playbook.md    # How you work (markdown)
├── data.db        # Agenda, work log, commits (SQLite)
└── git-template/  # Git hook template (created by install)

Benutzerdefiniertes Datenverzeichnis

export WORKBRAIN_HOME=/path/to/shared/workbrain-data
claude mcp add --scope user workbrain -- \
  env WORKBRAIN_HOME=/path/to/shared/workbrain-data \
  node ~/work-brain/src/index.js

Git-Integration

node bin/install.js konfiguriert eine globale Git-Vorlage, sodass neue Repositories den Post-Commit-Hook automatisch enthalten.

Für ein bestehendes Repository:

export WORKBRAIN_ROOT=/path/to/work-brain   # in ~/.zshrc
node /path/to/work-brain/bin/setup-git-hook.js /path/to/repo

Jeder Commit erfasst Hash, Repository, Branch, Nachricht und geänderte Dateien in ~/.workbrain/data.db.

Multi-Maschinen-Setup

Auf jeder Maschine klonen und registrieren:

git clone https://github.com/himanshu-sharma-55/work-brain.git ~/work-brain
cd ~/work-brain && npm install && node bin/install.js
claude mcp add --scope user workbrain -- node ~/work-brain/src/index.js

Jede Maschine verwaltet standardmäßig ihr eigenes ~/.workbrain/. Zum Synchronisieren von Daten:

Cursor-Setup

Workbrain verwendet Claude Code MCP, nicht Cursors ~/.cursor/mcp.json.

1. Installiere die Claude Code-Erweiterung in Cursor

2. Öffne das integrierte Terminal

3. Führe claude mcp add aus (siehe Schnellstart)

4. Im Claude-Panel: /mcp → workbrain aktivieren

Datenschutz & Umfang

Workbrain ist für die individuelle Nutzung konzipiert:

• MCP ist mit --scope user registriert – nicht an ein Projekt-Repository gebunden

• Persönliche Daten verlassen deinen Rechner nie, es sei denn, du synchronisierst sie selbst

• Committe .mcp.json nicht in gemeinsame Team-Repositories

Fehlerbehebung

Entwicklung

npm install
npm start              # run MCP server (stdio)
npm run install:local  # install + init data dir + git template
npm run status         # CLI status check

Für lokale Entwicklung mit einem globalen CLI-Alias:

cd work-brain && npm link
claude mcp add --scope user workbrain -- workbrain

Namensgebung

Lizenz

LICENSE