CLI Reference
ctxindex status
Inspect the latest synchronization state for Sources.
status reports the last sync status for one Source or the available Source inventory.
Usage
ctxindex status [--source <source>] [--format <format>] [--json]Flags
| Flag | Purpose |
|---|---|
--source <source> | Select an exact Source label or ID. |
--format summary | Print summary output. |
--format compact | Print compact output. |
--json | Print JSON. |
Source state becomes idle after a completed run, needs_auth after expired or revoked authentication, and failed for other terminal errors. Only the CLI sets disabled.
JSON output
status --json prints machine-readable Source and Sync Run status without requiring table parsing.
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.