5.7 KiB

Raw Blame History

czg

Interactive Commitizen CLI that generate standardized git commit message

Github | Installation | Website | 简体中文文档

🤖 OpenAI Support. Let the AI generate your git commit message description.
⚡️ Lightweight : Zero Dependencies (1.5MB)
🤗 Simpler and Faster : No plugin, No adapter, No extra steps, You can use npx | npm script | global install... quick start CLI in your any project
😎 Highly Customizable : Internally contains the core of cz-git. Extend all the features of cz-git. Same behavior, Same configuration loader... You can customize the commit CLI according to your need

Quick start

Now try it out, use npx czg in your any projects
And then, let's try to simply configure it. Create a .czrc file in the project root directory

{
  "scopes": [
    "hello",
    "world"
  ]
}

Note More information about configure file and options. See → Config

Features and Help

$ czg --help
NAME:
    czg - Interactive Commitizen CLI that generate standardized git commit message

WEBSITE:
    https://cz-git.qbb.sh/cli/
    https://github.com/Zhengqbbb/cz-git

SYNOPSIS:
    czg [subcommand...] [options...] [git-commit-options...]

SUBCOMMAND:
    ai               Turn on OpenAI generate subject mode
    break            Turn on appends a ! after the type/scope
    emoji            Turn on output message with emoji mode
    checkbox         Turn on scope checkbox mode
    gpg              Turn on use GPG sign commit message

OPTIONS:
    --config=        Specify the configuration file to use
    --openai-token=  Setup OpenAI API secret key to local (.config/.czrc)
    -N=,--ai-num=    Setting AI return number subjects and Turn on choose mode
    :, --alias       Directly submit the defined commit message
    -r, --retry      Directly retry submit by the last message
    -h, --help       Show help
    -v, --version    Show version

EXAMPLES:
    czg
    czg emoji
    czg :fd
    czg --config="./config/cz.json"
    czg --openai-token="sk-XXXXX"
    czg ai -N=3

Extends 'git commit' options.
See 'git commit --help' for more information.