Interlude

✨ Highlights

• 🧠 Learn while you wait — spaced-repetition flashcards (Leitner boxes 1–5) surface the words you're about to forget, and speak them aloud on demand.
• 🎮 Word games + Arcade — four quick word games (Definition Quiz, Word Scramble, Hangman, Vocab Wordle) plus a full-screen Arcade with a vendored, MIT-licensed 2048 that saves and resumes mid-game — stop halfway, pick up right where you left off.
• 📱 Social, in the window — a quick pick of Instagram · X · TikTok, opened right inside the popup for a genuinely mindless glance while you wait.
• 🎛️ State-aware attention routing — Interlude sees why Claude stopped and reacts differently: done (violet, counts down and closes), needs input (amber, closes so you can reply), permission (red, flashes then closes), error (red, stays open with the last line). Optional matching macOS chimes.
• 🕶️ Snooze / focus — one click (or interlude snooze 1h|3h|8h) mutes the popup and sounds, then auto-resumes.
• 📈 Progress you can see — streaks, mastery gauge, review history, and per-box charts.
• 🪄 Zero friction — appears on its own while Claude thinks, closes on its own when Claude's done, and reopens right where you left it.
• 🕶️ No Dock icon, no menu bar — a native WKWebView popup, not a browser tab or PWA.
• 🔒 Fully local — no accounts, no telemetry, no dependencies. Everything runs on 127.0.0.1.
• 🌗 Light & dark — a clean violet theme, day or night.

🚀 Install

As a Claude Code plugin (recommended):

claude plugin marketplace add hamedvali/interlude
claude plugin install interlude@interlude

Upgrades come through claude plugin update interlude.

Or with the installer script:

curl -fsSL https://raw.githubusercontent.com/hamedvali/interlude/main/install.sh | bash

This one registers the hooks itself, installs an interlude CLI, and keeps itself up to date.

Either way, restart Claude Code. That's it — next time Claude runs for more than a few seconds, Interlude appears. ✨

Both routes keep your progress in ~/.interlude, so you can switch between them without losing a streak. Pick one, though — installing both registers the hooks twice.

[!NOTE] macOS only. Requires python3 and osascript, both of which ship with macOS. The window is a native WKWebView popup — no browser, no PWA, no Dock icon.

📸 A look inside