# @eslint-config-snapshot/cli

Deterministic ESLint config drift checker for workspaces.

`@eslint-config-snapshot/cli` snapshots effective ESLint rule state and reports drift after dependency or config changes.

## Install

```bash
npm i -D @eslint-config-snapshot/cli
```

Or run without install:

```bash
npx @eslint-config-snapshot/cli@latest --update
```

## Quick Start

Create baseline:

```bash
eslint-config-snapshot --update
```

Check drift:

```bash
eslint-config-snapshot
```

Recommended setup flow:

```bash
eslint-config-snapshot init
```

In `recommended` preset, keep default `*` group and only select outlier workspaces via checkbox, assigning numeric groups to those exceptions.

## Commands

- `check`
- `update`
- `print`
- `config`
- `init`

Compatibility aliases:

- `snapshot` => `update`
- `compare` => `check --format diff`
- `status` => `check --format status`
- `what-changed` => `check --format summary`

## Notes

- Node.js `>=20` required.
- If no config is found, built-in defaults are used.
- Snapshots are stored under `.eslint-config-snapshot/`.

## Debugging

Use `debug` namespaces when you need deep diagnostics:

```bash
DEBUG=eslint-config-snapshot:* eslint-config-snapshot
```

This includes sampling details, extracted files, executed print-config command traces, and timing by phase.

## Related Packages

- API engine: [`@eslint-config-snapshot/api`](https://www.npmjs.com/package/@eslint-config-snapshot/api)

## More Docs

- Project overview and full guides: [root README](https://github.com/gabrielmoreira/eslint-config-snapshot#readme)