optiflow-mcp

Un único plugin de Claude Code, un servidor MCP, un repositorio — no es un envoltorio alrededor de herramientas instaladas por separado. Realmente fusiona la fuente real de dos proyectos upstream en su propio código base:

1. Las 76 herramientas reales smart_*/analíticas/monitoreo de panel de control MCP de token-optimizer-mcp, junto con sus ganchos de aplicación PreToolUse/PreCompact, portados directamente a src/optimizer/ — sin instalación de npx, sin proceso separado.

2. El núcleo real de compresión Rust (SmartCrusher) de headroom bifurcado en native/headroom-core/, reducido en funcionalidades y compilado a WebAssembly real (native/headroom-wasm/) cargado directamente por el plugin Node — el algoritmo Rust genuino, no una reescritura. El CodeCompressor y el modelo ML Kompress de headroom están reimplementados de forma nativa en TypeScript (src/native/).

3. Cinco módulos propios que ninguna de las herramientas upstream cubría: interceptación de salida estilo Bash/CLI, análisis de transcripciones de informes de sesión, un medidor de contexto de línea de estado, puntos de control de traspaso de sesión /optiflow:compact-continue y conversión TOON para cargas útiles grandes de JSON/CSV/YAML.

Ambos proyectos upstream todavía se referencian como submódulos de git en vendor/ para procedencia/texto de licencia, pero nada en src/ o native/ importa desde vendor/ — consulte docs/ADR/0002-real-merge-not-orchestration.md para saber por qué esto reemplazó el diseño original de envoltorio de orquestación (v1), y docs/architecture.md para el mapa de autoridad completo y decisiones bloqueadas.

Estado

Ambas fusiones principales están completas y conectadas: la fusión de 76 herramientas + ganchos de aplicación de token-optimizer-mcp, y el núcleo de compresión de headroom (SmartCrusher WASM

• CodeCompressor/Kompress TS) realmente invocado desde el pipeline enviado, no solo construido de forma aislada. npm run build, npm test y npx tsc --noEmit pasan todos — consulte docs/modules.md para detalles por módulo y el recuento actual de pruebas. La compilación desde la fuente necesita un kit de herramientas Rust (rustup, el objetivo wasm32-unknown-unknown, wasm-pack) además de Node; una instalación del plugin no lo necesita (el .wasm compilado está comprometido, el mismo razonamiento que plugin/dist/).

Related MCP server: claude-engineering-coach

Primeros pasos

Publicado en github.com/kristijankopacevic/optiflow-mcp. Verificado de extremo a extremo a través de un mercado de ruta local (no se necesita autenticación gh para eso):

1. En una sesión de Claude Code, agregue este repositorio como mercado e instale el plugin:

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

2. Verifique su entorno:

   optiflow doctor

   Informa las versiones de Node/npm, la resolución de configuración y la presencia/autenticación de gh.

3. Active la línea de estado (opcional, por elección — instalar el plugin solo no toca su settings.json):

   optiflow install --statusline

   Hace una copia de seguridad de su ~/.claude/settings.json antes de escribir, escribe de forma atómica y se niega a sobrescribir una línea de estado diferente existente sin --force. optiflow uninstall lo revierte. Consulte docs/statusline-manual-setup.md para obtener detalles (incluyendo hacerlo manualmente) y docs/modules.md para el resto de los módulos.

Consulte docs/ para conocer la arquitectura, la configuración y la referencia por módulo más allá de este inicio rápido.

Licencia

MIT para el código propio de optiflow-mcp (consulte LICENSE). Este repositorio también copia código fuente de proyectos upstream con licencia MIT (token-optimizer-mcp) y Apache-2.0 (headroom) — consulte THIRD_PARTY_LICENSES.md y NOTICE.