Workbrain

Tu capa operativa personal para el trabajo asistido por IA.

Workbrain es un servidor local de Model Context Protocol (MCP) para Claude Code. Le da a Claude contexto persistente sobre cómo trabajas, en qué te centras esta semana y qué has publicado — sin enviar esos datos a la nube ni compartirlos con tu equipo.

Resumen

La mayoría de los entornos de codificación con IA le dicen al modelo cómo comportarse (reglas, prompts). Workbrain le dice qué estás haciendo — y le permite mantener esa imagen actualizada mientras trabajas.

Todo vive en tu máquina en ~/.workbrain/. Nada se confirma en los repos del proyecto a menos que tú lo elijas.

Related MCP server: Melchizedek

Características

• Contexto unificado — get_context devuelve playbook, agenda, registro de trabajo y commits en una sola llamada

• Tablero semanal vivo — Claude puede añadir, actualizar y completar elementos de la agenda durante una sesión

• Registro de trabajo automático — marcar un elemento de la agenda como completado crea una entrada de registro de trabajo vinculada

• Local-first y privado — SQLite + markdown en disco; sin cuentas, sin sincronización en la nube requerida

• Multi-proyecto — registrado a nivel de usuario; te sigue en todos los repos

• Integración con Git — hook opcional de post-commit registra commits automáticamente

• CLI — comprueba tu semana desde la terminal sin abrir Claude

Requisitos

• Node.js 22+ (usa node:sqlite integrado — sin dependencias nativas)

• Claude Code CLI o extensión (Cursor, VS Code o terminal)

Inicio rápido

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

Registra el servidor MCP (el nombre del servidor es workbrain; la carpeta del repo es work-brain):

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

Añade a tu perfil de shell (~/.zshrc o ~/.bashrc):

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

Verifica en Claude Code: escribe /mcp y confirma que workbrain está conectado.

Edita tu playbook: ~/.workbrain/playbook.md

Cómo funciona

┌─────────────────────────────────────────────────────────┐
│                     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 llama a las herramientas de Workbrain bajo demanda — tus reglas no se cargan en cada mensaje, manteniendo el contexto ligero hasta que se necesite.

Herramientas MCP

Flujo de sesión recomendado

Añade esto a tus reglas personales de Cursor o Claude:

Al inicio de una sesión de trabajo, llama a get_context. Cuando terminemos una tarea clara, actualiza la agenda y registra el trabajo. Marcar un elemento de la agenda como completado es suficiente — se registra automáticamente.

Ejemplos de prompts

CLI

Comprueba el estado sin Claude:

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

Configuración

Variables de entorno

Estructura del directorio de datos

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

Directorio de datos personalizado

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

Integración con Git

node bin/install.js configura una plantilla de git global para que los repos nuevos incluyan automáticamente el hook de post-commit.

Para un repositorio existente:

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

Cada commit registra hash, repo, rama, mensaje y archivos modificados en ~/.workbrain/data.db.

Configuración multi-máquina

Clona y registra en cada máquina:

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

Cada máquina mantiene su propio ~/.workbrain/ por defecto. Para sincronizar datos:

Configuración de Cursor

Workbrain usa Claude Code MCP, no el ~/.cursor/mcp.json de Cursor.

1. Instala la extensión Claude Code en Cursor

2. Abre la terminal integrada

3. Ejecuta claude mcp add (ver Inicio rápido)

4. En el panel de Claude: /mcp → habilita workbrain

Privacidad y alcance

Workbrain está diseñado para uso individual:

• MCP se registra con --scope user — no está vinculado a ningún repo de proyecto

• Los datos personales nunca salen de tu máquina a menos que los sincronices tú mismo

• No confirmes .mcp.json en repos de equipo compartidos

Solución de problemas

Desarrollo

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

Para desarrollo local con un alias CLI global:

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

Nomenclatura

Licencia

LICENSE