czg
v1.11.0
Published
Interactive Commitizen CLI that generate standardized git commit message
Downloads
48,464
Maintainers
Readme
- 🤖 OpenAI Support. Let the AI generate your git commit message description.
- ⚡️ Lightweight : Zero Dependencies (1.31MB)
- 🤗 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:
:, --alias= Directly submit the defined commit message
--config= Specify the configuration file to use
OpenAI:
-N=,--ai-num= Sets AI return multiple subjects and Turn on choose mode
-M=,--ai-model= Sets AI model in this session
[default: "gpt-4o-mini"]
[example: "gpt-3.5-turbo", "gpt-4o", "gpt-4o-mini" ...]
--api-key= Setup request OpenAI API secret key to local (.config/.czrc)
--api-model= Setup request OpenAI API model to local (.config/.czrc)
--api-proxy= Setup request OpenAI API proxy to local (.config/.czrc)
--api-endpoint= Setup request OpenAI API endpoint to local (.config/.czrc)
[default: "https://api.openai.com/v1"]
FLAG:
-r, --retry Directly retry submit by the last message
--no-ai Turn off AI prompt mode in this session
--unset-proxy Unset request API proxy on local configure
-h, --help Show help
-v, --version Show version
EXAMPLES:
czg
czg emoji
czg :fd
czg --config="./config/cz.json"
czg --api-key="sk-XXXXX"
czg ai -N=3 -M="gpt-4o"
Extends 'git commit' options.
See 'git commit --help' for more information.
Installation
「czg」 requires Node >=v12.20
npm install -g czg
MacOS:
brew install czg
⇒ Get Started (more installation and usage)
Configure
Recipes
FAQ
Projects using czg CLI
LICENSE
MIT Copyright (c) 2022-present Qiubin Zheng [email protected] (https://github.com/Zhengqbbb)