# Error messages

**Paste the start of a message into your search, or look for it below.** Each message links to the page that explains it, and each explanation cites the code that prints the message. Parts in angle brackets, such as `<folder>`, stand for the value in your message.

## FAQ: coding agents and MCP

See [FAQ: coding agents and MCP](https://help.niroai.dev/cli/faq-assistants-and-mcp/).

- "Unknown client: X"

- "Failed to register MCP server. Is the Codex CLI installed?" (or the same for Gemini, Copilot, droid or Claude Code)

- "Failed to write config ... Manually add to <path>" or "No config path known for <client>."

- What does "Answered from the local graph on this machine (niro-local)." mean?

- "The local engine could not answer: <message>"

- "the local engine did not answer <method> within Nms" or "Niro MCP request timed out"

- My agent says "THIS FOLDER IS NOT INDEXED" and offers to index it.

- Claude Code shows "Niro impact check, before you edit this file". How do I turn it off?

- "Niro is not set up in any AI assistant on this machine, so there is nothing to remove."

- "Invalid --url" or "Refusing to use MCP server URL ..."

- "MCP <label> wizard exited with code N"

## FAQ: feedback and receipts

See [FAQ: feedback and receipts](https://help.niroai.dev/cli/faq-feedback-and-receipts/).

- What is the "[NIRO-CLI]" line at the end of a task?

- "Nothing to report: no niro-local call answered this turn."

- "The end-of-task Niro line is switched off on this machine"

## FAQ: indexing and builds

See [FAQ: indexing and builds](https://help.niroai.dev/cli/faq-indexing/).

- "This folder is not added yet. Run niro init to add it and build it."

- "Two folders were given (<a> and --path <b>). Give one."

- "This folder is not indexed on this machine. Run niro start here to set it up."

- A file is listed as one "whose parse passed the 20 s time limit".

- "SKIPPED: N source file(s) larger than 2 MB ... were not indexed"

- "another niro-local was writing the graph, and this gave up (it waits at most 120 s ...)"

- The watcher's log says "Could not rebuild <folder>: ... Edits are not reaching the graph."

- An answer says "NOTE FROM niro-local: ACTION REQUIRED. The following file(s) were modified after the last index build".

- An answer says "niro-local is rewriting this folder's code graph right now".

- "the graph at <path> is damaged ... It is rebuilt from what was indexed."

- "the graph was written by an older major version of niro-local; run niro build"

- "the graph ... was written by a newer major version of niro-local"

- "The niro-local home ... was last used by a newer niro-local ... Upgrade with: niro upgrade"

## FAQ: install and setup

See [FAQ: install and setup](https://help.niroai.dev/cli/faq-install-and-setup/).

- I am on Windows. Setup says "Niro Local runs on macOS and Linux. On Windows, use WSL 2."

- "Node vX. Niro needs Node 18 or newer."

- "N GB free. A large repository's graph may need more."

- "`niro start` is interactive and there is no terminal to prompt on."

- "Global install failed. Install it yourself, then run niro start"

- "<folder> is your home folder ... Niro will not index it."

- "<folder> does not exist." or "<folder> is a file, not a folder."

- "Nothing that looks like a project in <folder>."

- "It holds more than 60 repositories, too many to index as one folder."

- "It holds no source file niro-local can read."

- "The local engine is not installed. Run `niro start` once to set up this machine."

- "Downloading the local engine failed: HTTP n" or "The engine manifest came back incomplete."

- "The local engine that arrived is not the one Niro published, so it was not installed."

- "Another process has been downloading the local engine for too long."

- "There is no local engine for <platform> <arch>."

- The engine install ended with "Nothing was installed."

- "The local engine cannot open its graph on this machine" or "Make that folder writable, or set NIRO_LOCAL_HOME"

- "PM2 is not installed." / "PM2 install failed" / "PM2 was installed but [is not] runnable from this shell"

- "Could not set niro-watch to start on login"

- `niro status` says the background updates are "stopped", "not installed" or "OFF".

## FAQ: licence and plans

See [FAQ: licence and plans](https://help.niroai.dev/cli/faq-licence-and-plans/).

- "Not built: this machine already holds N lines of code, over the M line limit."

- "No room left under the limit, so a new folder will not be indexed. Folders already indexed still rebuild."

- "Not indexing: this machine already holds N lines ..." with a list ending "removing it frees nothing"

- What does "no line limit while you share" mean, and what is shared?

- "Could not read your plan from Niro. Check your connection, then run niro plan again."

- "Niro will not license the local engine: <reason>"

- "Could not renew the local engine's licence ... It keeps working offline for up to a day."

- "Working on an expired licence: N hours of offline allowance left"

- "Not indexing: ..." followed by "Reason given: ..."

- "The Niro CLI has not handed this engine its licence yet."

- A page opened in my browser by itself, at ".../limit".

## FAQ: login and account

See [FAQ: login and account](https://help.niroai.dev/cli/faq-login-and-account/).

- "Login timed out. Run niro login to try again."

- "You are on the list. We will email you when you are in."

- "Request sent. We reply within one business day."

- "This account cannot sign in to Niro."

- "The sign-in was not completed. Run niro start again to get a new code."

- "Not logged in", "Session expired" or "Token refresh failed"

- "Credentials rejected by server (401). Run niro login to refresh."

- I signed in with `--api-key` or `--password`, and `niro mcp install` says "Not signed in. Run niro login".

- A command says "`--api-url` ..." is not accepted.

- "Device flow not available on this server, falling back to API key login."

- "Invalid API key." or "Server did not return a token."

## FAQ: offline use

See [FAQ: offline use](https://help.niroai.dev/cli/faq-offline/).

- "Network error calling <method> <path>"

## FAQ: privacy and security

See [FAQ: privacy and security](https://help.niroai.dev/cli/faq-privacy-and-security/).

- "N item(s) not sent: the local engine is too old to mask secrets. Run `niro upgrade`."

- What does "Share redacted code" send?

- "the Niro service cannot yet promise to delete this code when sharing is switched off, so nothing was sent"

- "Passwords and tokens are refused and never stored"

- "That is not a form of this command, and it is not repeated here in case it holds a secret."

## FAQ: uninstall

See [FAQ: uninstall](https://help.niroai.dev/cli/faq-uninstall/).

- "Nothing removed: there is no terminal to confirm on. Pass --yes to go ahead."

- "Niro is partly removed; see the problems above."

- "Could not send the waiting usage and audit records"

- "Niro is not installed on this machine, so there is nothing to remove."

## FAQ: updates

See [FAQ: updates](https://help.niroai.dev/cli/faq-updates/).

- "npm could not replace the package. The usual cause is that your npm global folder needs root"

- "Not upgrading: niro is npm-linked to a working copy" or "you are not running the globally installed niro"

- "npm reported success, but there is no niro in your npm global folder."

- "The version just installed does not support `niro upgrade --finish`"

- "N of M refreshed, K failed."

- "The local engine was not upgraded: <message>. Try again with niro engine install."

- "Heads up: you are not signed in, so each client's installer will stop without refreshing it."

- "Folders from Niro web: N folder(s) were set up with Niro web on this machine."

## FAQ: worktrees and branches

See [FAQ: worktrees and branches](https://help.niroai.dev/cli/faq-worktrees-and-branches/).

- "This folder is now on <branch>, which niro-local has not indexed."

- "this folder's index was copied from project P and has not been built from this folder's files yet"

- "A project's folders must all be on one branch."

- "This folder is on no named branch"

- "Gave up building <folder> after N tries; run `niro build` there to see why."

- A folder that came back still shows its old "missing since" date.

- "<path> is now on X; its part of this answer describes Y"

## FAQ: wrong or missing answers

See [FAQ: wrong or missing answers](https://help.niroai.dev/cli/faq-wrong-or-missing-answers/).

- "Nothing in the graph is called '<name>'."

- "N files in this folder are not in the graph because they are larger than 2 MB ... rebuilding does not change that"

- What do "confidence: partial" and "has_more: true" mean?

- What do `[possible]`, `[test]` and "inferred, target unconfirmed" mean?

- "Not listed: N call(s) with this method's name on a receiver of unknown type"

- An implementation, or the interface that declares the method, shows "0 callers" when its callers use a child interface.

- A call goes to a "stand-in" instead of my code.

- "(no handler method)" or "(no handler in this project serves it)"

- An outbound call says "address not stated", or has no address.

- Any `.send("text")` is listed as a Kafka event.

- What does `find_orphaned_events` mean by "one side missing"?

- "Error: direction=upstream needs 'exception_type'"

- "Error: Unrecognised direction"

- Class structure gives a member count but no names, or says "no members".

- "WARNING: <path> has changed since the last build"

- "PARTIAL: the search stopped at its 1.5 s limit ... Call again with continue_from=N"

- "Refused: '<x>' is outside this worktree" or "leads outside this worktree through a symlink"

- "<tool> is not answered for this folder: it is indexed locally by niro-local, whose graph holds structure and not source text or documentation"

- "Nothing in this folder's graph serves <path>, so the question was not answered"

- "The first 10 of N names are answered above."

- A question about another folder gets "Nothing in the graph".