Grokkit is a fast Go CLI integrating Grok AI with git workflows and general chat/edit functionality.
Greg Gauthier
e355142c05
- Add Gitea CI workflow for testing, linting, and building - Add release workflow for multi-platform builds and GitHub releases - Implement persistent chat history with JSON storage - Add shell completion generation for bash, zsh, fish, powershell - Introduce custom error types and logging system - Add interfaces for git and AI client for better testability - Enhance config with temperature and timeout settings - Add comprehensive unit tests for config, errors, git, grok, and logger - Update README with installation, features, and development instructions - Make model flag persistent across commands - Add context timeouts to API requests |
||
|---|---|---|
| .gitea/workflows | ||
| cmd | ||
| config | ||
| internal | ||
| .env.example | ||
| .gitignore | ||
| go.mod | ||
| go.sum | ||
| install.sh | ||
| main.go | ||
| Makefile | ||
| README.md | ||
Grokkit
Grokkit is a fast Go CLI integrating Grok AI with git workflows and general chat/edit.
🚀 Quick Start
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:
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
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
# Run tests
make test
# Run tests with coverage
make test-cover
# Build
make build
# Install locally
make install