pi-chucknorris

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

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

Install (npm)

Important: install with pi install, not npm install.

pi install npm:pi-chucknorris

Then in pi:

/reload
/chucknorris status

Project-local install:

pi install -l npm:pi-chucknorris

Fast troubleshooting

• "Package not found"
  • Use the full package name: npm:pi-chucknorris
• Installed but /chucknorris is unknown
  • Run /reload (or restart pi)
• Old package name installed before
  • Remove old package, then reinstall:

pi remove npm:pi-chucknorris
pi install npm:pi-chucknorris

Why people love it

• Latency-gated (no flicker on fast replies)
• One joke per slow think (no spam)
• Cooldown + random arming
• Snooze that persists across restarts
• Safe mode for workplace-friendly joke filtering
• Autotune microcode adjusts gate based on real latency
• Easter eggs: latency bench + pi cheat sheet + ASCII Chuck

Commands

Happy path

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

Star features

• /chucknorris safe on|off|status — toggle workplace-safe filtering
• /chucknorris contribute — contribution/star call-to-action

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 ...

Notes

• State path: ~/.pi/agent/state/chuck-thinking-toast.json
• Only shows jokes before assistant output starts.

License

MIT