optiflow-mcp

Единый плагин для Claude Code, один MCP-сервер, один репозиторий — а не обёртка над отдельно устанавливаемыми инструментами. Он по-настоящему сливает исходный код двух вышестоящих проектов в свою собственную кодовую базу:

1. 76 реальных MCP-инструментов smart_*/аналитики/мониторинга дашбордов из token-optimizer-mcp, а также его хуки принудительного применения PreToolUse/PreCompact, перенесённые непосредственно в src/optimizer/ — без установки через npx и без отдельного процесса.

2. Настоящее ядро сжатия на Rust (SmartCrusher) из headroom, форкнутое в native/headroom-core/, урезанное по функциональности и скомпилированное в настоящий WebAssembly (native/headroom-wasm/), загружаемый напрямую Node-плагином — подлинный алгоритм на Rust, а не переписывание. CodeCompressor и ML-модель Kompress из headroom перереализованы нативно на TypeScript (src/native/).

3. Пять собственных модулей, которые не покрывал ни один из вышестоящих инструментов: перехват вывода Bash/CLI в стиле chop, аналитика транскриптов сессионных отчётов, контекстный индикатор статусной строки, контрольные точки передачи сессии /optiflow:compact-continue и преобразование TOON для больших JSON/CSV/YAML-нагрузок.

Оба вышестоящих проекта по-прежнему указаны как git-подмодули в vendor/ для отслеживания происхождения/текста лицензий, но ничто в src/ или native/ не импортирует из vendor/ — см. docs/ADR/0002-real-merge-not-orchestration.md о причинах замены исходного проекта-оркестратора (v1) и docs/architecture.md для полной карты полномочий и закреплённых решений.

Статус

Оба крупных слияния завершены и связаны: слияние 76 инструментов + хуки принудительного применения из token-optimizer-mcp и ядро сжатия headroom (WASM SmartCrusher + TS CodeCompressor/Kompress) фактически вызываются из поставляемого конвейера, а не просто собираются изолированно. npm run build, npm test и npx tsc --noEmit проходят — см. docs/modules.md для подробностей по модулям и текущего количества тестов. Сборка из исходников требует Rust-тулчейна (rustup, цель wasm32-unknown-unknown, wasm-pack) в дополнение к Node; установка плагина не требует (скомпилированный .wasm включён в репозиторий по той же логике, что и plugin/dist/).

Related MCP server: claude-engineering-coach

Начало работы

Опубликован на github.com/kristijankopacevic/optiflow-mcp. Проверен от начала до конца через маркетплейс с локальным путём (gh-авторизация не требуется):

1. В сессии Claude Code добавьте этот репозиторий как маркетплейс и установите плагин:

   /plugin marketplace add C:\path\to\optiflow-mcp
   /plugin install optiflow@optiflow

2. Проверьте ваше окружение:

   optiflow doctor

   Сообщает версии Node/npm, разрешение конфигурации и наличие/авторизацию gh.

3. Активируйте статусную строку (опционально, по желанию — установка плагина сама по себе не трогает ваш settings.json):

   optiflow install --statusline

   Создаёт резервную копию вашего ~/.claude/settings.json перед записью, записывает атомарно и отказывается перезаписывать существующую другую статусную строку без --force. optiflow uninstall отменяет изменения. Подробности (включая ручную настройку) см. в docs/statusline-manual-setup.md, остальные модули — в docs/modules.md.

См. docs/ для информации об архитектуре, конфигурации и более подробной документации по модулям, выходящей за рамки этого краткого руководства.

Лицензия

MIT для собственного кода optiflow-mcp (см. LICENSE). Этот репозиторий также включает исходный код из вышестоящих проектов, распространяемых по лицензиям MIT (token-optimizer-mcp) и Apache-2.0 (headroom) — см. THIRD_PARTY_LICENSES.md и NOTICE.