CLI Reference

ctxindex realm

Create and list user-defined operating contexts.

A Realm groups Sources that should be searched and reasoned about together. Every Source belongs to exactly one user-created Realm; there is no global or implicit Realm.

Usage

ctxindex realm add [--name <name>] <slug>
ctxindex realm list [--json]

Commands and flags

Command or flagPurpose
add <slug>Create a Realm with the exact slug.
--name <name>Set its display name.
listList existing Realms.
--jsonPrint the Realm list as JSON.

An omitted Realm filter means all Realms. An explicit Realm filter is exact and does not include any other Realm.

JSON output

Only realm list accepts --json; realm add prints readable confirmation.

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