> ## Documentation Index
> Fetch the complete documentation index at: https://reikon.dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Install and Run the CLI

> Install @reikondev/cli, run your first analysis, and pick an output format.

# Install and Run the CLI

`rei` runs the same analyzers as the desktop app from a terminal — no UI, no Electron,
just results. Useful for scripting, CI, or anyone who'd rather pipe output into another
tool than click through tabs.

## Install

```bash theme={null}
npm install -g @reikondev/cli
```

Requires Node.js 18 or newer.

## Run your first analysis

```bash theme={null}
rei analyze --path ./your-repo
```

With no `--path`, it analyzes the current directory. By default you'll see a colored
terminal summary — one line per signal, with a ✓ / ⚠ / ✗ status icon based on whether
the score clears your warn/fail thresholds (70/50 by default, configurable — see the
[CLI reference](../reference/cli#config)).

## Other output formats

```bash theme={null}
# Full JSON, same shape the desktop app uses internally
rei analyze --format json --output report.json

# Self-contained HTML report, same as the desktop app's Export button
rei analyze --format html --output report.html
```

JSON output is the one to reach for if you're piping into another tool:

```bash theme={null}
rei analyze --format json | jq '.healthScore'
```

## Re-analyze on every commit

```bash theme={null}
rei analyze --watch
```

Stays running, re-analyzes automatically whenever you commit. Press Ctrl+C to stop.

## Picking up project config

If the repo has a committed `.reikon/config.json`, `rei` reads it automatically — same
teams, aliases, and ignore paths the desktop app would use. Nothing extra to configure.

## Next

* [Add it to CI](./cli-ci-integration) to gate builds on health score
* [Full flag/exit-code reference](../reference/cli)