Claude Code and Codex often take a few minutes on a task. In that time I either stare at the spinner, or switch to another tab and forget to come back for ten minutes.
So I built Agent Arcade : tiny terminal games to play during the wait. The useful part isn't the game. It's that the game pauses and tells you the moment your agent is done or needs you , so the break never runs long.
This post is about how that works, because the same trick (an agent hook that writes a file, something else that watches it) is handy for a lot more than games.
The idea: hooks plus one file
Claude Code can run a command at certain moments of a session. Three of those moments matter here:
Hook Fires when Agent Arcade says
Stop Claude finishes its turn "done"
PermissionRequest Claude shows a permission prompt "ask"
Notification other "waiting for you" moments, like an idle prompt "ask"
Each hook runs one tiny command, agent-arcade notify or agent-arcade notify ask .…