troubleshooting
common fixes for install failures, login loops, mcp hosts not listing tools, and plan limit errors.
quick answer
start here when something breaks.
use this for
- support triage
- first self-serve debug pass
steps
- confirm node 18+ and hyv --version.
- rerun npm i -g @holdyourvoice/hyv@latest.
- try hyv welcome and hyv scan on a tiny file.
- check dashboard for billing and device pairing.
details to know
- most issues are outdated global installs or expired login.
- mcp hosts need restart after hyv upgrade.
limits and edge cases
- if scan flags everything, your profile may be empty — rebuild with hyv init.
- contact support from the dashboard with command output — not full draft contents.
ready to try it on your own drafts?get started for $1 →