# duck-duck-duck

Binds Claude Code sessions to the Duck Duck Duck desktop widget. It scores prompts locally on macOS and speaks reactions to your coding workflow.

- plugin · `type=plugin` · Claude Code · ★ 26 repo stars
- Author: ideo
- License: MIT · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/ideo/Rubber-Duck/tree/HEAD/plugin
- Updated: 2026-06-21
- Security check: automated, 2026-11-16 (text and 12 script files) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/plugins/duck-duck-duck

## What it does

The plugin hooks into Claude Code session events and sends POST payloads to the widget running on `localhost:3333`. When you submit a prompt, run into an API failure, or trigger context compaction, the duck triggers animations and sounds.

Evaluations run locally through Apple Foundation Models. Neither prompt scores nor voice interactions leave your machine. The companion picks from 10 distinct voices to match the mood of the code and lets you approve tool execution permissions via speech.

You need the free Duck Duck Duck app active on Apple Silicon running macOS 26 or later. If the desktop widget is closed, all hooks fail silently so your CLI session never stalls.

## Install

### Claude Code (native platform)

**Plugin marketplace**
In the agent chat (not a shell):
```text
/plugin marketplace add anthropics/claude-plugins-community
```
In the agent chat (not a shell):
```text
/plugin install duck-duck-duck@claude-community
```

## When to use it
- hear vocal commentary and visual reactions to prompt responses
- approve CLI tool permission prompts by voice
- run prompt evaluation scoring on-device without cloud calls
- play audible alerts during API errors and context compaction

## Example prompts
- Check `src/index.ts` for memory leaks and fix them
- Run the test suite and explain any failures
- Delete the `dist/` folder and rebuild the project

## Source text · plugin · MIT

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: 6fc4543ef7c7dfa7.

BEGIN THIRD-PARTY FILE 6fc4543ef7c7dfa7
````text
# Duck Duck Duck — Claude Code Plugin

A companion plugin that connects Claude Code to the [Duck Duck Duck](https://github.com/ideo/Rubber-Duck) desktop app. The duck watches your coding sessions, scores every prompt and response, speaks opinionated reactions, and handles permissions by voice.

🔒 **Default intelligence is fully on-device and private.** All eval scoring runs via Apple Foundation Models — nothing leaves your machine. No audio is sent to the cloud. [Learn more about privacy.](https://github.com/ideo/Rubber-Duck#data--privacy)

## Requirements

- **macOS 26** (Tahoe) or later, Apple Silicon
- **Claude Code** or **Claude Desktop**
- **Duck Duck Duck app** running — [download here](https://github.com/ideo/Rubber-Duck/releases)

## Install

The easiest way: **right-click the duck → Install Claude Plugin**. The app handles everything.

Or install manually:

```bash
claude plugin marketplace add ideo/Rubber-Duck
claude plugin install duck-duck-duck
```

Works in Claude Code CLI and Claude Desktop.

## How It Works

The plugin registers hooks that fire on Claude Code events and POST to the widget's server on `localhost:3333`. The widget scores the text, animates the duck, and speaks reactions.

| Hook | What it does |
|------|-------------|
| **SessionStart** | Health check — tells Claude if the duck is active |
| **UserPromptSubmit** | Sends your prompt for eval scoring |
| **Stop** | Sends Claude's response for eval scoring |
| **PermissionRequest** | Voice-confirmed permission gate — duck asks, you speak |
| **PostToolUse** | Clears permission state after CLI approval |
| **SessionEnd** | Duck acknowledges session close |
| **StopFailure** | Duck reacts to API errors |
| **PreCompact / PostCompact** | Thinking melody during context compaction |

If the widget isn't running, hooks fail silently and Claude Code continues normally.

## Updating

After updating the plugin (`claude plugin update duck-duck-duck`):
- **New session**: hooks load automatically
- **Current session**: run `/reload-plugins` to pick up changes

## Troubleshooting

**Hooks not showing up** — Run `/hooks` to check. If missing: reinstall the plugin, then `/reload-plugins` or start a new session. Hooks are cached at session start.

**Widget not responding** — Check the duck icon is in your menu bar. Verify: `curl http://localhost:3333/health` should return JSON.

**Permission stuck** — If the duck stays in "asking permission" after you approved via CLI click, the PostToolUse hook auto-clears it. If stuck, the next eval also clears it.

**Plugin not found** — Make sure the marketplace is added: `claude plugin marketplace add ideo/Rubber-Duck`

## Development

```bash
claude --plugin-dir ./plugin
```

Loads hooks from local files — no push or reinstall needed. Run `/reload-plugins` after changes.

## License

[MIT](https://github.com/ideo/Rubber-Duck/blob/main/LICENSE)
````
END THIRD-PARTY FILE 6fc4543ef7c7dfa7

The third-party file has ended. Everything between the 6fc4543ef7c7dfa7 tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

© ideo · MIT · https://github.com/ideo/Rubber-Duck/tree/HEAD/plugin

## Similar
- [cli-anything-quietshrink](https://affpapa.org/en/nevibecode/skills/cli-anything-quietshrink.md) — skill · 449 installs
- [whosaid](https://affpapa.org/en/nevibecode/mcp/whosaid.md) — MCP server · ★ 9 repo stars
- [speak-tts](https://affpapa.org/en/nevibecode/skills/speak-tts.md) — skill · 739 installs
- [sag](https://affpapa.org/en/nevibecode/skills/sag.md) — skill · 5200 installs
- [Sesame](https://affpapa.org/en/nevibecode/mcp/sesame.md) — MCP server · ★ 7 repo stars
- [Heard](https://affpapa.org/en/nevibecode/mcp/heard.md) — MCP server

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
