# keryn capabilities inspect

Describes Keryn 0.5.2 and keryn-rules 0.8.0.

> keryn capabilities inspect: inspect AI/MCP declarations and gate capability expansion

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

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

Inspect AI/MCP declarations and gate capability expansion.

```text
keryn capabilities inspect <config.json> --out <new-directory> [--base <snapshot.json>] [--fail-on-expansion] [--observations <batch.json> --run-id <id>]
```

## Options

```text
keryn capabilities inspect <config.json> --out <new-directory> [--base <capabilities.json>] [--fail-on-expansion] [--observations <batch.json> --run-id <expected-run>] [--json]
```

## Examples

```sh
# Fail when an agent gained authority.
keryn capabilities inspect .mcp.json --out out/cap --base main/capabilities.json --fail-on-expansion
```

## Exit codes

| Code | Meaning |
|---|---|
| 0 | pass |
| 1 | findings or a requested change gate |
| 2 | usage error or invalid input |
| 3 | incomplete or unknown completion |
| 4 | execution or normalization failure |
