pi-chucknorris

Latency-gated Chuck Norris jokes while pi is thinking (before the first token).

Package details

← Back
extension

Install pi-chucknorris from npm and Pi will load the resources declared by the package manifest.

npm repohome report
$ pi install npm:pi-chucknorris
Package
pi-chucknorris
Version
0.2.0
Published
Apr 21, 2026
Downloads
122/mo · 7/wk
Author
jrryfn
License
MIT
Types
extension
Size
86.7 KB
Dependencies
0 dependencies · 1 peer
Pi manifest JSON
{
  "extensions": [
    "./extensions/chuck-thinking-toast.ts"
  ]
}

Security note

Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.

README

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