https://github.com/aloglu/triage
Keyboard-first TUI for managing software project items with optional GitHub Issues sync.
https://github.com/aloglu/triage
bubbletea github-issues go productivity terminal tui
Last synced: 11 days ago
JSON representation
Keyboard-first TUI for managing software project items with optional GitHub Issues sync.
- Host: GitHub
- URL: https://github.com/aloglu/triage
- Owner: aloglu
- License: mit
- Created: 2026-04-06T08:28:23.000Z (about 2 months ago)
- Default Branch: main
- Last Pushed: 2026-04-10T17:40:20.000Z (about 2 months ago)
- Last Synced: 2026-04-10T19:06:46.372Z (about 2 months ago)
- Topics: bubbletea, github-issues, go, productivity, terminal, tui
- Language: Go
- Size: 680 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# triage
`triage` is a terminal workspace for managing software project work.
It is built for fast capture, editing, filtering, and review from the keyboard. You can use it as a local tool or sync items to GitHub Issues.
## Getting Started
Install with Go:
```bash
go install github.com/aloglu/triage/cmd/triage@latest
```
Or from source:
```bash
make install
triage
```
`triage` installs into your Go bin directory, usually `$(go env GOPATH)/bin`. If the command is not found after install, add that directory to your `PATH`:
```bash
export PATH="$PATH:$(go env GOPATH)/bin"
```
On first launch, choose where your items should live. If you enable GitHub sync, `gh` must already be installed and authenticated, and `triage` will ask for a default repository.
## Working Model
Each item has five core parts:
- title
- project
- type (`feature`, `bug`, `chore`)
- stage (`idea`, `planned`, `active`, `blocked`, `done`)
- body
The main views are `all`, `archive`, and `trash`.
In GitHub mode, edits are kept locally until you sync, so capture and editing stay quick even when GitHub is involved.
You can also drop draft files into a configurable drafts folder and let `triage` import them on startup or with `:drafts`.
## GitHub Sync
`triage` can sync to:
- a default repo
- a project-level repo default
- a per-item repo override
That makes it practical to keep a general inbox while routing project-specific work to dedicated repositories.
## Development
```bash
make run
make test
make build
```
## License
Released under the [MIT License](https://github.com/aloglu/triage/blob/main/LICENSE).