AI Completion Notifier - Boomerang

Boomerang Notifier is a VS Code / Cursor extension that alerts you when AI output is complete through multiple notification channels.

For Chinese documentation, see README.zh-CN.md.

✨ Features

• Detects AI activity from editor changes and chat generation events.
• Sends notifications via multiple channels: PushPlus, ServerChan Turbo, Webhook channel, Bark, WxPusher, ntfy.sh, and Telegram.
• Supports keyword suffix in targetValue with format main|your_keyword.
• Shows clear in-app warnings when channel config is invalid or missing.
• One-click monitoring control from the status bar with friendly emoji UI messages.
• English and Simplified Chinese UI messages (auto-detected from IDE language).

🧩 Compatibility

• VS Code < 1.90 is not supported.
• On VS Code, Boomerang supports chat lifecycle signals from:
  • GitHub Copilot Chat.log (exthost/GitHub.copilot-chat/GitHub Copilot Chat.log)
  • Codex.log (exthost/openai.chatgpt/Codex.log)
• Claude local sessions:
  • ~/.claude/projects/**/*.jsonl (new file = session start; appended lines = activity; idle timeout = session end)

⚙️ Configuration

Set these in Settings (search boomerang):

• boomerang.pushChannel
  Select your push channel.
• boomerang.targetValue
  Channel target value. Supports main|keyword.
• boomerang.idleTimeout
  Idle timeout threshold in milliseconds.
• boomerang.claudeIdleSeconds
  Claude JSONL session idle timeout in seconds (default 600).
• boomerang.notificationTemplate
  Custom completion notification template ({source} supported).

🚀 Usage

1. Install the extension.
2. Configure boomerang.pushChannel and boomerang.targetValue.
3. Run Boomerang: Toggle Monitoring from Command Palette.
4. Start an AI coding/chat task.
5. When AI output ends, Boomerang sends a notification via your configured channel.

🛠️ Debugging

If notifications are not delivered:

1. Open View: Output.
2. Select Boomerang in the channel dropdown.
3. Check webhook response logs (status, errcode, errmsg).

☕️ Support the Author

Boomerang is a free and open-source extension. If it has saved you from staring at the screen for hours and allowed you to grab a coffee in peace, consider buying me one! Your support is my motivation to keep maintaining and developing new features.