Troubleshooting

Usually a temporary network or feed issue. Open Settings → Software Update and select Retry once connectivity is restored. Downloaded updates are checksum-verified, so a failed check never applies a bad update.

The stable channel may not be newer than what you have yet. New releases roll out to the stable feed; if you just saw a release announced, give it a few minutes and Check now again.

If you are on 0.1.0 or 0.1.1, this is a known bug, and clicking again will not help. The update downloads and verifies correctly, but the app fails to quit, so the install never runs.

It is fixed in 0.1.2. Because the fix has to be in the version doing the updating, it cannot reach you through the update itself — download the latest .dmg from Releases and drag it over your existing install. Chats and settings are preserved, and in-app updates work from then on.

On 0.1.2 or later, reopen Agent Relay from Applications; your previous version stays installed and nothing is lost by staying on it.

Agent Relay only lists agent CLIs found on your PATH. Install the agent (for example Claude Code, Codex, Gemini, or Kimi), then reopen Settings → Agents to re-scan. The row lights up once the CLI is detected.

Confirm the selected agent is available in Settings → Agents, and that it's signed in / authorized in its own CLI. Agent Relay launches the agent as a managed run, if the underlying CLI can't run, the chat can't start.

Agent Relay is notarized, so it should open without warnings. Make sure you dragged it into Applications and are opening it from there (not from inside the mounted disk image). Re-download from the Download button if the file was interrupted.