A CLI and TUI tool for LLM-assisted GitHub issue management.
- Dual interface — full CLI for scripting and an interactive TUI for day-to-day work
- LLM-assisted issue creation — describe a problem in plain English; grit generates a structured issue
- Multiple LLM providers — Anthropic (Claude), Groq, Ollama (local), or no AI at all
- Complete issue management — create, list, view, edit, close, assign, comment, link, and search
- Sub-issues — create child issues linked to a parent
- Issue linking — relate issues with typed relationships (blocks, duplicates, parent/child, etc.)
- Search — find issues with GitHub's search API, filtered by state and label
- Self-update — run
grit updateto fetch the latest release from GitHub - Cross-platform — Linux, macOS, and Windows on amd64 and arm64
Requires Go 1.25 or later.
go install github.com/dulait/grit/cmd/grit@latestDownload the binary for your platform from the releases page.
Linux / macOS:
curl -LO https://github.com/dulait/grit/releases/latest/download/grit_VERSION_OS_ARCH.tar.gz
tar -xzf grit_VERSION_OS_ARCH.tar.gz
sudo mv grit /usr/local/bin/Windows:
- Download the
.zipfile from the releases page - Extract
grit.exe - Move it to a directory in your
PATH
If you already have grit installed from a release binary:
grit updategrit version# 1. Initialize grit in your project
grit init
# 2. Authenticate with GitHub
grit auth login
# 3. Create an issue with AI assistance
grit issue create "describe your issue here"
# 4. Launch the interactive TUI
grit| Guide | Description |
|---|---|
| Getting Started | Installation, setup, and your first issue |
| CLI Reference | Every command, flag, and argument |
| TUI Guide | Interactive mode walkthrough and keybindings |
| Configuration | Config file format and LLM provider setup |
| Updating | Keeping grit up to date |
| Contributing | Development setup and contribution guidelines |
MIT License — see LICENSE for details.