# keryn agents inspect

Describes Keryn 0.5.2 and keryn-rules 0.8.0.

> keryn agents inspect: inspect local agent declarations and compare reviewed evidence

Source: https://keryn.dev/docs/reference/cli/agents-inspect/

> **Caution: Next release: keryn agents inspect**
> On main; not in Keryn 0.5.2, the latest release.

Inspect local agent declarations and compare reviewed evidence.

```text
keryn agents inspect <project> --project-id <stable-id> --out <new-directory> [--base <inspection.json>] [--fail-on-change] [--json]
```

## Options

```text
keryn agents inspect <project> --project-id <stable-id> --out <new-dir> [--base <inspection.json>] [--fail-on-change] [--json]
Offline project inspection. No discovered tools, skills or servers are executed.
```

## Examples

```sh
# Offline; no discovered tool is executed.
keryn agents inspect . --project-id shop --out out/agents

# Gate changes.
keryn agents inspect . --project-id shop --out out/agents --base old/inspection.json --fail-on-change
```

## Exit codes

| Code | Meaning |
|---|---|
| 0 | inspection completed within scope, not a security approval |
| 1 | change gate |
| 2 | usage error |
| 3 | incomplete evidence |
