Troubleshooting

Most problems come down to Claude Code not being found, or the panel not opening. Here’s how to fix the common ones.

The chat panel won’t open

Press Cmd+Shift+H (Mac) or Ctrl+Shift+H (Windows). If nothing happens, open the command palette (Cmd+P / Ctrl+P) and search for “Hyo” to open it from there.

“Claude not found”, or nothing happens when you send a message

This means Hyo can’t find Claude Code on your machine.

1. Go to Settings → Hyo Claude Code Agent → Advanced → Claude Code CLI path.
2. Click Auto-detect — it looks in the usual places and fills in the path for you.
3. If that doesn’t find it, check Claude Code is actually installed by opening your terminal and running which claude (Mac) or where claude (Windows). If it’s not there, install it — see Install Claude Code.

Hyo shows a setup screen about installing Claude Code

That’s expected when Claude Code isn’t installed yet. Follow the steps on screen, or use the paste-into-Claude prompt on the Install Claude Code page.

The usage bars are empty

Usually this sorts itself out — Hyo reads your usage from your Claude account and occasionally needs a moment, especially just after installing or if you haven’t signed in to Claude Code yet. If it stays empty, make sure you’re signed in to Claude Code.

The plugin won’t update

Hyo updates through BRAT. Go to Settings → BRAT and check for updates. If it’s stuck, remove the plugin from BRAT and add it again with the repo URL — you won’t lose your settings.

Something else

If a conversation gets into a broken state, starting a new tab is the quickest reset. Your past conversations are still saved. For anything that looks like a real bug, the GitHub repository is the place to raise it.