# crawwwl CLI reference

## Requirements and installation

crawwwl 0.2.1 requires Node.js 18 or later.

```bash
npm install -g crawwwl
```

## Commands

- `crawwwl audit`: run an audit. Use `--scale quick|standard|deep` to choose depth.
- `crawwwl watch`: watch source files and report local findings after saves.
- `crawwwl report`: display the latest saved report.
- `crawwwl assistant`: chat about the latest completed audit.
- `crawwwl fix-check`: rerun an audit and compare findings with the previous report.
- `crawwwl usage`: show account usage and balance.
- `crawwwl login`: authenticate the CLI.
- `crawwwl mcp`: start the Model Context Protocol server.

## Audit flags

- `--scale quick|standard|deep`: select audit depth.
- `--ai` or `--no-ai`: enable or disable AI processing where supported.
- `--markdown` or `--no-markdown`: control writing `.crawwwl/report.md`.
- `--full`: show every finding instead of the summary view.

## Suppression

Place `// crawwwl-ignore` immediately above code when a specific local finding is intentionally accepted. Suppression should be narrow and reviewed like any other code change.

The complete interactive reference is at https://www.crawwwl.com/docs/cli.
