Stop checking the terminal
Give an agent a task, go do something else, and come back when it's your move instead of every few minutes.
When the agent finishes
The bubble turns green and a notification says which project is waiting and how long the turn took.
When it's blocked
A permission prompt or a question turns it amber, so a task doesn't sit for twenty minutes on a yes or no.
Every agent at once
Claude Code, Codex, Gemini CLI and Devin sessions share one menu, most urgent first. Click one to bring its terminal to the front.
Quiet while you watch
Turns under 30 seconds and prompts you answer within 8 seconds don't notify. You were already looking.
Sets itself up
It connects to each agent it finds installed, including ones you add later, and leaves the rest of their settings as they were.
Light
Under 1 MB on disk and about 2 MB of memory. The hook it runs finishes in around 50 ms.
Read it at a glance
With several sessions open, the bubble shows the most urgent one.
How it works
Claude Code, Codex, Gemini CLI and Devin can each run a command on certain events, called hooks. Sua Vez registers itself for the ones that matter, from a prompt being submitted to a session ending.
- The agent runs
suavez hookand passes it the event. - That process writes a small file for the session and pokes the tray.
- The tray rereads the files and repaints the bubble.
The hook always exits cleanly, so a failure in Sua Vez never stops an agent. When it edits an agent's settings, it only touches its own entries. Your other hooks and settings keep their place. Devin needs nothing extra: it reads Claude Code's hooks.
Disconnect any time from the menu, or with suavez uninstall in a terminal.
Install
| Windows installer | SuaVez-Setup.exe |
| winget | coming soon |
| Chocolatey | coming soon |
| macOS | SuaVez.dmg (Apple silicon and Intel) |
| Homebrew | brew install --cask kidchenko/tap/suavez |
Windows 10 or later, macOS 11 or later, and at least one of Claude Code, Codex, Gemini CLI or Devin. Under 1 MB, no runtime to install. Launch it once after installing, and restart any agent sessions that were already open.
