chainctl
chainctl Chainguard Control
2 min read
For the complete documentation index, see llms.txt.
List the Chainguard malware/greyware blocklist.
List Chainguard’s malware/greyware blocklist across language ecosystems.
Filter to a single package with –package (and optionally –version) to check whether a specific artifact is flagged; rows returned means blocked, empty means clear.
chainctl libraries packages malware list [--ecosystem ECOSYSTEM] [--package NAME] [--version VERSION] [--since TIME] [--before TIME] [--sort KEYS] [--exit-code] [--output=json|table] [flags] --before string Only show entries blocked strictly before this RFC3339 time. Combine with --since to query a bounded range.
--ecosystem string Only show blocklist entries for this ecosystem (JAVA, PYTHON, JAVASCRIPT). If empty, all ecosystems are returned.
--exit-code Exit with a non-zero status if any entries match, so the command can be used as a CI gate.
--limit int32 The maximum number of entries to return; results are paginated automatically up to this limit. (default 50)
--package string Only show entries whose package name matches (exact).
--since string Only show entries blocked at or after this RFC3339 time (e.g. 2026-05-01T00:00:00Z).
--sort string Comma-separated keys to sort by, ascending, in precedence order (e.g. package,version). Keys: blocked, package, version (blocked is oldest-first; version is semver-aware). Defaults to newest-blocked first.
--version string Only show entries matching this version. Requires --package. --api string The url of the Chainguard platform API. (default "https://console-api.enforce.dev")
--audience string The Chainguard token audience to request. (default "https://console-api.enforce.dev")
--config string A specific chainctl config file. Uses CHAINCTL_CONFIG environment variable if a file is not passed explicitly.
--console string The url of the Chainguard platform Console. (default "https://console.chainguard.dev")
--force-color Force color output even when stdout is not a TTY.
-h, --help Help for chainctl
--issuer string The url of the Chainguard STS endpoint. (default "https://issuer.enforce.dev")
--log-level string Set the log level (debug, info) (default "ERROR")
-o, --output string Output format. One of: [csv, env, go-template, id, json, markdown, none, table, terse, tree, wide]
-v, --v int Set the log verbosity level.Last updated: 2026-07-23 16:28