skip to content
ccdocs

cc config

Interactive single-setting picker. Day-to-day tweaks.

For the first-time walkthrough (settings + versions + pyenv + shell + theme), use cc setup. For dedicated changes, use cc theme / cc shell install / cc workspace add.

Usage

cc config        # interactive picker
cc config -l     # list current settings as a table

Flags

FlagDescription
-l, --listPrint all settings + current values as a themed table

Behavior

cc config opens a picker showing every setting and its current value. Arrow-pick one, get prompted for the new value (typed input, boolean toggle, enum select, or directory path depending on the setting's type), and it's saved.

╭ Choose setting ──────────────────────────────────────╮
│ ❯ IDE                              cursor            │
│   Downloads path                   ~/Downloads       │
│   Repo structure                   multi_dir         │
│   Multi-version mode               false             │
│   Timesheet flag threshold         60                │
│   Prompt on flagged switch         true              │
│   Auto-fetch                       false             │
│   Auto-fetch interval (h)          24                │
│   EOD auto-stop time                                 │
│   Color theme                      chronocoder       │
╰──────────────────────────────────────────────────────╯

One change per invocation. Run again to flip another setting.

Settings

SettingTypeDescription
IDEenumauto (default), code, cursor, none, or comma-separated writer names. Drives both cc open (the launcher) and cc switch (the writer plugins). See IDE Writers.
Downloads pathpathWhere cc initdb looks for dump files (default: ~/Downloads)
Repo structureenummulti_dir (one folder per version) or single_repo (one folder, branch checkouts)
Multi-version modeboolTrack one active project per Odoo version instead of one globally
Auto-fetchboolBackground git fetch on switch, throttled by interval
Fetch interval (hours)intMinimum hours between background fetches per version (default 24)
Flag threshold (minutes)intSessions longer than this get ⚑ flagged in cc time (default 60)
Prompt on flagged switchboolConfirm before switching away from a long session
EOD auto-stop timestrHH:MM — auto-punch-out if you forget. Blank to disable.
Color themeenumOne of default, purple, chronocoder, custom

For an explanation of each setting's effect, see Settings Guide.

Changed in 3.2.x

cc config used to be a multi-mode command (wizard + version add + theme picker + shell installer + key/value setter). All of those moved to dedicated verbs. cc config is now picker + list only — no positional args, no -v, --theme, --shell, --set-pyenv flags.

On this page