aicommits 2.0.0-develop.22 → 2.0.0-develop.24
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 +25 -4
- package/dist/{cli-CisnS9T_.mjs → cli-BX80w-o3.mjs} +71 -71
- package/dist/cli.mjs +1 -1
- package/dist/{token-CxQPP7uz.mjs → token-B1ZqEfyr.mjs} +1 -1
- package/dist/{token-util-DPyXpMmF.mjs → token-util-ByalEZMA.mjs} +1 -1
- package/dist/{token-util-CLbFck-W.mjs → token-util-uC3xURFE.mjs} +1 -1
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -39,6 +39,8 @@ This will guide you through:
|
|
|
39
39
|
|
|
40
40
|
- **TogetherAI** (recommended) - Get your API key from [TogetherAI](https://api.together.ai/)
|
|
41
41
|
- **OpenAI** - Get your API key from [OpenAI API Keys page](https://platform.openai.com/account/api-keys)
|
|
42
|
+
- **Groq** - Get your API key from [Groq Console](https://console.groq.com/keys)
|
|
43
|
+
- **xAI** - Get your API key from [xAI Console](https://console.x.ai/)
|
|
42
44
|
- **OpenRouter** - Get your API key from [OpenRouter](https://openrouter.ai/keys)
|
|
43
45
|
- **Ollama** (local) - Run AI models locally with [Ollama](https://ollama.ai)
|
|
44
46
|
- **LM Studio** (local) - No API key required. Runs on your computer via [LM Studio](https://lmstudio.ai/)
|
|
@@ -95,12 +97,13 @@ aicommits --all # or -a
|
|
|
95
97
|
|
|
96
98
|
#### CLI Options
|
|
97
99
|
|
|
100
|
+
- `--all` or `-a`: Automatically stage changes in tracked files for the commit (default: **false**)
|
|
101
|
+
- `--clipboard` or `-c`: Copy the selected message to the clipboard instead of committing (default: **false**)
|
|
98
102
|
- `--generate` or `-g`: Number of messages to generate (default: **1**)
|
|
99
103
|
- `--exclude` or `-x`: Files to exclude from AI analysis
|
|
100
|
-
- `--all` or `-a`: Automatically stage changes in tracked files for the commit (default: **false**)
|
|
101
104
|
- `--type` or `-t`: Git commit message format (default: **plain**). Supports `plain`, `conventional`, and `gitmoji`
|
|
102
|
-
- `--
|
|
103
|
-
- `--
|
|
105
|
+
- `--prompt` or `-p`: Custom prompt to guide the LLM behavior (e.g., specific language, style instructions)
|
|
106
|
+
- `--yes` or `-y`: Skip confirmation when committing after message generation (default: **false**)
|
|
104
107
|
|
|
105
108
|
#### Generate multiple recommendations
|
|
106
109
|
|
|
@@ -130,6 +133,24 @@ aicommits --type plain # or -t plain (default)
|
|
|
130
133
|
|
|
131
134
|
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.
|
|
132
135
|
|
|
136
|
+
#### Custom Prompts
|
|
137
|
+
|
|
138
|
+
You can customize the LLM's behavior with the `--prompt` flag to guide commit message generation:
|
|
139
|
+
|
|
140
|
+
```sh
|
|
141
|
+
# Write commit messages in a specific language
|
|
142
|
+
aicommits -p "Write commit messages in Italian"
|
|
143
|
+
|
|
144
|
+
# Focus on specific aspects of the changes
|
|
145
|
+
aicommits -p "Focus on performance implications of changes"
|
|
146
|
+
|
|
147
|
+
# Use a specific style or tone
|
|
148
|
+
aicommits -p "Use technical jargon suitable for senior developers"
|
|
149
|
+
|
|
150
|
+
# Include specific details in the message
|
|
151
|
+
aicommits -p "Always mention the specific function names and file paths changed"
|
|
152
|
+
```
|
|
153
|
+
|
|
133
154
|
### Git hook
|
|
134
155
|
|
|
135
156
|
You can also integrate _aicommits_ with Git via the [`prepare-commit-msg`](https://git-scm.com/docs/githooks#_prepare_commit_msg) hook. This lets you use Git like you normally would, and edit the commit message before committing.
|
|
@@ -268,7 +289,7 @@ Model to use for OpenAI-compatible providers.
|
|
|
268
289
|
|
|
269
290
|
#### provider
|
|
270
291
|
|
|
271
|
-
The selected AI provider. Set automatically during `aicommits setup`. Valid values: `openai`, `togetherai`, `ollama`, `custom`.
|
|
292
|
+
The selected AI provider. Set automatically during `aicommits setup`. Valid values: `openai`, `togetherai`, `groq`, `xai`, `openrouter`, `ollama`, `lmstudio`, `custom`.
|
|
272
293
|
|
|
273
294
|
#### locale
|
|
274
295
|
|