How it works
1
Your prompt submits with the selected agent
Normal path.
2
If the agent is unavailable
The provider returns an error (rate limit, outage, timeout). vly surfaces a notification.
3
vly suggests a fallback
“OpenAI Codex is currently unavailable. Run with Claude Code instead?”
4
You confirm or wait
Confirm: same prompt runs on the fallback agent. Wait: vly polls and notifies when the original agent is back.
Configuring auto-fallback
By default, vly asks before falling back. To make fallback automatic:- Workspace settings → Preferences → “Auto-fallback to next available agent”. Toggle on.
- Selected agent
- Claude Code (if not selected)
- OpenAI Codex (if not selected)
- Gemini CLI (if not selected)
When you might disable auto-fallback
For prompts where agent choice matters (e.g., you specifically picked Gemini for layout work), disable auto-fallback so vly waits rather than silently switching to a less-suitable agent.Status page
Live status of all three agents at status.vly.ai. When an agent has a multi-hour outage, we post on the status page and email workspace owners.Related
Choosing an agent
Decision tree.
Status page
Live agent status.
Agent preferences
Configure defaults.
