Hierarchical Configuration

CCCP enforces a strict 4-tier configuration cascade modeled after the precision of the State Planning Committee (Gosplan), ensuring deterministic behavior across local repositories and global environments.

The 4-Tier Hierarchy Cascade

Priority 1: Environment Variables (highest — temporary command overrides)
Priority 2: Local Repository Config (.cccprc in repository root)
Priority 3: Global User Config (~/.cccprc in user home directory)
Priority 4: Built-in Gosplan Defaults (deterministic fallback)

Using the `cccp config` Command

Inspect Configuration

# Display the active resolved configuration:
cccp config

# Display global values only:
cccp config --global

# Display local repository values only:
cccp config --local

Update Settings

# Set key in local .cccprc:
cccp config tickets_provider codeberg

# Set key globally across all projects:
cccp config --global cz_prompt_breaking true

Unset / Delete Settings

# Unset local key:
cccp config --unset tickets_provider

# Unset global key:
cccp config --global --unset cz_prompt_breaking

Supported Configuration Directives

Directive Key	Description	Default Value	Allowed Options / Examples
`types`	Allowed conventional commit types list	11 standard types	`feat,fix,docs,style,refactor,perf,test,build,ci,chore,revert`
`strict_types`	Enforces configured types strictly	`1`	`1` (strict), `0` (allow arbitrary types)
`strict_scopes`	Enforces configured scopes list	`0`	`1` (strict validation), `0` (permissive)
`scopes`	Allowed scopes whitelist	Empty (all allowed)	`api,ui,db,core,cli`
`tickets_provider`	Upstream forge issues provider	Auto-detected	`forgejo`, `github`, `gitlab`, `sourcehut`
`tickets_limit`	Hourly quota protection ceiling	`55`	Integer (up to 60)
`post_push_sync`	Automated post-push synchronization	Empty	`tickets`, `agent`, `tickets,agent`
`pinned_version`	Locks update checker to exact version	Empty	E.g. `2.3.0`