smoking-gun

smoking-gun 🔫

A Claude Code plugin that plays a revolver cylinder spin followed by a gunshot whenever Claude says "smoking gun" in a response.

That's it. That's the plugin.

Requirements

• macOS — playback uses afplay. Linux/Windows would need a different player (PRs welcome).
• Bun — the hook script runs on Bun. Without it the hook silently no-ops.
• Claude Code 2.x or later.

Install

claude plugin marketplace add anthonymadhvani-lf/smoking-gun
claude plugin install smoking-gun@smoking-gun

Restart Claude Code, then ask Claude to find a smoking gun.

How it works

There is no "assistant said X" event in Claude Code, so the plugin uses a Stop hook — it fires after every response and receives the session transcript path:

1. hooks/hooks.json registers the hook, pointing at scripts/run-hook.sh.
2. run-hook.sh resolves Bun by absolute path (hooks can run with a minimal PATH) and execs the detector.
3. scripts/smoking-gun-hook.ts walks the transcript backwards, collecting only the assistant's text from the final turn (tool results also appear as user-type lines and are skipped, so the sound never triggers on something you said). If /smoking\s+gun/i matches, it plays the spin → shot sequence detached, so your next prompt is never delayed.
4. The final assistant message can land in the transcript a beat after the Stop hook fires, so a failed first scan retries once after 400 ms.

Each run writes a one-line breadcrumb to /tmp/smoking-gun-last.log (match=true attempt=2) for easy debugging.

Uninstall

claude plugin uninstall smoking-gun@smoking-gun
claude plugin marketplace remove smoking-gun

Credits

Sound effects by freesound_community via Pixabay (revolver spin, single pistol gunshot). Code is MIT licensed; the sounds remain under the Pixabay Content License.