AI Maturity ScannerLocal CLI for AI coding maturity

Quick start

Scan with one command.

The target must be a git repository, and git must be available on PATH. By default, the CLI scans the current directory; you can also pass an explicit path.

Requirements

Node.js 22+

Required for npx, global installs, and the local CLI runtime.

git

Must be available on PATH; the scanner reads tracked files through git ls-files.

Option 1

One-off scan

Run the scanner against a target repository without installing it globally.

npx @merico-ai/maturity-scanner ./my-repo
Option 2

Install, then scan

Install the CLI globally, then run the default command in the target repository to generate the image report.

npm install -g @merico-ai/maturity-scanner
ai-maturity-scanner ./my-repo

Understand the result

L0 means the repository has no AI instruction file. L1-L4 represent progressively more mature AI engineering practices. AMI is useful for comparison and trend tracking.