aicommits 2.0.0-develop.15 → 2.0.0-develop.16

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -20,7 +20,7 @@
20
20
  npm install -g aicommits@develop
21
21
  ```
22
22
 
23
- > We need @develop since v2 is still not released as latest/main!
23
+ > We need @develop since v2 is still not released as latest/main!
24
24
 
25
25
  2. Run the setup command to choose your AI provider:
26
26
 
@@ -33,6 +33,7 @@ This will guide you through:
33
33
  - Selecting your AI provider (sets the `provider` config)
34
34
  - Configuring your API key
35
35
  - **Automatically fetching and selecting from available models** (when supported)
36
+ - **Choosing your preferred commit message format** (plain, conventional, or gitmoji)
36
37
 
37
38
  Supported providers include:
38
39
 
@@ -97,7 +98,7 @@ aicommits --all # or -a
97
98
  - `--generate` or `-g`: Number of messages to generate (default: **1**)
98
99
  - `--exclude` or `-x`: Files to exclude from AI analysis
99
100
  - `--all` or `-a`: Automatically stage changes in tracked files for the commit (default: **false**)
100
- - `--type` or `-t`: Git commit message format (default: **conventional**). Supports `conventional` and `gitmoji`
101
+ - `--type` or `-t`: Git commit message format (default: **plain**). Supports `plain`, `conventional`, and `gitmoji`
101
102
  - `--confirm` or `-y`: Skip confirmation when committing after message generation (default: **false**)
102
103
  - `--clipboard` or `-c`: Copy the selected message to the clipboard instead of committing (default: **false**)
103
104
 
@@ -111,15 +112,23 @@ aicommits --generate <i> # or -g <i>
111
112
 
112
113
  > Warning: this uses more tokens, meaning it costs more.
113
114
 
114
- #### Generating Conventional Commits
115
+ #### Commit Message Formats
115
116
 
116
- If you'd like to generate [Conventional Commits](https://conventionalcommits.org/), you can use the `--type` flag followed by `conventional`. This will prompt `aicommits` to format the commit message according to the Conventional Commits specification:
117
+ You can choose from three different commit message formats:
118
+
119
+ - **plain** (default): Simple, unstructured commit messages
120
+ - **conventional**: [Conventional Commits](https://conventionalcommits.org/) format with type and scope
121
+ - **gitmoji**: Emoji-based commit messages
122
+
123
+ Use the `--type` flag to specify the format:
117
124
 
118
125
  ```sh
119
126
  aicommits --type conventional # or -t conventional
127
+ aicommits --type gitmoji # or -t gitmoji
128
+ aicommits --type plain # or -t plain (default)
120
129
  ```
121
130
 
122
- This feature can be useful if your project follows the Conventional Commits standard or if you're using tools that rely on this commit format.
131
+ This feature is useful if your project follows a specific commit message standard or if you're using tools that rely on these commit formats.
123
132
 
124
133
  ### Git hook
125
134
 
@@ -297,18 +306,20 @@ aicommits config set max-length=100
297
306
 
298
307
  #### type
299
308
 
300
- Default: `""` (Empty string)
309
+ Default: `plain`
301
310
 
302
- The type of commit message to generate. Set this to "conventional" to generate commit messages that follow the Conventional Commits specification:
311
+ The type of commit message to generate. Available options:
303
312
 
304
- ```sh
305
- aicommits config set type=conventional
306
- ```
313
+ - `plain`: Simple, unstructured commit messages
314
+ - `conventional`: Conventional Commits format with type and scope
315
+ - `gitmoji`: Emoji-based commit messages
307
316
 
308
- You can clear this option by setting it to an empty string:
317
+ Examples:
309
318
 
310
319
  ```sh
311
- aicommits config set type=
320
+ aicommits config set type=conventional
321
+ aicommits config set type=gitmoji
322
+ aicommits config set type=plain
312
323
  ```
313
324
 
314
325
  ## How it works