hoverDocsReference
Troubleshooting
Fixes for greyed-out agents, quota errors, slow OpenCode starts, a notch that won't open, and voice problems.
- An agent is greyed out in the picker
- Its tool isn’t installed or signed in. The greyed logo says which; install or sign in with that tool’s CLI. Status is re-checked every few minutes.
- A quota shows an error
- The tool changed what Hover reads. Hover shows a readable failure and keeps going; update Hover, or switch that quota off in Settings → Integrations.
- OpenCode takes a while to start
- Its server takes 30–40 s to start cold and around 1 GB while working. Later tasks reuse it until it idles out.
- I launched Hover and nothing new appeared
- Only one copy runs at a time; a second launch opens the running copy’s dashboard.
- The notch won’t open on hover
- If a question is waiting, hovering doesn’t open the office. Use Review, or press Alt + N.
- The voice shortcut does nothing
- Check that voice is switched on in Settings → Voice. On Linux under Wayland, global shortcuts only reach Hover while an XWayland window has focus.
- Local speech won’t install
- Phonon needs 1.9 GB free on Windows and 2.3 GB on Linux while it sets up, and on Windows the Microsoft Visual C++ Redistributable (x64). The card says so before it starts. Remove clears a half-finished install so you can try again.
- Restore and Try again are missing or fail
- Checkpoints need Git installed, and only work while no run is going. See Checkpoints.
- The sandbox is on but agents start unsandboxed
srt(and on a Macrg) isn’t installed. See Sandbox for the commands.- The Screen tab shows only the wallpaper (Mac)
- Give Hover Screen Recording with the tab’s Allow… button, then restart Hover.
- The office runs slowly in a VM or over remote desktop
- With no GPU, Hover draws the office at half size and matches the frame rate the machine can manage. Making the office window smaller in Settings → General helps further.