CLIDesktop

Menu bar

Closing the Agent Relay window does not stop your work. The window hides, the runtime stays up, and your agents keep going. The menu bar is where that work lives while you cannot see it.

Click the Agent Relay mark in the menu bar to open it.

What needs you

A run that has asked permission to do something is stopped until you answer. That is the one thing worth interrupting for, so it sits at the top and the icon carries a count while it waits:

2 runs are waiting on you claude wants to run "npm publish --access public" An agent wants to use Bash

Clicking a row opens that conversation at the request. You cannot approve from the menu itself, and that is deliberate: granting a command is a decision that needs the surrounding context, not one line of text next to Quit.

The count clears the moment you answer, and it counts runs, not requests. One agent asking about three commands at once is still one run waiting on you.

What is working

Every conversation with something in flight, named by the agent actually doing the work:

Working (2) claude · Fix the retry test in auth.py · agent-relay codex subagent · Audit the renderer tests · iris

A subagent or reviewer shows here too, even when the conversation that owns it has otherwise finished. Clicking a row brings that chat back on screen.

A conversation that is waiting on you appears above, not here. It is doing nothing until you answer, so calling it "working" would be untrue.

Usage limits

This section stays silent while your agents have room. It appears once one of them is close enough to a limit that Agent Relay has started planning around it:

claude is at 91% · Resets Tue 3:40 PM gemini will continue if claude runs out

The second line is the useful one. Agent Relay decides who takes over before the limit is reached, while the running agent still has the quota to say what is left to finish. See Chats & agents.

That line only appears when On rate limit is set to Switch agent. With Stop, nothing takes over, so nothing is promised.

Recent chats, and starting a new one

Below that, the conversations you have used most recently, and a shortcut to start a new chat in any workspace you have been working in:

New chat New chat in agent-relay New chat in iris

Picking one opens the composer already pointed at that folder.

When an update is ready

Because the app is built to sit in the background, an available update is easy to miss. Once one is downloaded and verified, Restart to update appears in the menu. See Updating.

Quitting

Quit Agent Relay stops everything it started: your runs, and any subagents, reviewers, or race participants working alongside them. Nothing is left running against your repository once the app is gone.