Claudle

🦞🎮🦞

A daily word game for people who stare at terminals while Claude thinks.

Built with love (and mild impatience) by @bobberrisford — who got tired of watching Claude's spinner and thought "what if I could play a word game while I wait?"

"I got Claude to build me a game to play while Claude builds me things. We've reached peak recursion."

Play it right now

npx claudle

That's it. No install. No config. Just vibes and five-letter words.

What is this

Claudle is a daily word game that automatically pops up in a new terminal window when you start a Claude Code session. Same word for everyone on earth, every day. Play it. Fail at it. Share your shame on X.

Features

• One word per day — same word for everyone worldwide
• Auto-launches via Claude Code hooks — pops up when Claude starts editing/writing code (works in both terminal and Desktop)
• Shareable results — emoji grid + link copied to clipboard on game end
• Stats & streaks — tracks your wins, streaks, and guess distribution
• Works offline — bundled word list, zero network calls
• 🦞 — vibes

Install permanently

npm install -g claudle

Then set up Claude Code integration:

claudle --setup

This adds hooks to ~/.claude/settings.json so Claudle launches automatically when you start a Claude Code session and closes when it ends.

Manual hook setup

If you prefer to do it yourself, add this to ~/.claude/settings.json:

{
  "hooks": {
    "PreToolUse": [{
      "matcher": "Edit|Write|Bash|Agent|NotebookEdit",
      "hooks": [{ "type": "command", "command": "claudle --launch" }]
    }],
    "SessionEnd": [{
      "matcher": "",
      "hooks": [{ "type": "command", "command": "claudle --stop" }]
    }]
  }
}

Sharing

When you win (or lose), Claudle copies your result to the clipboard:

Claudle #439  3/6  🦞
⏱️ Claude was coding for 2:34

🟩🟨⬛⬛🟩
🟩⬛⬛⬛🟩
🟩🟩🟩🟩🟩
🔥 5 streak

npx claudle

Paste it on X. Paste it in Slack. Paste it in your PR description. We don't judge.

CLI

claudle              Play today's Claudle
claudle --launch     Open in a new terminal window
claudle --stop       Stop a running instance
claudle --setup      Install Claude Code hooks
claudle --help       You're reading the vibe of this already

The story

I use Claude Code every day. It's incredible. It's also slow sometimes. And in those moments — those 30-second to 3-minute stretches where Claude is off thinking about your codebase — you just... sit there.

So I did what any reasonable person would do: I asked Claude to build me a game to play while Claude works. The snake eats its own tail. 🦞

Tech

• TypeScript + Ink (React for the terminal)
• Zero external APIs — everything bundled
• Claude Code hooks for automatic launch/stop

License

MIT — do whatever you want. 🦞