Skip to content

Commit 9216c07

Browse files
authored
Update README.md
1 parent 7d93111 commit 9216c07

1 file changed

Lines changed: 52 additions & 72 deletions

File tree

README.md

Lines changed: 52 additions & 72 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
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-
* ⚡ Oneshot `--yes` flag for autocommit
13+
* ⚡ Oneshot `--yes` flag for autocommit
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/
7047
smartcommit setup
7148
```
7249

73-
You’ll be prompted to configure:
50+
Configure in an interactive prompt:
7451

7552
1. **Provider**: `ollama`, `openai`, or `http`
7653
2. **Model name**: e.g., `llama3`, `gpt-4`, `gemini`
7754
3. **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 .
8865
smartcommit generate
8966
```
9067

91-
```
68+
```text
9269
💡 Generated Commit Message:
9370
fix: 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

141120
1. **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

158140
go 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
177157
MIT License © manyfacedqod

0 commit comments

Comments
 (0)