shlf 0.10.0

Empower Development Journey with AI-Driven Tools
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85

# Shelf: Empower Development Journey with AI-Driven Tools

[![Shelf CI](https://github.com/ab22593k/shelf/actions/workflows/ci.yml/badge.svg)](https://github.com/ab22593k/shelf/actions/workflows/ci.yml)

Shelf is a command-line tool designed to simplify configuration file management and enhance your git
workflow with AI-powered features. It enables you to:

* Manage configuration files effectively across your system
* Automatically generate meaningful git commit messages using AI
* Obtain comprehensive, AI-driven code reviews

Integrated with git hooks and supporting multiple AI providers, Shelf adapts seamlessly to your development workflow.

> **Note**: Currently, Shelf only supports Google Gemini as the AI provider.
More providers will be added in future releases.

---

## Usage

### File Management Commands

Track files:
```bash
shelf dotfs track ~/.bashrc
```

List tracked files:
```bash
shelf dotfs list
```

List only modified files:
```bash
shelf dotfs list --dirty
```

Untrack files:
```bash
shelf dotfs untrack ~/.bashrc
```

Save current changes:
```bash
shelf dotfs save
```

### AI-Powered Git Commands

Generate a commit message for staged changes:
```bash
shelf commit [--model MODEL] [--fixes ISSUE] [--history N]
```

Review staged changes:
```bash
shelf review [--model MODEL]
```

### Configuration

Configure your AI provider (default is Google Gemini):
```bash
export GEMINI_API_KEY="your-key"
```

### Shell Completion

Generate shell completions:
```bash
# For zsh
shelf completion zsh
```

---

## Contributing

Contributions are welcome! Please submit a Pull Request with your improvements.

---

## License

Shelf is licensed under the MIT License. See the LICENSE file for details.