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
![demo](https://user-images.githubusercontent.com/40693636/175753060-cf4f5e48-100d-430a-93e9-31b17f42802f.gif)
## Quick start
1. Now try it out, use `npx czg` in **your any projects**
2. And then, let's try to simply configure it.
Create a `.czrc` file in the project root directory
```json
{
"scopes": [
"hello",
"world"
]
}
```
> **Note**
> More information about configure file and options. See → [Config](https://cz-git.qbb.sh/config/)
## Features and Help
```sh
$ 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.
```
## Installation
```sh
npm install -g czg
```
> MacOS:
```sh
brew install czg
```
[⇒ Get Started (more installation and usage)](https://cz-git.qbb.sh/cli/install.html)
## Configure
[⇒ Configure Template](https://cz-git.qbb.sh/config/)
[⇒ Show Related](https://cz-git.qbb.sh/config/show.html)
[⇒ Engineering Related](https://cz-git.qbb.sh/config/engineer.html)
## Recipes
[⇒ Recipes](https://cz-git.qbb.sh/recipes/)
## FAQ
[⇒ FAQ](https://cz-git.qbb.sh/faq/)
## Projects using czg CLI
## LICENSE
MIT
Copyright (c) 2022-present Qiubin Zheng (https://github.com/Zhengqbbb)
> I just do my best to make thing well, Could you give a [star ⭐](https://github.com/Zhengqbbb/cz-git) to encourage me ?