You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+24-7Lines changed: 24 additions & 7 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,4 +1,4 @@
1
-
# commitbot
1
+
# Commit Bot
2
2
3
3
**commitbot** is a Rust-based CLI tool that helps generate clear, structured Git commit messages using an LLM (such as OpenAI’s GPT models).
4
4
It can analyze your staged changes, summarize each file interactively, and produce a well-organized commit message describing the intent behind the changes.
@@ -9,10 +9,12 @@ It can analyze your staged changes, summarize each file interactively, and produ
9
9
- Simple one-shot mode for fast commits.
10
10
- Configurable model selection (e.g. `gpt-4o-mini`).
11
11
12
-
> **⚠️ Privacy Notice**
13
-
> At this time, **commitbot** does not support using a local LLM model.
14
-
> When the `--model` option is enabled, your staged diffs are sent to the configured API provider (e.g., OpenAI) for analysis.
15
-
> Future versions will introduce support for specifying a custom API endpoint and integrating with self-hosted or alternative LLM providers to keep all processing local or at least internal.
12
+
### ⚠️ Privacy Notice
13
+
At this time, `commitbot` does not support using a local LLM model.
14
+
When the `--model` option is enabled, your staged diffs are sent to the OpenAI for analysis.
15
+
16
+
Future versions will introduce support for specifying a custom API endpoint and integrating with self-hosted or
17
+
alternative LLM providers to keep all processing local or at least internal.
After all files are classified, **commitbot** summarizes and generates a full commit message.
69
71
72
+
### Pull Request Summaries
73
+
74
+
`commitbot` can also generate clear, high-level **Pull Request descriptions** by summarizing the commit history between two branches.
75
+
Instead of sending an enormous diff to the model, it analyzes the **commit or PR messages** to produce a concise overview of the feature branch’s purpose and major changes.
76
+
77
+
- It collects all commits between a **base** branch (such as `develop` or `main`) and the **feature** branch.
78
+
- If multiple PR numbers are detected in commit messages (e.g., `#123`), `commitbot` groups them and references each PR in the summary.
79
+
- Otherwise, it summarizes the commits directly.
80
+
- The tool can also be forced into either mode with flags.
81
+
82
+
```
83
+
commitbot pr develop
84
+
commitbot pr develop feat/ISSUE-201-registration
85
+
```
86
+
70
87
### OpenAI / ChatGPT
71
88
72
-
This needs your API Key as an environment variable.
89
+
`commitbot` needs your API Key as an environment variable.
0 commit comments