Troubleshooting
Start with the core-owned health and route inventory:
hlvm --version
hlvm doctor
hlvm model list
hlvm ask --verbose "hello"
No Agent Route Is Ready
Install and authenticate a supported agent runtime, use its integrated login when offered, or configure a provider key. HLVM cannot infer a subscription that has no installed authenticated runtime or supported login flow.
A Subscription Agent Needs Sign-in
hlvm model login <backend>
hlvm model list
Use the backend identifier reported by hlvm model list.
Doctor Exit Status
hlvm doctor reports both core runtime health and whether at least one agent
route can answer. It exits nonzero when the runtime is unhealthy or no route is
ready, and prints the next authentication or installation action when one is
available.
Existing Ollama Is Unavailable
Ollama is optional BYO software. Start or repair it with Ollama's own tools, then rerun:
hlvm model list
HLVM does not install, start, or repair Ollama. A local model pull is always an explicit user action:
hlvm model pull ollama/qwen3:8b
Browser Automation Is Unavailable
Chromium is prepared lazily when a browser task first needs it. Retry the task after checking network access and disk space. Browser Bridge uses the user's authenticated browser separately:
hlvm browser setup
hlvm browser status
MCP Server Fails
hlvm mcp show <name>
hlvm mcp login <name>
For stdio servers, confirm the command works outside HLVM and that --
separates hlvm mcp add options from the server command.
Resetting State
HLVM intentionally has no broad destructive nuke command. Remove only the
specific conversation, credential, model, MCP entry, or cache you intend to
replace through its owning command or application surface.