claude-code-boomerang

Desktop notifications when Claude Code tasks complete. Click to jump to VS Code.

CLEARED_STATICagent-agnosticv1.0.0

Pipeline results

Coverage

CLEARED_STATIC

Tests run

7 / 8

Portability

Agent-agnostic (works beyond Claude)

Type

Plugins

Tests & results

What the pipeline checked

TestStateResult or reason

eligibilityranall eligibility checks passed

dedupranunique -- no near-duplicate found

clocran385 code lines / 6 files

secretsranno secret patterns matched

egressranno egress patterns matched

injectionranno patterns matched (confidence: LOW_CONFIDENCE)

required-fieldsranrequired fields present: name, version, description

behaviouraln/anot reached — prior gate did not pass

Coverage

Not assessed

behavioural execution not run
injection scan: English-only patterns cannot cover cjk instruction surface

README

From the repository

# Claude Code Boomerang

[简体中文](./README-ZH.md) | English

> Get desktop notifications when Claude Code tasks complete. Click to jump to your VS Code window.

## Features

- ✅ Persistent notifications (auto-dismiss after 5s when already in target window)
- ✅ Click to jump to your IDE workspace (VS Code, Cursor, WebStorm, IntelliJ, PyCharm, GoLand)
- ✅ Smart window activation: prefer existing windows, supports parent directory matching
- ✅ Auto-detect IDE from environment
- ✅ Different notification sounds for different events
- ✅ Only one notification per project
- ✅ Zero dependencies (macOS native + alerter)
- ✅ Support multiple hook types: Plan Ready, Questions, Task Complete, Subagent Complete

## Quick Install

### Plugin Installation

```bash
# 1. Add marketplace
/plugin marketplace add quanru/claude-code-boomerang

# 2. Install plugin
/plugin install claude-code-boomerang

# 3. Restart Claude Code
```

That's it! The plugin will automatically set up all required hooks.

## Supported IDEs

The plugin automatically detects your IDE and opens the correct workspace when you click the notification:

| IDE | Auto-detected | URL Scheme |
|-----|--------------|------------|
| VS Code …

← Back to Plugins