ContextPulse

Vista previa para desarrolladores (v0.1-alpha). ContextPulse está en desarrollo activo. Las API y la configuración pueden cambiar entre versiones. Reporta problemas.

ContextPulse es un demonio de escritorio que captura tu pantalla, voz y actividad de teclado/ratón en tiempo real, y luego lo entrega a agentes de IA a través del Protocolo de Contexto de Modelos (MCP). Un proceso, un icono de bandeja, 35 herramientas MCP, cero dependencia de la nube.

Todo permanece local. Sin nube. Sin telemetría. Tus datos nunca salen de tu máquina.

┌─────────────────────────────────────────────────┐
│              ContextPulse Daemon                 │
│                                                  │
│  ┌──────────┐  ┌──────────┐  ┌──────────┐      │
│  │  Sight   │  │  Voice   │  │  Touch   │      │
│  │ Screen   │  │ Dictate  │  │ Keys +   │      │
│  │ OCR      │  │ Whisper  │  │ Mouse    │      │
│  │ Clipboard│  │ Vocab    │  │ Bursts   │      │
│  └────┬─────┘  └────┬─────┘  └────┬─────┘      │
│       └──────────────┼──────────────┘            │
│                      ▼                           │
│              ┌──────────────┐                    │
│              │  EventBus    │                    │
│              │  (Spine)     │                    │
│              └──────┬───────┘                    │
│                     ▼                            │
│              ┌──────────────┐                    │
│              │ activity.db  │                    │
│              │ SQLite+FTS5  │                    │
│              └──────────────┘                    │
└────────────────────┬────────────────────────────┘
                     │ MCP (streamable-http :8420)
        ┌────────────┼────────────┐
        ▼            ▼            ▼
   Claude Code    Cursor      Any MCP
                              Client

Demostración rápida

> You: "What am I looking at right now?"

Claude calls get_screenshot → get_screen_text:

  Active window: VS Code, src/auth/middleware.ts
  OCR text: "export async function validateToken(req: Request)..."
  Clipboard: "Bearer eyJhbGciOiJIUzI1NiIs..."

> Claude: "You're editing the auth middleware in VS Code.
>          I can see the validateToken function, and you have
>          a Bearer token in your clipboard. Want me to help
>          debug the token validation?"

> You hold Ctrl+Space and say: "refactor this to use the new auth provider"

ContextPulse Voice transcribes → pastes into editor
Claude calls get_recent_transcriptions → get_screen_text:

> Claude: "I can see your dictation and the current file.
>          Here's the refactored middleware using AuthProvider..."

> You: "What was I working on before lunch?"

Claude calls get_activity_summary(hours=4) → search_history("auth"):

  10:15 AM  VS Code, auth/middleware.ts (45 min)
  11:00 AM  Chrome, JWT.io (12 min)
  11:15 AM  VS Code, auth/tests/test_middleware.py (30 min)
  11:45 AM  Slack, #backend channel (15 min)

> Claude: "You spent the morning on auth middleware: writing
>          the implementation, checking JWT specs, then adding
>          tests. You were in Slack #backend right before lunch."

Related MCP server: screen-memory-mcp

¿Por qué ContextPulse?

Los asistentes de codificación con IA son potentes pero ciegos. No pueden ver tu pantalla, escuchar tus notas de voz ni saber qué estabas haciendo. ContextPulse cierra esta brecha:

• Local-first, cero dependencia de la nube. Tu pantalla, voz y datos de entrada nunca salen de tu máquina. Sin cuentas, sin suscripciones, sin servidores de terceros. Privacidad por arquitectura, no por política.

• Nativo de MCP desde el primer día. ContextPulse expone todo el contexto como herramientas MCP. Cualquier cliente MCP (Claude Desktop, Cursor, Windsurf, VS Code) obtiene contexto completo sin integraciones personalizadas.

• Verdaderamente multimodal en un solo demonio. Captura de pantalla, dictado por voz, entrada de teclado/ratón y memoria semántica se ejecutan en un proceso ligero (<1% de CPU). Sin necesidad de unir múltiples herramientas.

• Código abierto (AGPL-3.0). Totalmente auditable, autoalojable y extensible. Sin bloqueo de proveedor, sin dependencia de SaaS, sin riesgo de cierres por adquisiciones.

Qué hace diferente a ContextPulse

Soporte de plataformas

Instalación

git clone https://github.com/ContextPulse/contextpulse
cd contextpulse
# Windows
pip install -e packages/core -e packages/screen -e packages/voice -e packages/touch -e packages/project

# macOS — the [macos] extras are REQUIRED, not optional niceties. They pull in
# pyobjc (clipboard, window, caret, session monitor), rumps (menu bar) and
# mlx-whisper (Apple Silicon transcription). Without them the install succeeds
# and then fails at runtime.
pip install -e "packages/core[macos]" -e "packages/screen[macos]" -e "packages/voice[macos]" \
            -e packages/touch -e packages/project

# Optional: persistent memory + semantic search
pip install -e packages/memory

Configura tu agente de IA e instala las habilidades complementarias:

contextpulse --setup claude-code   # configures MCP + installs skills
# or: contextpulse --setup gemini  # for Gemini CLI
# or: contextpulse --setup all     # both

Inicia ContextPulse:

contextpulse       # starts the background daemon
contextpulse-mcp   # starts the MCP server on port 8420

Eso es todo. Tu agente de IA ahora tiene herramientas para leer tu pantalla, voz, actividad y memoria.

Añade a ~/.claude.json:

{
  "mcpServers": {
    "contextpulse": {
      "type": "http",
      "url": "http://127.0.0.1:8420/mcp"
    }
  }
}

Herramientas MCP

Vista (11 herramientas gratuitas)

Voz (3 herramientas gratuitas)

Táctil (3 herramientas gratuitas)

Proyecto (5 herramientas gratuitas)

Memoria (5 gratuitas + 2 Pro)

La memoria básica es gratuita para siempre. No se requiere licencia.

La memoria usa una arquitectura de tres niveles caliente/templada/fría: caché LRU en memoria → SQLite WAL + FTS5 → archivo comprimido. El paquete opcional pip install contextpulse-memory incluye estas herramientas.

Pro (4 herramientas, requiere licencia o prueba de 30 días)

Gratis para siempre: 27 herramientas (Vista × 11, Voz × 3, Táctil × 3, Proyecto × 5, Memoria × 5) Pro: añade 4 herramientas de búsqueda: búsqueda semántica de memoria más consultas de eventos entre modalidades Prueba: prueba Pro de 30 días en el primer uso, sin necesidad de tarjeta de crédito

Además, ContextPulse incluye varias herramientas de aprendizaje en segundo plano (consolidación de vocabulario, detección de correcciones) que se ejecutan automáticamente para mejorar la calidad de la transcripción con el tiempo.

Arquitectura

ContextPulse es un monorepo con paquetes modulares:

Todos los módulos emiten eventos a un EventBus compartido (la "columna vertebral"), que escribe en una base de datos SQLite local con búsqueda de texto completo FTS5. Los servidores MCP son procesos de solo lectura que consultan esta base de datos.

Desarrollo

git clone https://github.com/ContextPulse/contextpulse
cd contextpulse
uv venv
.venv\Scripts\activate
uv pip install -e "packages/core[dev]" -e packages/screen -e packages/voice -e packages/touch -e packages/project
pytest packages/ -x -q

Consulta CONTRIBUTING.md para las pautas.

Comprobación de salud Canary

Un script canary ejercita cada herramienta MCP expuesta e informa aprobado/fallido. Se ejecuta automáticamente en un horario de cron/Programador de tareas para detectar regresiones antes que los usuarios.

# Run manually
python scripts/canary_health_check.py

# Verbose (shows each tool as it runs)
python scripts/canary_health_check.py --verbose

# JSON output (for CI or external monitoring)
python scripts/canary_health_check.py --json

Qué hace:

• Inicia automáticamente el demonio de ContextPulse si no está ya en ejecución

• Llama a todas las herramientas MCP principales con argumentos válidos mínimos

• Imprime un resumen legible con desglose por servidor

• Añade resultados a logs/canary_results.json (se conservan las últimas 100 ejecuciones)

• Sale con 0 si todas las herramientas pasan, 1 si alguna falla

Programación (Programador de tareas de Windows):

1. Abre el Programador de tareas → Crear tarea básica

2. Desencadenador: Diario, repetir cada 4 horas

3. Acción: Iniciar un programa

   • Programa: <ruta-a-contextpulse>\.venv\Scripts\python.exe

   • Argumentos: scripts/canary_health_check.py

   • Iniciar en: <ruta-a-contextpulse>

Licencia

ContextPulse está licenciado bajo la Licencia Pública General Affero de GNU v3.0 (AGPL-3.0).

• Puedes usar, modificar y distribuir ContextPulse libremente

• Si lo modificas y lo despliegas como servicio, debes publicar tus cambios como código abierto

• Licencias comerciales disponibles para incrustarlo en productos propietarios

Para consultas de licencias comerciales, visita contextpulse.ai.

Aviso de patente

El sistema unificado de entrega de contexto multimodal de ContextPulse está pendiente de patente.