ContextPulse

Entwicklervorschau (v0.1-alpha). ContextPulse wird aktiv weiterentwickelt. APIs und Konfiguration können sich zwischen den Versionen ändern. Probleme melden.

ContextPulse ist ein Desktop-Daemon, der Ihren Bildschirm, Ihre Stimme und Ihre Tastatur-/Mausaktivität in Echtzeit erfasst und sie über das Model Context Protocol (MCP) an KI-Agenten liefert. Ein Prozess, ein Tray-Symbol, 35 MCP-Tools, null Cloud-Abhängigkeit.

Alles bleibt lokal. Keine Cloud. Keine Telemetrie. Ihre Daten verlassen niemals Ihren Rechner.

┌─────────────────────────────────────────────────┐
│              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

Schnelldemo

> 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

Warum ContextPulse?

KI-Codierungsassistenten sind mächtig, aber blind. Sie können Ihren Bildschirm nicht sehen, Ihre Sprachnotizen nicht hören und nicht wissen, was Sie gerade getan haben. ContextPulse schließt diese Lücke:

• Lokal zuerst, null Cloud-Abhängigkeit. Ihr Bildschirm, Ihre Stimme und Ihre Eingabedaten verlassen niemals Ihren Rechner. Keine Konten, keine Abonnements, keine Drittanbieter-Server. Datenschutz durch Architektur, nicht durch Richtlinie.

• Von Anfang an MCP-nativ. ContextPulse stellt den gesamten Kontext als MCP-Tools bereit. Jeder MCP-Client (Claude Desktop, Cursor, Windsurf, VS Code) erhält vollen Kontext ohne benutzerdefinierte Integrationen.

• Wirklich multimodal in einem einzigen Daemon. Bildschirmaufnahme, Sprachdiktat, Tastatur-/Mauseingabe und semantisches Gedächtnis laufen in einem leichtgewichtigen Prozess (<1% CPU). Kein Zusammensetzen mehrerer Tools.

• Open Source (AGPL-3.0). Vollständig prüfbar, selbst hostbar und erweiterbar. Keine Herstellerbindung, keine SaaS-Abhängigkeit, kein Risiko von übernahmebedingten Abschaltungen.

Was ContextPulse anders macht

Plattformunterstützung

Installation

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

Konfigurieren Sie Ihren KI-Agenten und installieren Sie Begleitfähigkeiten:

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

Starten Sie ContextPulse:

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

Das war's. Ihr KI-Agent hat jetzt Werkzeuge zum Lesen Ihres Bildschirms, Ihrer Stimme, Ihrer Aktivität und Ihres Gedächtnisses.

Fügen Sie zu ~/.claude.json hinzu:

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

MCP-Tools

Sicht (11 kostenlose Tools)

Stimme (3 kostenlose Tools)

Berührung (3 kostenlose Tools)

Projekt (5 kostenlose Tools)

Gedächtnis (5 kostenlose + 2 Pro-Tools)

Basisgedächtnis ist für immer kostenlos. Keine Lizenz erforderlich.

Das Gedächtnis verwendet eine dreistufige Heiß/Warm/Kalt-Architektur: In-Memory-LRU-Cache → SQLite WAL + FTS5 → komprimiertes Archiv. Das optionale Paket pip install contextpulse-memory liefert diese Tools.

Pro (4 Tools, erfordert Lizenz oder 30-Tage-Testversion)

Für immer kostenlos: 27 Tools (Sicht × 11, Stimme × 3, Berührung × 3, Projekt × 5, Gedächtnis × 5) Pro: fügt 4 Suchtools hinzu: semantische Gedächtnissuche plus modalitätsübergreifende Ereignisabfragen Testversion: 30-tägige Pro-Testversion bei erster Nutzung, keine Kreditkarte erforderlich

Darüber hinaus enthält ContextPulse mehrere Hintergrund-Lerntools (Wortschatz-Konsolidierung, Korrekturerkennung), die automatisch laufen, um die Transkriptionsqualität im Laufe der Zeit zu verbessern.

Architektur

ContextPulse ist ein Monorepo mit modularen Paketen:

Alle Module senden Ereignisse an einen gemeinsamen EventBus (das "Rückgrat"), der in eine lokale SQLite-Datenbank mit FTS5-Volltextsuche schreibt. MCP-Server sind schreibgeschützte Prozesse, die diese Datenbank abfragen.

Entwicklung

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

Siehe CONTRIBUTING.md für Richtlinien.

Canary-Health-Check

Ein Canary-Skript übt jedes verfügbare MCP-Tool aus und meldet bestanden/nicht bestanden. Es läuft automatisch nach einem Cron-/Task-Scheduler-Zeitplan, um Regressionen zu erkennen, bevor Benutzer sie bemerken.

# 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

Was es tut:

• Startet den ContextPulse-Daemon automatisch, falls er nicht bereits läuft

• Ruft alle primären MCP-Tools mit minimalen gültigen Argumenten auf

• Gibt eine menschenlesbare Zusammenfassung mit Aufschlüsselung pro Server aus

• Hängt Ergebnisse an logs/canary_results.json an (letzte 100 Läufe werden behalten)

• Beendet mit 0, wenn alle Tools bestehen, 1, wenn eines fehlschlägt

Zeitplanung (Windows Task Scheduler):

1. Task Scheduler öffnen → Basisaufgabe erstellen

2. Auslöser: Täglich, Wiederholung alle 4 Stunden

3. Aktion: Programm starten

   • Programm: <Pfad-zu-contextpulse>\.venv\Scripts\python.exe

   • Argumente: scripts/canary_health_check.py

   • Starten in: <Pfad-zu-contextpulse>

Lizenz

ContextPulse ist unter der GNU Affero General Public License v3.0 (AGPL-3.0) lizenziert.

• Sie können ContextPulse frei verwenden, modifizieren und verbreiten

• Wenn Sie es modifizieren und als Dienst bereitstellen, müssen Sie Ihre Änderungen als Open Source veröffentlichen

• Kommerzielle Lizenzen für die Einbettung in proprietäre Produkte verfügbar

Für kommerzielle Lizenzanfragen besuchen Sie contextpulse.ai.

Patenthinweis

Das vereinheitlichte multimodale Kontextbereitstellungssystem von ContextPulse ist patentrechtlich angemeldet.