# Troubleshooting

**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](https://tryhover.co/docs/checkpoints.md).

**The sandbox is on but agents start unsandboxed**
`srt` (and on a Mac `rg`) isn't installed. See [Sandbox](https://tryhover.co/docs/sandbox.md) 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.

---

Part of the [Hover docs](https://tryhover.co/docs.md) (Reference). HTML version: https://tryhover.co/docs/troubleshooting. Index for agents: https://tryhover.co/llms.txt