gmgauthier/grokkit
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases 10 Wiki Activity
Grokkit is a fast Go CLI integrating Grok AI with git workflows and general chat/edit functionality.
20 Commits 2 Branches 11 Tags 6.5 MiB
Go 96%
Shell 2.8%
Makefile 1.2%
9bd3e1d00e
Go to file
Greg Gauthier 9bd3e1d00e refactor: add error handling and refactor git utilities 
- Enhance error checking in all commands using git.Run
- Refactor git helper to return errors properly
- Fix README.md filename typo
- Update .gitignore with additional ignores
- Add fallback for config home dir
- Improve request handling in grok client
2026-03-01 12:08:49 +00:00
cmd refactor: add error handling and refactor git utilities 2026-03-01 12:08:49 +00:00
config refactor: add error handling and refactor git utilities 2026-03-01 12:08:49 +00:00
internal refactor: add error handling and refactor git utilities 2026-03-01 12:08:49 +00:00
.env.example stub out project 2026-02-28 18:03:12 +00:00
.gitignore refactor: add error handling and refactor git utilities 2026-03-01 12:08:49 +00:00
go.mod feat(chat): add interactive TUI with Bubble Tea and streaming 2026-02-28 21:53:35 +00:00
go.sum feat(chat): add interactive TUI with Bubble Tea and streaming 2026-02-28 21:53:35 +00:00
install.sh feat(install): add installation script 2026-02-28 23:13:35 +00:00
main.go refactor(cmd): remove unnecessary last modified comments and timestamps 2026-02-28 22:59:16 +00:00
Makefile chore(build): add Makefile and tests for commands and utilities 2026-03-01 00:24:48 +00:00
README.md refactor: add error handling and refactor git utilities 2026-03-01 12:08:49 +00:00

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-...

go install gmgauthier.com/grokkit@grokkit  # or build locally

grokkit --help

📁 Config (optional)

~/.config/grokkit/grokkit.yaml:

model: grok-4
chat:
  history_file: ~/.config/grokkit/chat_history.json

Commands

💬 grokkit chat

Interactive TUI chat with Grok (bubbletea: styled scrolling viewport, live streaming, mouse support).

grokkit chat

📝 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"

Flags

--model, -m: grok-4 (default), etc.

License

Unlicense