Skip to content

whoisyurii/microtaskrr

Repository files navigation

icon microtaskrr

Mini-games that pop up while Claude Code thinks.

Built with Tauri v2 · macOS only (for now)

Waiting 5–60 seconds for Claude Code to respond? Play a quick typing test, solve some math, or chase a snake — right from a lightweight menu-bar app that hooks into Claude Code and pops up a random game every time you send a prompt.

No Dock icon. No window management. Just a tray icon that stays out of your way until it's game time.

🎮 Games

Game What it does
Typing Test Monkeytype-style — type words, see your WPM and accuracy
Math Mental arithmetic — addition, subtraction, multiplication, division
Snake Classic snake on a canvas — arrow keys or WASD
Reaction Wait for green, click as fast as you can
Memory Flip cards and match pairs before time runs out
Stroop Name the ink color, not the word — tests your focus

A random game is picked each time (never the same one twice in a row). Stats persist across sessions.

More games coming — this project is actively expanding.

📦 Install

Homebrew (recommended)

brew install whoisyurii/tap/microtaskrr
brew services start microtaskrr

This installs the binary, configures Claude Code hooks, and starts the background service.

Shell script

curl -fsSL https://raw.githubusercontent.com/whoisyurii/microtaskrr/main/install.sh | bash

That's it. Open a new Claude Code session, send a prompt, and a game appears.

Press Esc to dismiss and return to your terminal.

🖥️ Status bar & no Dock

The app does not appear in the macOS Dock. It lives in the menu bar (status bar) as a tray icon.

You can pause it by choosing "Sleep for..." from the tray menu (30 min, 1 h, 2 h, 4 h, 8 h).

🔧 Build from source

Requires Rust and Node.js 18+.

git clone https://github.com/whoisyurii/microtaskrr.git && cd microtaskrr
npm install
npm run build
cd src-tauri && cargo build --release && cd ..

Then install:

mkdir -p ~/.local/bin
cp src-tauri/target/release/microtaskrr ~/.local/bin/microtaskrr

And add the hooks to ~/.claude/settings.json:

{
  "hooks": {
    "UserPromptSubmit": [
      {
        "matcher": "",
        "hooks": [
          {
            "type": "command",
            "command": "~/.local/bin/microtaskrr show &"
          }
        ]
      }
    ],
    "PreCompact": [
      {
        "matcher": "",
        "hooks": [
          {
            "type": "command",
            "command": "~/.local/bin/microtaskrr show &"
          }
        ]
      }
    ]
  }
}

Start the background process:

~/.local/bin/microtaskrr &

⚙️ How it works

Claude Code CLI                    microtaskrr (Tauri app)
     |                                  |
     | UserPromptSubmit hook            |
     |--- microtaskrr show ----------->| show window, start random game
     |                                  |
     | PreCompact hook                  |
     |--- microtaskrr show ----------->| (also triggers on context compaction)
     |                                  |
     | (Claude thinking...)             | (user plays game)
     |                                  |
     |                                  | user presses Esc
     |                                  | hide window, restore focus to terminal
  • Tauri v2 app with system tray, persistent background process
  • Single-instance plugin forwards CLI args (show/hide) to the running process
  • Claude Code hooks trigger show on every prompt submission and context compaction
  • User dismisses with Esc when done (focus returns to terminal automatically)

🗺️ Roadmap

  • More mini-games — actively expanding the game library
  • Linux and Windows support
  • Codex CLI integration (alongside Claude Code)

If you're an early adopter on macOS, I'd love your help testing. Bug reports, edge cases, weird setups — anything you find helps. Open an issue or reach out.

⚠️ Known issues

Game flickering during Claude Code UI glitch — Claude Code has a known terminal flickering bug that can cause hooks to fire rapidly. When this happens, microtaskrr will keep popping up new games in quick succession. This is a Claude Code issue, not a microtaskrr bug. If it happens, click the tray icon and choose Quit, or pick Sleep for... to pause it until the flickering stops.

🗑️ Uninstall

If installed via Homebrew:

brew services stop microtaskrr
brew uninstall microtaskrr

If installed via shell script:

curl -fsSL https://raw.githubusercontent.com/whoisyurii/microtaskrr/main/uninstall.sh | bash

📄 License

MIT — see LICENSE.

About

Microtask while waiting for Claude Code!

Topics

Resources

License

Stars

Watchers

Forks

Sponsor this project

Packages

 
 
 

Contributors