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

Inside NOVA, \log shows recent log entries when something failed and the details scrolled away.

Install problems

You seeWhat to do
nova: command not found right after installingOpen a new terminal.
Still not found after a pip installActivate the environment you installed into.
pip install bridgeye-nova failsThe package is nova-bridgeye.

Sign-in problems

You seeWhyWhat 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 doctorYour saved sign-in stopped working.Run nova logout, then nova login.

While working

You seeWhyWhat 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 NOVACommands don't change NOVA's folder.Use \cd.

Scripts and CI

You seeWhat 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 3Run nova login on that machine.
"Refusing to uninstall without confirmation."Add --yes.

Results

You seeWhat to do
Verification UNVERIFIEDRun nova verify to see why, then run your own tests. Tell NOVA your commands with verify.test and similar settings.
A pass shown as staleFiles 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.

Join Discord

Need help?

Open an issue on GitHub or email support@bridgeye.com.

Get help
Bridgeye • Autonomous Software Engineering.