grokkit/README.md

# Grokkit

Grokkit is a fast Go CLI integrating Grok AI with git workflows and general chat/edit.

## 🚀 Quick Start

```bash
export XAI_API_KEY=sk-...

# Install from source
git clone https://github.com/yourusername/grokkit.git
cd grokkit
make install

# Or build locally
make build

grokkit --help
```

## 📁 Config (optional)

`~/.config/grokkit/config.toml`:
```toml
default_model = "grok-4"
temperature = 0.7
timeout = 60  # seconds

[aliases]
beta = "grok-beta-2"

[chat]
history_file = "~/.config/grokkit/chat_history.json"
```

## Commands

### 💬 `grokkit chat`
Interactive CLI chat with Grok. Features persistent history across sessions.

```
grokkit chat
grokkit chat -m grok-beta  # Use specific model
```

### 📝 `grokkit commitmsg`
Generate conventional commit from staged changes.

```
git add .
grokkit commitmsg
```

### ✅ `grokkit commit`
Generate & commit.

```
grokkit commit
```

### 🔍 `grokkit review`
AI code review of staged changes.

```
grokkit review
```

### 📋 `grokkit pr-describe`
PR description from branch vs main.

```
grokkit pr-describe
```

### 📜 `grokkit history`
Summarize recent commits.

```
grokkit history
```

### ✏️ `grokkit edit FILE "instruction"`
AI edit file.

```
grokkit edit main.go "add error handling"
```

## Shell Completions

Generate shell completions for your shell:

```bash
# Bash
grokkit completion bash > /etc/bash_completion.d/grokkit

# Zsh
grokkit completion zsh > "${fpath[1]}/_grokkit"

# Fish
grokkit completion fish > ~/.config/fish/completions/grokkit.fish

# PowerShell
grokkit completion powershell > grokkit.ps1
```

## Flags

- `--model, -m`: Specify model (e.g., grok-4, grok-beta)
- Global flag available on all commands

## Features

- ✅ Context-aware HTTP requests with timeouts
- ✅ Comprehensive error handling and logging
- ✅ Persistent chat history
- ✅ Configurable temperature and parameters
- ✅ Shell completions (bash, zsh, fish, powershell)
- ✅ Test coverage >70%
- ✅ CI/CD with GitHub Actions
- ✅ Interface-based design for testability

## Development

```bash
# Run tests
make test

# Run tests with coverage
make test-cover

# Build
make build

# Install locally
make install
```

## License

[Unlicense](https://unlicense.org/)