Know when Claude Code needs you
You do not have to watch the wall. claude-garage tells you when a Claude Code session needs you. It shows it on screen, and with the built-in alerts plugin it also makes a sound and a desktop banner.
How does the wall show that a session needs me?
Section titled “How does the wall show that a session needs me?”The tile turns amber. Amber means one thing: Claude waits for your answer. The rail row and the project tab turn amber too, so you can see it from any project.
- Press
ato jump to the session that has waited the longest. Your next key goes straight to Claude. - Press
Ato open the triage queue of every waiting session, longest wait first.Enterjumps to the selected one.
The run many sessions guide covers both keys in detail.
How do I see which session finished?
Section titled “How do I see which session finished?”A session that finishes while you look at another one is marked as unseen until you focus it:
- Its rail row gets a green bar and a green
✓. - Its project gets a green dot in the rail, so you can see it from any project.
- When no session waits for you,
ajumps to the newest finished session you have not seen.
A finished session you have already seen is dim. Working sessions are dim too, so only sessions that need you or finished unseen stand out.
What does the alerts plugin do?
Section titled “What does the alerts plugin do?”alerts is one of the built-in plugins. It is on by default. It makes:
- A chime of two rising notes when a session needs you.
- One soft note when a session finishes a turn that ran 20 seconds or more. It waits 8 seconds first and stays silent if Claude went back to work in that time.
- A note in the wall’s footer that names the session, such as
✓ api · fix login finished · a to jump. It shows for every alert, also when garage is in view and no banner shows. - A desktop banner when garage is not the focused window, such as “fix needs you” with Claude’s own message.
Sessions that need you within two seconds of each other make one chime and one banner.
How do I change the alerts?
Section titled “How do I change the alerts?”Run claude-garage alerts to see the options.
claude-garage alerts # show the optionsclaude-garage alerts sound off # no chime (on | off)claude-garage alerts needs-input off # no alert when a session needs youclaude-garage alerts done off # no alert when a session finishesclaude-garage alerts banners off # chime only, never a bannerclaude-garage alerts test # play both chimes and show a sample bannerclaude-garage alerts terminal auto # app a clicked banner brings forward (or a bundle id)Use claude-garage alerts test after a change to hear and see the result.
Can I click a banner to jump to the session?
Section titled “Can I click a banner to jump to the session?”On macOS, yes. Click a banner to jump to the session (needs brew install terminal-notifier). The click brings your terminal forward and the wall focuses that session. When several sessions need you, it focuses the one that has waited the longest. Without terminal-notifier you still get the banner, but a click does nothing.
claude-garage finds your terminal on its own (Ghostty, iTerm2, Terminal, WezTerm and kitty). For another one, give its bundle id: claude-garage alerts terminal com.example.term. Use auto to go back.
How do I turn alerts off completely?
Section titled “How do I turn alerts off completely?”Press p in the wall to open the plugin list. Switch alerts off. claude-garage will not turn it back on.
How do I make the status instant?
Section titled “How do I make the status instant?”Press I in the wall to install the Claude Code hooks. This gives instant status, so a session shows as waiting as soon as Claude asks. The same step installs the context meter.