CLI Reference
ctxindex artifact
List Artifact descriptors and materialize Artifact bytes.
An Artifact is downloadable content associated with a Resource. Descriptors remain with the Resource; bytes are fetched lazily into the managed cache.
Usage
ctxindex artifact list [--json] <resource-ref>
ctxindex artifact download [--output <path>] [--json] <artifact-ref>Commands and flags
| Command or flag | Purpose |
|---|---|
list <resource-ref> | List Artifact descriptors for one Resource. |
download <artifact-ref> | Download or reuse cached Artifact bytes. |
--output <path> | Copy cached bytes to a caller-controlled path while retaining managed cache ownership. |
--json | Print deterministic JSON. |
JSON output
Both subcommands accept --json. Use it to obtain Artifact Refs, descriptors, and download metadata without parsing readable output.
Stable exit codes
Exit codes are API: 0 success; 2 invalid usage; 10 needs_auth; 20 rate limited; 30 network/provider; 40 permission denied; 50 other sync failure; 130 cancelled by SIGINT.