Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

list

List stored configs or subscriptions.

xrat list <target> [flags]

Targets

TargetAliasDescription
configsnodesList stored proxy configs
subscriptionssubsList stored subscriptions

list configs

xrat list configs [flags]

Flags

FlagDescription
--enabled-onlyShow only enabled configs
--active-onlyShow only the active config
--deletedShow only soft-deleted configs
--allInclude soft-deleted configs in results
--subscription <ref>Show only configs from the given subscription ref prefix
--format <format>Output format: table, tsv, json (default: table)

Examples

List all configs:

xrat list configs

List only enabled configs from a subscription ref:

xrat list configs --enabled-only --subscription f00d

List soft-deleted configs:

xrat list configs --deleted

list subscriptions

xrat list subscriptions [flags]

Flags

FlagDescription
--kind <kind>Filter by source kind: url, file, or raw-text
--format <format>Output format: table, tsv, json (default: table)

Examples

List all subscriptions:

xrat list subscriptions

List only URL-based subscriptions:

xrat list subscriptions --kind url

Human tables show short refs first. Use --format tsv or --format json for scripts; those formats use stable refs and omit internal numeric database IDs. The default table format is optimized for humans and may change as the CLI evolves.

Subscription output includes an updated_at timestamp in all formats so you can see the latest refresh/import time at a glance.