# 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](https://help.niroai.dev/cli/reference-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](https://help.niroai.dev/cli/faq-install-and-setup/) |
| Signing in, your account | [FAQ: login and account](https://help.niroai.dev/cli/faq-login-and-account/) |
| The line limit, the licence | [FAQ: licence and plans](https://help.niroai.dev/cli/faq-licence-and-plans/) |
| Building the graph, files left out | [FAQ: indexing and builds](https://help.niroai.dev/cli/faq-indexing/) |
| An answer is wrong or missing something | [FAQ: wrong or missing answers](https://help.niroai.dev/cli/faq-wrong-or-missing-answers/) |
| Your coding agent does not see or use Niro | [FAQ: coding agents and MCP](https://help.niroai.dev/cli/faq-assistants-and-mcp/) |
| Branches, worktrees, temporary projects | [FAQ: worktrees and branches](https://help.niroai.dev/cli/faq-worktrees-and-branches/) |
| What is sent, secrets, files Niro reads | [FAQ: privacy and security](https://help.niroai.dev/cli/faq-privacy-and-security/) |
| Slow builds or answers, disk use | [FAQ: performance](https://help.niroai.dev/cli/faq-performance/) |
| Upgrading | [FAQ: updates](https://help.niroai.dev/cli/faq-updates/) |
| Removing Niro | [FAQ: uninstall](https://help.niroai.dev/cli/faq-uninstall/) |
| Working without a network | [FAQ: offline use](https://help.niroai.dev/cli/faq-offline/) |
| The end-of-task line, feedback | [FAQ: feedback and receipts](https://help.niroai.dev/cli/faq-feedback-and-receipts/) |
| Pull request review, root cause analysis | [Features of hosted Niro](https://help.niroai.dev/cli/hosted-only/) |

## Still stuck

Email **[help@niro.ai](mailto:help@niro.ai)** with:

- the command you ran;

- the message you saw;

- the output of `niro status` and `niro engine status`.

Remove anything private from them first.