Workbrain

Ваш персональный операционный слой для работы с ИИ.

Workbrain — это локальный сервер Model Context Protocol (MCP) для Claude Code. Он даёт Claude постоянный контекст о том, как вы работаете, на чём сосредоточены на этой неделе и что уже выпустили — без отправки этих данных в облако и без передачи их вашей команде.

Обзор

Большинство AI-конфигураций для программирования говорят модели как себя вести (правила, промпты). Workbrain говорит ей что вы делаете — и позволяет ей поддерживать эту картину в актуальном состоянии по мере вашей работы.

Всё хранится на вашей машине в ~/.workbrain/. Ничего не попадает в репозитории проектов, если вы сами этого не захотите.

Related MCP server: Melchizedek

Возможности

• Единый контекст — get_context возвращает playbook, agenda, work log и коммиты одним вызовом

• Живая недельная доска — Claude может добавлять, обновлять и завершать пункты agenda во время сессии

• Автоматическое логирование работы — отметка пункта agenda как выполненного создаёт связанную запись в work log

• Локально и приватно — SQLite + markdown на диске; без аккаунтов и облачной синхронизации

• Кросс-проектность — регистрируется на уровне пользователя; работает во всех ваших репозиториях

• Интеграция с git — опциональный post-commit хук автоматически записывает коммиты

• CLI — проверяйте свою неделю из терминала, не открывая Claude

Требования

• Node.js 22+ (использует встроенный node:sqlite — без нативных зависимостей)

• Claude Code CLI или расширение (Cursor, VS Code или терминал)

Быстрый старт

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

Зарегистрируйте MCP-сервер (имя сервера — workbrain; папка репозитория — work-brain):

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

Добавьте в ваш shell-профиль (~/.zshrc или ~/.bashrc):

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

Проверьте в Claude Code: введите /mcp и убедитесь, что workbrain подключён.

Отредактируйте свой playbook: ~/.workbrain/playbook.md

Как это работает

┌─────────────────────────────────────────────────────────┐
│                     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 вызывает инструменты Workbrain по мере необходимости — ваши правила не загружаются в каждое сообщение, что экономит контекст до тех пор, пока он не понадобится.

MCP-инструменты

Рекомендуемый порядок действий в сессии

Добавьте это в ваши личные правила Cursor или Claude:

В начале рабочей сессии вызывайте get_context. Когда мы завершаем чёткую задачу, обновляйте agenda и логируйте работу. Отметки пункта agenda как выполненного достаточно — он логируется автоматически.

Примеры промптов

CLI

Проверка статуса без 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

Конфигурация

Переменные окружения

Структура каталога данных

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

Пользовательский каталог данных

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

node bin/install.js настраивает глобальный git-шаблон, чтобы новые репозитории автоматически включали post-commit хук.

Для существующего репозитория:

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

Каждый коммит записывает хеш, репозиторий, ветку, сообщение и изменённые файлы в ~/.workbrain/data.db.

Настройка на нескольких машинах

Клонируйте и зарегистрируйте на каждой машине:

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

Каждая машина по умолчанию ведёт собственный ~/.workbrain/. Для синхронизации данных:

Настройка в Cursor

Workbrain использует Claude Code MCP, а не ~/.cursor/mcp.json от Cursor.

1. Установите расширение Claude Code в Cursor

2. Откройте встроенный терминал

3. Выполните claude mcp add (см. Быстрый старт)

4. В панели Claude: /mcp → включите workbrain

Конфиденциальность и область применения

Workbrain предназначен для индивидуального использования:

• MCP регистрируется с --scope user — не привязан ни к одному проектному репозиторию

• Личные данные никогда не покидают вашу машину, если вы не синхронизируете их сами

• Не коммитьте .mcp.json в общие командные репозитории

Устранение неполадок

Разработка

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

Для локальной разработки с глобальным CLI-алиасом:

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

Наименование

Лицензия

LICENSE