Install and update
Install the niro CLI with npm, update it to the latest version, or remove it and everything it set up.
The niro CLI is one npm package, @niroai/niro. It needs Node.js 18+. Check with node --version.
Install
One command installs Niro and runs the first-time setup, from inside the repo you are working on:
npx @niroai/niro@latest start
Check it worked:
niro --version
The command installs niro for good, so it stays on your PATH. If that step fails with a permission error, your global npm folder belongs to root. Point npm at a folder you own instead of using sudo: see npm's guide.
Supported languages
Niro reads 13 languages: Java, Kotlin, JavaScript (including JSX, Vue and Svelte), TypeScript (including TSX and Astro), Python, C#, Go, PHP, Ruby, Swift, Rust, C and C++. A repo can mix them. niro start shows which ones it found when it builds the graph, and niro --help lists them all.
Update
niro upgrade
niro upgrade replaces the package with the latest version, re-installs Niro into every assistant you have configured, and restarts the background watcher. Restart your assistant afterwards. Check the new version with niro --version.
Remove one folder
To stop indexing one repo and free its lines, without removing Niro:
niro plan remove ~/code/old-service
Its graph is deleted. The folder and your code are not touched. Run niro init in it later to index it again.
Uninstall
niro uninstall
npm uninstall -g @niroai/niro
niro uninstall lists what it will remove and asks first (--yes skips the question, for scripts):
- Niro's entries in your AI assistants' settings, for every assistant
niro mcp installconfigured: theniroMCP server, the Niro skills (niro-skill,niro-local), the hooks, and the Niro section in files such as~/.claude/CLAUDE.md. Your own settings are left as they were. - The background watcher (
niro-watchin PM2), and its start-on-login entry. ~/.niro: your sign-in, settings and the local engine.~/.niro-local: the list of indexed folders and every graph (graph.db).
A step that fails is reported and the others still run. Restart your assistants afterwards so they stop loading the removed entries.
Remove only the assistant connection
To keep the graphs but disconnect an assistant:
niro mcp uninstall --client claude-code # one assistant
niro mcp uninstall --all # every assistant
By hand, if niro will not run
- Assistant settings. For Claude Code:
claude mcp remove niro --scope user, then delete~/.claude/skills/niro-skilland~/.claude/skills/niro-local, and remove the block starting with the Niro marker from~/.claude/CLAUDE.md. Other assistants: remove theniroserver from their MCP settings, and delete~/.agents/skills/niro-skilland~/.agents/skills/niro-local. - The watcher:
pm2 delete niro-watch && pm2 save. - The data:
rm -rf ~/.niro ~/.niro-local. - The command:
npm uninstall -g @niroai/niro.
Your account
Uninstalling removes Niro from this machine only. Your Niro account stays. If you turned on code sharing, turn it off under Settings, Privacy in the Niro console first, so nothing more is sent from any machine you use.
FAQ
What happens if Niro does not work?
Your assistant keeps working. When Niro cannot answer, the assistant falls back to its own tools, reading files and searching, as it would without Niro. Run niro status to check the folder's graph, niro build to rebuild it, or niro start to run the setup again. If it still fails, write to ask@niro.ai.
Which languages are supported?
Java, Kotlin, JavaScript (including JSX, Vue and Svelte), TypeScript (including TSX and Astro), Python, C#, Go, PHP, Ruby, Swift, Rust, C and C++. One repo can mix them, and every plan supports all of them.
What does the Niro CLI share?
Your code stays on this machine, except, for each line the audit flags, the whole method that holds it and one line for each name it uses, sent with secrets masked and author and company names removed. A record of which Niro tools your assistant used is also sent, to improve Niro and to show you its value. Niro's tools answer your assistant from the graph on this machine and never send the contents of your files.
Help improve Niro is off by default on every plan. When you turn it on, Niro redacts your code on your machine first (secrets, author names and company names are removed), extracts structural signals from it to improve graph accuracy, and deletes it right after processing. It is never used to train generative AI.
Can you add support for my language?
Yes, ask us. Write to ask@niro.ai with the language, and the frameworks you use with it.
Next
Set up Niro with niro start, or browse the command reference.