GitHub – cyrus-cai/livepipe

Low-Key Preview — This version is unstable and underperforms; for research and testing only.

A real-time screen content analysis tool powered by Screenpipe + local LLM (Ollama). It watches your screen and sends desktop notifications when it detects actionable items — todos, reminders, meetings, deadlines.

git clone https://github.com/cyrus-cai/livepipe.git
cd livepipe
bun install

# Pull the default LLM model
ollama pull qwen3:1.7b

# Copy config template
cp config.template.json config.json

# Start dev mode (auto-manages Screenpipe + Ollama via PM2)
bun run dev

The dev script will:

1. Check that Screenpipe, Ollama, and PM2 are installed
2. Start Screenpipe and Ollama as PM2 processes
3. Launch the Next.js dev server on http://localhost:3060
4. Begin polling screen content and sending notifications

Grant your terminal app the following permissions in System Settings -> Privacy & Security:

• Screen Recording — required by Screenpipe to capture screen content
• Notifications — required for desktop notifications

By default, LivePipe sends macOS desktop notifications via AppleScript.
You can also enable webhook push to third-party clients (for example Feishu or Telegram) in pipe.json:

{
  "notification": {
    "desktop": true,
    "webhooks": [
      {
        "enabled": true,
        "provider": "feishu",
        "url": "https://open.feishu.cn/open-apis/bot/v2/hook/your-hook"
      },
      {
        "enabled": true,
        "provider": "telegram",
        "url": "https://api.telegram.org/bot/sendMessage",
        "chatId": ""
      },
      {
        "enabled": true,
        "provider": "generic",
        "url": "https://your-webhook-endpoint.example.com/livepipe",
        "headers": {
          "X-Api-Key": "your-secret"
        }
      }
    ]
  }
}

• provider supports feishu, telegram, generic
• desktop: true keeps the existing macOS notification
• generic sends a JSON payload with title, body, type, dueTime, etc.

MIT