Agentwake

AgentWake

English | [简体中文](README.zh-CN.md)

A cross-editor AI programming notification gateway. Supports Cursor / Claude Code / Qoder. Real-time push notifications to desktop, mobile, and IM groups when AI tasks are completed, abnormally terminated, or waiting for authorization.

Preview

---

Core Features

• Multi-editor Support — Cursor Hook, Claude Code Hook, Qoder log listening
• Multi-channel Notifications — Desktop system notifications, PWA web push, DingTalk, Feishu, WeCom
• Claude Code Deep Integration — Supports all Hook events like Stop / Notification / StopFailure / SessionEnd, customizable notification titles for each event
• Mobile Real-time Push — Built-in PWA Web App, HTTPS + WebSocket millisecond push, supports QR code connection
• Smart Anti-disturbance — Event deduplication + rate limiting to prevent message bombing
• Interactive Configuration — agentwake setup guides you through all configurations step by step

---

Quick Start

Prerequisites

• Node.js >= 18
• mkcert (Generates local HTTPS certificates, required for mobile push)

Installation

npm i -g agentwake

Method 1: Interactive Guide (Recommended)

agentwake setup    # Interactive setup (~/.agentwake/.env, HTTPS/mkcert, Cursor hooks, Claude hooks, channels, …)

`setup` will guide you through:

1. Whether to enable HTTPS (optional mkcert certificates)
2. Select AI tools (Claude Code / Cursor / Qoder)
3. Select event types to listen to (Claude)
4. Customize notification titles for each event (optional)
5. Selec