Back
Support // Troubleshooting
Troubleshooting
Docs › Support › Troubleshooting
Troubleshooting
Fixes for the problems people hit most. Start with nova doctor: it checks the usual suspects and tells you what to do.
First steps
bash
nova doctor # sign-in, tools, skills
nova config get <setting> # a setting's value and where it came from
nova verify # why NOVA's checks gave the result they did
nova config get <setting> # a setting's value and where it came from
nova verify # why NOVA's checks gave the result they did
Inside NOVA, \log shows recent log entries when something failed and the details scrolled away.
Install problems
| You see | What to do |
|---|---|
| nova: command not found right after installing | Open a new terminal. |
| Still not found after a pip install | Activate the environment you installed into. |
| pip install bridgeye-nova fails | The package is nova-bridgeye. |
Sign-in problems
| You see | Why | What to do |
|---|---|---|
| "Login timed out." | The browser sign-in wasn't approved in time. | Run nova login again and approve it. |
| "Login Blocked" | The sign-in was rejected, for example while on a VPN. | Turn off the VPN and try again. |
| "Sign-in not saved" (Windows) | Windows couldn't store your sign-in securely. | Reinstall NOVA with the one-line installer, then sign in again. |
| "Credential valid: NO" in nova doctor | Your saved sign-in stopped working. | Run nova logout, then nova login. |
While working
| You see | Why | What to do |
|---|---|---|
| "You're out of credits for today." | Today's credits are used up. | Wait for tomorrow's credits, or upgrade. |
| "… is not available on your plan." | That model or feature needs another plan. | Pick another, or see Plans & Pricing. |
| "I stopped after 30 steps without finishing" | The task hit the step limit. | Say what to focus on, or split the task. Work so far is kept. |
| "Refused: the command contains '|'" | NOVA runs commands without a shell, so pipes, ; and && aren't allowed. | Ask for one plain command at a time. |
| "NOVA's model service blocked this request" | The request couldn't be completed. | Try again later. Files already written are kept. |
| "Unknown command …" | A typo. | Use NOVA's suggestion, or type \commands. |
| cd in a command didn't move NOVA | Commands don't change NOVA's folder. | Use \cd. |
Scripts and CI
| You see | What to do |
|---|---|
| "Approval was required for … but NOVA is running without an interactive prompt." | Add --permission-mode acceptEdits (or overdrive), plus --allow-delete if it must delete files. |
| Exit code 3 | Run nova login on that machine. |
| "Refusing to uninstall without confirmation." | Add --yes. |
Results
| You see | What to do |
|---|---|
| Verification UNVERIFIED | Run nova verify to see why, then run your own tests. Tell NOVA your commands with verify.test and similar settings. |
| A pass shown as stale | Files changed since the check ran. Run the check again. |
Join our Discord
Chat with our engineers and become part of the active NOVA developer community.
Need help?
Open an issue on GitHub or email support@bridgeye.com.