Troubleshooting
Start with three commands. Most problems show up in one of them.
niro status # this folder: indexed? built when? plan, sharing, agent, background updates
niro engine status # the engine: installed? where? does its database open?
niro plan # your plan and lines used
Then find your message. Error messages lists every message that has an answer, with a link to it.
By kind of problem
| Problem | Page |
|---|---|
| Installing, the engine, the background watcher | FAQ: install and setup |
| Signing in, your account | FAQ: login and account |
| The line limit, the licence | FAQ: licence and plans |
| Building the graph, files left out | FAQ: indexing and builds |
| An answer is wrong or missing something | FAQ: wrong or missing answers |
| Your coding agent does not see or use Niro | FAQ: coding agents and MCP |
| Branches, worktrees, temporary projects | FAQ: worktrees and branches |
| What is sent, secrets, files Niro reads | FAQ: privacy and security |
| Slow builds or answers, disk use | FAQ: performance |
| Upgrading | FAQ: updates |
| Removing Niro | FAQ: uninstall |
| Working without a network | FAQ: offline use |
| The end-of-task line, feedback | FAQ: feedback and receipts |
| Pull request review, root cause analysis | Features of hosted Niro |
Still stuck
Email help@niro.ai with:
- the command you ran;
- the message you saw;
- the output of
niro statusandniro engine status.
Remove anything private from them first.