11# SmartCommit
22
3- SmartCommit is a blazing-fast CLI tool that uses AI to generate meaningful Git commit messages from your staged changes — powered by local or remote LLMs (Ollama, OpenAI, Gemini or any HTTP-based LLM).
3+ ** SmartCommit** is a blazing-fast CLI tool that uses AI to generate meaningful Git commit messages from your staged changes — powered by local or remote LLMs (Ollama, OpenAI, or any HTTP-based LLM).
44
55---
66
@@ -10,57 +10,34 @@ SmartCommit is a blazing-fast CLI tool that uses AI to generate meaningful Git c
1010* 🤖 Supports multiple LLM providers: Ollama, OpenAI, HTTP endpoints (Claude, Gemini, etc.)
1111* ✏️ Customizable system prompt (edit in Vim)
1212* ⚡ Interactive flow with options to commit, edit, regenerate, or quit
13- * ⚡ One‑ shot ` --yes ` flag for auto‑ commit
13+ * ⚡ One‐ shot ` --yes ` flag for auto‐ commit
1414* 📦 Single static binaries for Linux, macOS (Intel/ARM), and Windows
15+ * 🔖 ` --version ` flag and ` version ` subcommand
1516
1617---
1718
18- ## 📥 Quick Installation
19+ ## 📥 Installation
1920
20- ### 1. Prebuilt Binary (Recommended)
21- (will soon add direct installs from brew/scoops soon)
22-
23- 1 . Go to [ Releases] ( https://github.com/manyfacedqod/smartcommit/releases ) .
24- 2 . Download the ` .tar.gz ` for your OS.
25- 3 . Extract and move into your ` PATH ` :
26-
27- * ** Linux**
28-
29- ``` bash
30- tar -xzf smartcommit-linux.tar.gz
31- sudo mv smartcommit-linux /usr/local/bin/smartcommit
32- chmod +x /usr/local/bin/smartcommit
33- ```
34- * ** macOS**
35-
36- ` ` ` bash
37- tar -xzf smartcommit-macos.tar.gz
38- sudo mv smartcommit-macos /usr/local/bin/smartcommit
39- chmod +x /usr/local/bin/smartcommit
40- ` ` `
41- * ** Windows (Git Bash)**
42-
43- ` ` ` bash
44- tar -xzf smartcommit-windows.tar.gz
45- mv smartcommit-windows.exe /usr/local/bin/smartcommit.exe
46- ` ` `
47-
48- # ## 2. Go Install
21+ ### Using Go
4922
5023``` bash
51- go install github.com/manyfacedqod/smartcommit@v1.1.1
24+ go install github.com/manyfacedqod/smartcommit@latest
5225```
5326
54- Ensure ` $GOPATH /bin ` or ` ~/go/bin ` is in your ` PATH ` .
27+ ### Download Prebuilt Binary
5528
56- # ## 3. Build from Source
29+ 1 . Visit the [ Releases page] ( https://github.com/manyfacedqod/smartcommit/releases ) .
30+ 2 . Download the ` .tar.gz ` for your OS and extract:
5731
58- ` ` ` bash
59- git clone https://github.com/manyfacedqod/smartcommit
60- cd smartcommit
61- go build -o smartcommit
62- sudo mv smartcommit /usr/local/bin/
63- ` ` `
32+ ``` bash
33+ tar -xzf smartcommit-< os> .tar.gz
34+ ```
35+ 3 . Move the binary into your ` PATH ` :
36+
37+ ``` bash
38+ mv smartcommit-< os> /usr/local/bin/smartcommit # or equivalent
39+ chmod +x /usr/local/bin/smartcommit
40+ ```
6441
6542---
6643
@@ -70,12 +47,12 @@ sudo mv smartcommit /usr/local/bin/
7047smartcommit setup
7148```
7249
73- You’ll be prompted to configure :
50+ Configure in an interactive prompt :
7451
75521 . ** Provider** : ` ollama ` , ` openai ` , or ` http `
76532 . ** Model name** : e.g., ` llama3 ` , ` gpt-4 ` , ` gemini `
77543 . ** API Key** (HTTP/OpenAI) or ** Base URL** (HTTP/Ollama)
78- 4. ** System prompt** is saved to ` ~/.config/smartcommit/config.yaml`
55+ 4 . ** System prompt** saved to ` ~/.config/smartcommit/config.yaml `
7956
8057---
8158
@@ -88,7 +65,7 @@ git add .
8865smartcommit generate
8966```
9067
91- ```
68+ ``` text
9269💡 Generated Commit Message:
9370fix: handle empty username in login flow
9471
@@ -108,16 +85,17 @@ smartcommit generate --yes
10885
10986### Config Commands
11087
111- * ** Show current config** :
88+ ``` bash
89+ smartcommit config show # display current config
90+ smartcommit config edit # edit system prompt in $EDITOR
91+ ```
11292
113- ``` bash
114- smartcommit config show
115- ```
116- * ** Edit system prompt (Vim)** :
93+ ### Version
11794
118- ``` bash
119- smartcommit config edit
120- ```
95+ ``` bash
96+ smartcommit --version
97+ smartcommit version
98+ ```
12199
122100---
123101
@@ -130,48 +108,50 @@ smartcommit generate --yes
130108| ` smartcommit generate --yes ` | Auto‑generate & commit without prompt |
131109| ` smartcommit config show ` | Display current configuration |
132110| ` smartcommit config edit ` | Edit the system prompt using your ` $EDITOR ` |
133- | ` smartcommit --version ` | Show version (v1.1.1) |
111+ | ` smartcommit --version ` | Show the CLI version |
112+ | ` smartcommit version ` | Same as ` --version ` |
134113
135114---
136115
137- ## 👨💻 Open Source Contribution
116+ ## 👨💻 Contributing
138117
139- We welcome contributions! Here’s how to get started:
118+ We welcome your contributions! 🚀
140119
1411201 . ** Fork** the repo and ** clone** your fork:
142121
143122 ``` bash
144- git clone https://github.com/< your-user> /smartcommit
145- cd smartcommit
146123 ```
147- 2 . ** Create** a feature branch:
148124
125+ git clone [ https://github.com/ ] ( https://github.com/ ) <your-user >/smartcommit.git
126+ cd smartcommit
127+
128+ ````
129+ 2. **Create** a feature branch:
149130 ```bash
150- git checkout -b feat/your-feature
151- ```
152- 3 . ** Implement** your changes, ** add tests** , and ** update docs** as needed.
153- 4 . ** Run** existing tests & build:
131+ git checkout -b feat/your-feature
132+ ````
133+
134+ 3 . ** Make changes** , ** add tests** , and ** update docs** .
135+ 4 . ** Run** tests & build:
154136
155137 ``` bash
156138 ```
157139
158140go test ./...
159- go build -o smartcommit
141+ go build
160142
161143```
162- 5. **Commit** and **push**, then open a **Pull Request** against `main`.
163-
164- ### Contribution Guidelines
144+ 5. **Commit**, **push**, and open a **Pull Request**.
165145
166- - Follow existing code style.
167- - Write clear commit messages (`feat:`, `fix:`, `docs:`, etc.).
168- - Include tests for new features.
169- - Document changes in this `README.md` or code comments.
146+ ### Guidelines
170147
171- Thank you for making SmartCommit better! 🙏
148+ - Follow existing code style and idioms.
149+ - Use [Conventional Commits](https://www.conventionalcommits.org/) (`feat:`, `fix:`, `docs:`, etc.).
150+ - Write clear tests for new features or fixes.
151+ - Update this README when adding or changing commands.
172152
173153---
174-
154+ (*this one was kinda ai generated so might update this later*)
175155## 📄 License
176156
177157MIT License © manyfacedqod
0 commit comments