cursor-workflow-hints-mcp

MCP + CLI para recordatorios de flujo en Cursor: estado local, nudges al agente, toasts Windows y contadores diarios (sesiones, edits, MCP, Plans).

Herramienta generica para equipos que usan Cursor. Nombre del servidor en Cursor: workflow-hints.

Requisitos

Node.js 20+
Windows (toasts; el core funciona sin notificaciones)
Cursor con hooks y MCP habilitados

Instalacion

cd <ruta-al-repo>
npm ci
npm run build
powershell -ExecutionPolicy Bypass -File .\hooks-bridge\Install-Cursor.ps1 -ReplaceLegacyWorkflowHints

-ReplaceLegacyWorkflowHints quita entradas legacy de otros packs en hooks.json (opcional).

Reinicia Cursor. Verifica Settings → MCP (workflow-hints) y Settings → Hooks.

CLI (hooks)

node dist/cli.js record --event session_start --conversation-id <id>
node dist/cli.js record --event file_edit --conversation-id <id> --path <abs>
node dist/cli.js morning-check --force
node dist/cli.js summary
node dist/cli.js context
node dist/cli.js dismiss --type all

MCP tools

Tool	Descripcion
`hints_record_event`	Registra evento y devuelve nudge
`hints_get_context`	Resumen para el agente
`hints_get_daily_summary`	Contadores estructurados
`hints_set_preferences`	Umbrales y toasts
`hints_dismiss_nudge`	Silenciar por tipo o todo el dia

Resource: hints://today

Estado local

%USERPROFILE%\.cursor\workflow-hints\

state.json — dia, contadores, conversaciones
config.json — umbrales (se crea al editar preferencias)
stack-hints.json — hints opcionales por patron de ruta (ver config/stack-hints.example.json)

Migracion automatica desde %USERPROFILE%\.cursor\pipol-hints\ y %USERPROFILE%\.cursor\workflow-hints-state.json si existen.

Tareas programadas (Windows)

Tarea	Cuando
`WorkflowHints-MorningCheck`	Al iniciar sesion (Startup)
`WorkflowHints-EarlyCheck`	Diario 9:00
`WorkflowHints-MorningFollowup`	Diario 10:30 si no hubo uso

Acceso directo en Escritorio: Cursor - Iniciar jornada

Tests

npm test
powershell -ExecutionPolicy Bypass -File .\test\Test-WorkflowHints.ps1

Desinstalacion

powershell -ExecutionPolicy Bypass -File .\hooks-bridge\Uninstall-ScheduledTasks.ps1

Quitar workflow-hints de ~/.cursor/mcp.json
Quitar entradas hooks/workflow-hints/ de ~/.cursor/hooks.json
Borrar ~/.cursor/hooks/workflow-hints/ (opcional)
Borrar ~/.cursor/workflow-hints/ (opcional)

Variables de entorno

WORKFLOW_HINTS_DATA_DIR — directorio alternativo para state/config.

workflow-hints