https://github.com/dulait/grit
Grit is a simple, fast, and extensible CLI tool written in Go for managing GitHub issues across multiple projects
https://github.com/dulait/grit
cli github go golang issues llm
Last synced: 4 months ago
JSON representation
Grit is a simple, fast, and extensible CLI tool written in Go for managing GitHub issues across multiple projects
- Host: GitHub
- URL: https://github.com/dulait/grit
- Owner: dulait
- License: mit
- Created: 2026-01-19T19:43:17.000Z (5 months ago)
- Default Branch: main
- Last Pushed: 2026-02-06T02:09:49.000Z (5 months ago)
- Last Synced: 2026-02-06T09:27:22.697Z (5 months ago)
- Topics: cli, github, go, golang, issues, llm
- Language: Go
- Homepage:
- Size: 86.9 KB
- Stars: 2
- Watchers: 0
- Forks: 0
- Open Issues: 20
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Grit
A CLI and TUI tool for LLM-assisted GitHub issue management.
[](https://go.dev)
[](LICENSE)
[](https://github.com/dulait/grit/releases/latest)
## Features
- **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 update` to fetch the latest release from GitHub
- **Cross-platform** — Linux, macOS, and Windows on amd64 and arm64
## Installation
### Using Go
Requires Go 1.25 or later.
```bash
go install github.com/dulait/grit/cmd/grit@latest
```
### From GitHub Releases
Download the binary for your platform from the [releases page](https://github.com/dulait/grit/releases).
**Linux / macOS:**
```bash
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:**
1. Download the `.zip` file from the releases page
2. Extract `grit.exe`
3. Move it to a directory in your `PATH`
### Self-update
If you already have grit installed from a release binary:
```bash
grit update
```
### Verify
```bash
grit version
```
## Quick Start
```bash
# 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
```
## Documentation
| Guide | Description |
|-------|-------------|
| [Getting Started](docs/getting-started.md) | Installation, setup, and your first issue |
| [CLI Reference](docs/cli-reference.md) | Every command, flag, and argument |
| [TUI Guide](docs/tui-guide.md) | Interactive mode walkthrough and keybindings |
| [Configuration](docs/configuration.md) | Config file format and LLM provider setup |
| [Updating](docs/updating.md) | Keeping grit up to date |
| [Contributing](CONTRIBUTING.md) | Development setup and contribution guidelines |
## License
MIT License — see [LICENSE](LICENSE) for details.