ContextPulse

Предварительная версия для разработчиков (v0.1-alpha). ContextPulse находится в активной разработке. API и конфигурация могут меняться между релизами. Сообщить о проблемах.

ContextPulse — это фоновый процесс для рабочего стола, который в реальном времени захватывает ваш экран, голос и активность клавиатуры и мыши, а затем передаёт их ИИ-агентам через Model Context Protocol (MCP). Один процесс, одна иконка в трее, 35 MCP-инструментов, ноль зависимости от облака.

Всё остаётся локальным. Никакого облака. Никакой телеметрии. Ваши данные никогда не покидают вашу машину.

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

Быстрая демонстрация

> 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

Зачем нужен ContextPulse?

ИИ-ассистенты для программирования мощны, но слепы. Они не видят ваш экран, не слышат ваши голосовые заметки и не знают, чем вы только что занимались. ContextPulse устраняет этот разрыв:

• Локальный подход, ноль зависимости от облака. Ваш экран, голос и данные ввода никогда не покидают вашу машину. Никаких аккаунтов, подписок и сторонних серверов. Приватность архитектурой, а не политикой.

• MCP-нативный с первого дня. ContextPulse предоставляет весь контекст в виде MCP-инструментов. Любой MCP-клиент (Claude Desktop, Cursor, Windsurf, VS Code) получает полный контекст без кастомных интеграций.

• По-настоящему мультимодальный в одном процессе. Захват экрана, голосовой ввод, ввод с клавиатуры и мыши, а также семантическая память работают в одном лёгком процессе (<1% CPU). Никакой склейки нескольких инструментов.

• Открытый исходный код (AGPL-3.0). Полностью проверяемый, самохостируемый и расширяемый. Никакой привязки к вендору, никакой зависимости от SaaS, никакого риска закрытия из-за поглощения.

Чем ContextPulse отличается от других

Поддержка платформ

Установка

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

Настройте вашего ИИ-агента и установите сопутствующие навыки:

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

Запустите ContextPulse:

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

Всё готово. Ваш ИИ-агент теперь имеет инструменты для чтения вашего экрана, голоса, активности и памяти.

Добавьте в ~/.claude.json:

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

MCP-инструменты

Sight (11 бесплатных инструментов)

Voice (3 бесплатных инструмента)

Touch (3 бесплатных инструмента)

Project (5 бесплатных инструментов)

Memory (5 бесплатных + 2 Pro-инструмента)

Базовая память бесплатна навсегда. Лицензия не требуется.

Память использует трёхуровневую архитектуру hot/warm/cold: кэш LRU в памяти → SQLite WAL + FTS5 → сжатый архив. Опциональный пакет pip install contextpulse-memory поставляет эти инструменты.

Pro (4 инструмента, требуется лицензия или 30-дневная пробная версия)

Бесплатно навсегда: 27 инструментов (Sight × 11, Voice × 3, Touch × 3, Project × 5, Memory × 5) Pro: добавляет 4 инструмента поиска: семантический поиск по памяти плюс кросс-модальные запросы событий Пробная версия: 30-дневная пробная версия Pro при первом использовании, кредитная карта не требуется

Кроме того, ContextPulse включает несколько фоновых обучающих инструментов (консолидация словаря, обнаружение исправлений), которые работают автоматически, чтобы со временем улучшать качество транскрипции.

Архитектура

ContextPulse — это монорепозиторий с модульными пакетами:

Все модули отправляют события в общий EventBus («позвоночник»), который записывает их в локальную базу данных SQLite с полнотекстовым поиском FTS5. MCP-серверы — это процессы только для чтения, которые запрашивают эту базу данных.

Разработка

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

См. CONTRIBUTING.md для получения рекомендаций.

Проверка работоспособности Canary

Скрипт canary проверяет каждый доступный MCP-инструмент и сообщает о прохождении/непрохождении. Он автоматически запускается по расписанию cron/Task Scheduler, чтобы выявлять регрессии до того, как их заметят пользователи.

# 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

Что он делает:

• Автоматически запускает процесс ContextPulse, если он ещё не запущен

• Вызывает все основные MCP-инструменты с минимальными допустимыми аргументами

• Выводит понятное для человека резюме с разбивкой по серверам

• Добавляет результаты в logs/canary_results.json (сохраняются последние 100 запусков)

• Завершается с кодом 0, если все инструменты прошли, и 1, если какой-либо не прошёл

Планирование (Планировщик заданий Windows):

1. Откройте Планировщик заданий → Создать простую задачу

2. Триггер: Ежедневно, повторять каждые 4 часа

3. Действие: Запустить программу

   • Программа: <path-to-contextpulse>\.venv\Scripts\python.exe

   • Аргументы: scripts/canary_health_check.py

   • Рабочая папка: <path-to-contextpulse>

Лицензия

ContextPulse распространяется под лицензией GNU Affero General Public License v3.0 (AGPL-3.0).

• Вы можете свободно использовать, изменять и распространять ContextPulse

• Если вы изменяете и разворачиваете его как сервис, вы обязаны открыть исходный код своих изменений

• Доступно коммерческое лицензирование для встраивания в проприетарные продукты

По вопросам коммерческого лицензирования посетите contextpulse.ai.

Уведомление о патенте

Единая мультимодальная система доставки контекста ContextPulse находится в процессе патентования.