CLI Reference

ctxindex purge

Remove explicit local cache state without deleting canonical provider data.

The current purge surface removes managed Artifact bytes and cache metadata. Resource records and Artifact descriptors remain, so later downloads can fetch the bytes again.

Usage

ctxindex purge artifacts [--json]

Commands and flags

Command or flagPurpose
artifactsRemove all managed Artifact cache state.
--jsonPrint deterministic purge results as JSON.

V1 does not automatically evict Artifact bytes by age, quota, or storage pressure.

JSON output

purge artifacts --json reports the deterministic purge result on stdout.

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.

On this page