pi-chucknorris

Latency-gated Chuck Norris jokes that render only when Pi is still thinking (before the first assistant token).

Why people star it:

• latency-gated → no flicker on fast replies
• one joke per slow think → no spam
• persistent snooze + cooldown
• optional safe mode for workplace-friendly filtering

Written in “assembly” because C couldn’t cut it. (ChuckASM microcode, executed by the TypeScript adapter.)

Install with Pi, not npm:

pi install npm:pi-chucknorris

Then in Pi:

/reload
/chucknorris status

Project-local install:

pi install -l npm:pi-chucknorris

• check it’s armed: /chucknorris status
• force a joke now: /chucknorris now
• safe mode (work-friendly): /chucknorris safe on
• snooze for 4 hours: /chucknorris nap 4h

Happy path:

• /chucknorris quick
• /chucknorris now
• /chucknorris nap 4h
• /chucknorris wake
• /chucknorris status

Star features:

• /chucknorris safe on|off|status
• /chucknorris contribute (CTA)

Advanced:

• /chucknorris mode office|stealth|unhinged|default
• /chucknorris curfew 22-8
• /chucknorris tune on|off
• /chucknorris pack <path>
• /chucknorris reload
• /chucknorris bench
• /chucknorris lint
• /chucknorris dx
• /chucknorris pi
• /chucknorris lore
• /chucknorris scroll

Aliases:

• /chuck ...
• /roundhouse ...

All user-facing configuration is via commands (mode/safe/curfew/tune/etc). Persistent state is stored at:

• ~/.pi/agent/state/chuck-thinking-toast.json

• state: ~/.pi/agent/state/chuck-thinking-toast.json

• Installed but /chucknorris is unknown
  • run /reload (or restart Pi)
• Never triggers
  • it only shows jokes before assistant output starts, and only after the latency gate is hit

Local dev install:

pi install -l <path-to-pi-chucknorris>

Release checklist:

• update CHANGELOG.md
• bump version: npm version patch
• npm publish

MIT