Troubleshooting

CLI error: command not found

Situation

You ran a qvac command (e.g., qvac doctor) and the shell responded with:

zsh: command not found: qvac

(On bash: bash: qvac: command not found.)

Cause

The qvac binary is shipped by the @qvac/cli npm package. It is only added to your shell PATH when @qvac/cli is installed globally. Without a global install, the binary is not discoverable by name from your shell.

Solution

Install @qvac/cli globally:

npm install -g @qvac/cli

Then re-run your command. For example:

qvac doctor

npx --package "@qvac/cli" qvac doctor

See CLI → Usage for the full setup, including installing @qvac/sdk in your project.