claude-comedy

Claude Comedy

Developer humor that lives inside your Claude Code sessions. No setup, no manual invocation — just laughs between tool calls.

Claude Comedy is a Claude Code plugin that hooks into the execution lifecycle and nudges Claude to crack a joke during natural idle gaps. Every joke is generated fresh by Claude itself — no predefined joke banks, infinite variety, fully contextual to what you're working on.

Install

npm install -g claude-comedy

That's it. The plugin registers itself automatically. If auto-registration fails (permissions, non-standard setup), run manually:

claude-comedy setup

How It Works

The plugin hooks into two Claude Code lifecycle events:

• PostToolBatch — after a batch of tool calls completes
• SubagentStart — when a subagent is spawned

When triggered, it checks a cooldown timer (default: 5 minutes). If enough time has passed, it classifies the situation (git, testing, deployment, etc.) and injects a prompt that nudges Claude to tell a contextual joke in a fun "mood bubble" format:

  👻 The Ghost of Deploys Past:
  ╭──────────────────────────────────────────────╮
  │ 47 files changed. On a Friday. At 4:59 PM.  │
  │ I too like to live dangerously.              │
  ╰──────────────────────────────────────────────╯

The jokes are situational — git operations get git humor, test runs get testing humor, and when the same category repeats too often, it switches to random topics to keep things fresh.

Configure

CLI

claude-comedy setup                       # Register plugin with Claude Code
claude-comedy unsetup                     # Unregister plugin
claude-comedy config                      # Show current config
claude-comedy config --cooldown 10        # Set cooldown to 10 minutes
claude-comedy config --style dry          # Set humor style
claude-comedy config --enable             # Enable
claude-comedy config --disable            # Disable (jokes stop immediately)
claude-comedy stats                       # Show joke count and stats
claude-comedy reset                       # Reset counter

Humor Styles

Control the tone of jokes with --style:

Style	Vibe
observational	Default. Relatable dev observations, occasional puns.
dry	Deadpan delivery. The funnier it is, the less it cares.
dad-jokes	Groan-worthy puns and obvious setups.
absurdist	Surreal, non-sequitur humor.

In Claude Code

Use the slash command:

/claude-comedy:config

Then tell Claude what you want: "set cooldown to 10 minutes", "switch to dad jokes", "show stats".

Uninstall

npm uninstall -g claude-comedy

To unregister without uninstalling: claude-comedy unsetup

How It's Built

• Zero runtime dependencies — only Node.js built-ins
• Ultra-lightweight — the engine checks cooldown and exits in ~10ms on the fast path
• Never blocks Claude — 5-second timeout ceiling, silent exit on any error
• State file at ~/.config/claude-comedy/state.json — persists across reboots
• Config file at ~/.config/claude-comedy/config.json

Situation Categories

Category	Detected from
git	git commands
testing	test, jest, pytest, vitest, etc.
searching	Grep/Glob tool usage
researching	WebFetch/WebSearch tool usage
exploring	Read tool usage
deployment	docker, kubectl, deploy, etc.
refactoring	Multiple Edit calls (no new files) in one batch
dependencies	npm install, pip install, etc.
delegation	Subagent spawned
build	tsc, make, cargo build, etc.
general	Fallback — anything goes

Contributing

PRs welcome! The codebase is small and focused:

• src/classifier.js — add new situation categories
• src/prompt.js — tweak the comedy prompt template and humor styles
• src/engine.js — the orchestrator (cooldown → classify → inject)

Run tests: npm test

License

MIT