skip to content
ccdocs
Commands

cc config

Configure cc. Bare cc config opens an interactive single-setting picker; its verbs handle dedicated concerns (IDE writers, virtualenvs, theme, shell integration, completion, reset).

For the first-time walkthrough (settings + versions + pyenv + shell + theme), use cc setup.

Usage

cc config              # interactive settings picker
cc config -l           # list current settings as a table
cc config <verb>     # run a config verb (see table below)

Flags

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

The picker

cc config with no args 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       │
│   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       │
│   Discover workspaces                                │
╰──────────────────────────────────────────────────────╯

One change per invocation — run again to flip another setting. The final entry, Discover workspaces, jumps into the version-discovery flow (the same step cc setup runs).

Verbs

VerbDescription
cc config ideList IDE writers and run one-time editor setup
cc config venvManage the pyenv virtualenv linked to an Odoo version
cc config themePick or set the cc color theme
cc config shellInstall / check cc shell integration (zsh, bash, fish)
cc config completionPrint a native shell completion script
cc config resetDelete cc's internal database (irreversible)

Settings

SettingTypeDescription
IDEenumauto (default), code, cursor, none, or comma-separated writer names. Drives both the launcher and the writer plugins on cc switch. See IDE Writers.
Downloads pathpathWhere cc db init looks for dump files (default: ~/Downloads)
Multi-version modeboolTrack a separate active env per Odoo version (off by default = a single active env). See Multi-Version Mode.
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.

On this page