> For the complete documentation index, see [llms.txt](https://docs.layerlens.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.layerlens.ai/13.2-surfaces/cli.md).

# CLI

The Stratix CLI — terminal access to evaluations, traces, and reports.

The `layerlens` CLI is bundled with the Python SDK. Install the SDK, set an API key, and `layerlens` is on your PATH.

## Install

```bash
pip install layerlens --extra-index-url https://sdk.layerlens.ai/package
export LAYERLENS_STRATIX_API_KEY="..."
```

Verify:

```bash
layerlens --version
```

## What it does

* `layerlens login` — interactive authentication
* `layerlens evaluate` — create and run evaluations
* `layerlens traces upload` — ingest a trace JSON
* `layerlens trace-evaluate` — run a trace evaluation
* `layerlens judges create` — create or update a judge
* `layerlens models list` — browse the public catalog
* `layerlens benchmarks list` — browse benchmarks

See the full [CLI reference](/13.1-sdk-and-apis/cli.md).

## Common patterns

### CI gate

```bash
layerlens evaluate --space my-regression-space --fail-on-regression --tolerance 0.01
```

### Trace ingest

```bash
layerlens traces upload./traces.json
```

### Reports

```bash
layerlens evaluations list --since 7d --format json > eval-report.json
```

## Where to next

* [CLI reference](/13.1-sdk-and-apis/cli.md)
* [SDK quickstart](/2.-get-started/sdk.md)
* [Tutorial: Wire CI/CD quality gates](/6.-build-wire-your-code/03-cicd-gates.md)