> ## Documentation Index
> Fetch the complete documentation index at: https://docs.plerion.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Output formats

> Control how results are displayed with table, JSON, YAML, and text output.

With **Plerion CLI output formats**, you can control how results are displayed. Use `--output` (or set `output` in your config file) to choose between table, JSON, YAML, and text output.

***

## Table (default)

Human-readable table with color-coded severity and status columns. This is the default when stdout is a TTY.

```bash theme={"system"}
plerion findings list --severity CRITICAL --output table
```

### Color scheme

| Color    | Meaning                     |
| -------- | --------------------------- |
| Bold red | CRITICAL severity           |
| Red      | HIGH severity, FAILED, OPEN |
| Yellow   | MEDIUM severity, DISMISSED  |
| Cyan     | LOW severity                |
| Blue     | INFORMATIONAL               |
| Green    | PASSED, RESOLVED, ACTIVE    |

Color is automatically disabled when stdout is not a TTY, or when `--no-color` or the `NO_COLOR` environment variable is set.

***

## JSON

Pretty-printed JSON. Useful for scripting and piping to `jq`. The CLI outputs the result array directly, without the API's `data` wrapper.

```bash theme={"system"}
plerion findings list --output json | jq '.[].detectionId'
```

***

## YAML

YAML output for Kubernetes-style tooling or human-readable structured data.

```bash theme={"system"}
plerion assets list --output yaml
```

***

## Text

Tab-separated values with a header row. Useful for `awk`, `cut`, and shell scripts.

```bash theme={"system"}
plerion findings list --output text | awk -F'\t' '{print $1, $3}'
```

***

## JMESPath filtering (`--query`)

Filter or transform output using [JMESPath](https://jmespath.org/) expressions. The query is applied to the raw API response, which wraps results in a `data` key.

```bash theme={"system"}
# Get the first detection ID
plerion findings list --output json --query 'data[0].detectionId'

# Filter only CRITICAL findings
plerion findings list --output json --query "data[?severityLevel=='CRITICAL']"

# Extract a field from all items
plerion assets list --output json --query 'data[*].name'

# Count results
plerion vulnerabilities list --output json --query 'length(data)'
```

<Note>
  When `--query` is used, output is always JSON regardless of the `--output` flag.
</Note>