Configuration Overview

Complete Reference

Understand the complete project-owned configuration, from initialization and CLI defaults to changelog rendering and Git remotes.

Command.config/custy/config.toml

Quick Command

[tool.custy]

TOML hierarchyproject defaultsimplementation status

Project File

.config/custy/config.toml

Root Namespace

tool.custy

Generated Tables

Ownership

Your project

Overview

custy init creates a project-owned TOML file from Custy's packaged source. The active documentation mirrors that file's hierarchy, while grouping deeply nested tables into navigable sections.

Top-Level Namespaces

Features

Project

Define the source directory under tool.custy.project.

Release

Review generated release metadata and its current compatibility gap.

Initialization

Control default overwrite and prompting behavior for custy init.

Editor

Select local and container editor precedence under tool.custy.editor.

Commit Validation

Choose built-in, automatic, Commitizen, or Git-only message checks under tool.custy.commit.validation.

CLI

Configure paths, versioning, templates, execution, push, cleanup, changelog command behavior, and workflow defaults under tool.custy.cli.

Logging

Configure Rich console output and rotating files under tool.custy.logging.

Changelog

Control collection, cleaning, releases, mapping, and rendering under tool.custy.changelog.

Git

Define default, primary, and backup remote behavior under tool.custy.git.

Minimal Shape

.config/custy/config.toml

toml

[tool.custy.project]
project_source = "auto"

[tool.custy.cli.versioning]
strategy = "semver"
bump = "auto"

[tool.custy.logging]
level = "INFO"

[tool.custy.git]
default_remote = "origin"

Status Language Used in This Guide

Active — the current resolver or service consumes the property.
Optional — supported by active code but commented out or omitted from the generated file.
Mismatch — generated and active names or shapes do not currently align.
Loaded only — parsed into a model, but the active renderer or pipeline does not yet use it.
Experimental — evolving behavior that should not be treated as stable.
Reserved — generated or described, but not consumed by the current active command flow.

Continue

Related Commands

Commands commonly used together with this command.

Configuration File

Learn ownership, initialization, TOML shape, and overwrite safety.

Configuration Architecture

Trace initialization, loading, caching, typed resolution, and runtime consumers.

All Properties

Find every generated and supported configuration path.

CLI Configuration

Review command-level defaults and nested CLI tables.

Changelog Configuration

Navigate the complete changelog subsystem.

Editor Configuration

Configure supported editors, platform precedence, Docker behavior, and keybindings.

Commit Validation

Choose a provider and understand optional Commitizen discovery.

Git Credentials

Keep native Git first and configure optional external token fallback for containers.

Overview​

Overview