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

<p align="center">
  <img src="docs/screenshots/web.jpg" width="48%" alt="Web Interface" />
  <img src="docs/screenshots/mobile_notify.jpg" width="48%" alt="Mobile Notification" />
</p>

<p align="center">
  <img src="docs/screenshots/cursor.png" width="48%" alt="Cursor Notification" />
  <img src="docs/screenshots/qoder.png" width="48%" alt="Qoder Notification" />
</p>

---

## 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](https://github.com/FiloSottile/mkcert) (Generates local HTTPS certificates, required for mobile push)

### Installation

```bash
npm i -g agentwake
```

### Method 1: Interactive Guide (Recommended)

```bash
agentwake setup    # Interactive setup (~/.agentwake/.env, HTTPS/mkcert, Cursor hooks, Cursor 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 (Cursor)
4. Customize notification titles for each event (optional)
5. Selec