Output formats

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.

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.

plerion findings list --output json | jq '.[].detectionId'

YAML

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

plerion assets list --output yaml

Text

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

plerion findings list --output text | awk -F'\t' '{print $1, $3}'

JMESPath filtering (`--query`)

Filter or transform output using JMESPath expressions. The query is applied to the raw API response, which wraps results in a data key.

# 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)'

When --query is used, output is always JSON regardless of the --output flag.

Getting started

Commands

Table (default)

Color scheme

JSON

YAML

Text

JMESPath filtering (`--query`)

​Table (default)

​Color scheme

​JSON

​YAML

​Text

​JMESPath filtering (--query)

Table (default)

Color scheme

JSON

YAML

Text

JMESPath filtering (`--query`)