Skip to content

Config

ctx config

Manage runtime configuration profiles.

ctx config <subcommand>

The ctx repo ships two .ctxrc source profiles (.ctxrc.base and .ctxrc.dev). The working copy (.ctxrc) is gitignored and switched between them using subcommands below.

ctx config switch

Switch between .ctxrc configuration profiles.

ctx config switch [dev|base]

With no argument, toggles between dev and base. Accepts prod as an alias for base.

Argument Description
dev Switch to dev profile (verbose logging)
base Switch to base profile (all defaults)
(none) Toggle to the opposite profile

Profiles:

Profile Description
dev Verbose logging, webhook notifications on
base All defaults, notifications off

Examples:

ctx config switch dev     # Switch to dev profile
ctx config switch base    # Switch to base profile
ctx config switch         # Toggle (dev → base or base → dev)
ctx config switch prod    # Alias for "base"

The detection heuristic checks for an uncommented notify: line in .ctxrc: present means dev, absent means base.

ctx config status

Show which .ctxrc profile is currently active.

ctx config status

Output examples:

active: dev (verbose logging enabled)
active: base (defaults)
active: none (.ctxrc does not exist)

See also: Configuration, Contributing: Configuration Profiles