# Install and update

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](https://docs.npmjs.com/resolving-eacces-permissions-errors-when-installing-packages-globally).

## 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 install` configured: the `niro` MCP 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-watch` in 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-skill` and `~/.claude/skills/niro-local`, and remove the block starting with the Niro marker from `~/.claude/CLAUDE.md`. Other assistants: remove the `niro` server from their MCP settings, and delete `~/.agents/skills/niro-skill` and `~/.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](https://console.niroai.dev/) 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](mailto: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](mailto:ask@niro.ai) with the language, and the frameworks you use with it.

## Next

[Set up Niro](https://help.niroai.dev/get-started/set-up-a-project/) with `niro start`, or browse the [command reference](https://help.niroai.dev/cli/reference-cli/).