34 lines
1.2 KiB
Markdown
34 lines
1.2 KiB
Markdown
|
# 📜 History Guide
|
||
|
|
|
||
|
|
The `history` command provides a concise, AI-generated summary of your recent git history. It analyzes the last 10 commits to give you a high-level overview of recent developments.
|
||
|
|
|
||
|
|
### Key Features
|
||
|
|
|
||
|
|
- **Quick Summaries**: Get a quick catch-up on what's been happening in the repo.
|
||
|
|
- **AI-Powered Analysis**: Grok translates individual commit messages into 3-5 high-level bullet points.
|
||
|
|
- **Fast and Efficient**: A one-shot command for immediate results.
|
||
|
|
|
||
|
|
### Usage
|
||
|
|
|
||
|
|
```bash
|
||
|
|
grokkit history # Last 10 commits
|
||
|
|
```
|
||
|
|
|
||
|
|
### Options
|
||
|
|
|
||
|
|
| Flag | Description |
|
||
|
|
|------|-------------|
|
||
|
|
| `--model`, `-m` | Override the default model (e.g., `grok-4`) |
|
||
|
|
|
||
|
|
### How it Works
|
||
|
|
|
||
|
|
1. **Commit Log**: Grokkit runs `git log --oneline -10` to get the 10 most recent commits.
|
||
|
|
2. **AI Analysis**: It sends this log to Grok with a prompt to summarize the history.
|
||
|
|
3. **Bullet Point Summary**: Grok returns a 3-5 point summary of the most important changes.
|
||
|
|
|
||
|
|
### When to use History
|
||
|
|
|
||
|
|
- **Catching up**: Use `history` after pulling from the remote to see what's changed.
|
||
|
|
- **Branch review**: Use it to quickly recall what you've worked on recently.
|
||
|
|
- **Project overview**: Great for getting a quick status update on a project you haven't touched in a few days.
|