Options

Command Options

Stable

Control commit templates, staging behavior, version resolution, backups, and empty-commit handling.

Commandcusty commit

Quick Command

custy commit [OPTIONS]

optionsstagingversioning

Overview

Command-line values override project configuration for the current invocation. Review staging and empty-commit options carefully because they directly affect the final Git commit.

Available Options

Command Options

Available command-line options.

--commit-msg-file-cmsg

Optional

Override the existing commit-message template file.

Example--commit-msg-file templates/commit-message.txt

--auto-stage-as

Optional

Enable automatic staging behavior.

DefaultResolved configuration

Example--auto-stage

--stage-mode-sm

Optional

Select all, update, none, or manual staging behavior.

Example--stage-mode update

--allow-empty-commit / --no-allow-empty-commit-aec / -Aec

Optional

Allow or reject commit creation when no normal changes are available.

Example--allow-empty-commit

--strategy

Optional

Resolve release artifacts with semver, pep440, date, gitcount, or commitizen.

Example--strategy semver

--backup-commit-dir-bcd

Optional

Override the directory used for commit-message backups.

Example--backup-commit-dir .config/custy/templates/backups/commit

--version-file-vf

Optional

Override the existing project version file.

Example--version-file app/__version__.py

--check-cz-cz

Optional

Require configured and installed Commitizen validation for this invocation.

Example--check-cz

Global Execution Options

Terminal

bash

custy --dry-run commit
custy --debug commit
custy --log-level debug commit

Overview​

Overview