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.
- "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.
- 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
- "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
- 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 startis 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 startonce 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 statussays the background updates are "stopped", "not installed" or "OFF".
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
- "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-keyor--password, andniro mcp installsays "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.
- "Network error calling <method> <path>"
FAQ: privacy and security
See 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.
- "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.
- "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.
- "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 buildthere 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.
- "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_eventsmean 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".