Something to do while your AI thinks
You hit enter. The answer takes a minute or two. That is exactly long enough to open one tab and come back twenty minutes later.
Meanwhile puts a tiny card in the corner of your screen instead: a stretch, a sum, a glass of water. When the answer's ready, it taps you on the shoulder.
Free · MIT · runs locally · no telemetry
You hit enter.
Claude Code and Codex already know when a prompt goes out and when the answer comes back. They'll tell anyone who asks with a hook. Meanwhile asks.
No polling, no screen reading. The installer merges four small entries into your settings file, keeps a timestamped backup, and leaves your other hooks exactly where they were.
The hook is silent, gives up after 0.8 seconds and always exits 0. It can't slow your agent down or break it, even when the app isn't running.
Codex trusts hooks one at a time, so you approve these once with /hooks. It's careful like that.
"UserPromptSubmit": [{ "hooks": [{
"type": "command",
"command": "…/meanwhile-hook start --from claude"
}]}],
"Stop": [{ "hooks": [{
"type": "command",
"command": "…/meanwhile-hook done --from claude"
}]}],
// StopFailure and SessionEnd call "cancel",
// so a crashed turn doesn't leave it waiting.
or by hand meanwhile-hook setup claude meanwhile-hook setup codex
Nothing happens.
On purpose. Meanwhile waits five seconds before it shows anything. If the agent answers sooner, you never see a card. Quick answers don't get an intermission.
A card shows up.
That's the actual overlay code running in this page, not a recording. Pick one and poke it.
- 60 seconds or less, every one
- Any corner, always on top, no taskbar button
- Never grabs your keyboard focus by itself
- Ctrl+Alt+Space toggles it, Esc closes it
Your answer's ready.
The card flips, holds for a couple of seconds and fades. Closed it already? It comes back, just for this.
If you answered the “what will you check first?” card, your own line is shown back to you here. Then you go and look at it.
An agent that gets interrupted never says “done”, so Meanwhile gives up waiting after 15 minutes.
Agent on another machine? Fine.
I run Hermes Agent on a Linux box. The card pops up on my Windows laptop. The Hermes plugin runs meanwhile-hook start and done on the laptop over SSH, so the overlay shows up wherever you're sitting, not wherever the agent is.
Anything else with a shell works the same way: another agent, a build script, a test run that takes long enough to get coffee.
- Claude Code
- Hooks, connected by the installer.
- Codex
- Same, in
hooks.json. CLI and desktop app read the same file. - Hermes Agent
- A small plugin in the repo. Telegram turns by default, over SSH.
- Anything else
meanwhile-hook start/done/status
Next prompt.
One line, no admin rights. It checks the SHA-256, installs, connects Claude Code and Codex if it finds them, and starts the tray app.
irm https://github.com/maxjustships/meanwhile/releases/latest/download/install.ps1 | iex
PowerShell. Tested on Windows 10 with the Claude Code and Codex CLIs.
The binaries aren't code-signed, because signing costs money and this is a free project. SmartScreen may say “unknown publisher”: More info, then Run anyway. Or read the source and build it yourself, it's Rust and plain HTML.
Uninstall removes only Meanwhile's own hooks and keeps your settings.