Skip to content

aloglu/triage

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

43 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

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.

triage screenshot

Getting Started

Install with Go:

go install github.com/aloglu/triage/cmd/triage@latest

Or from source:

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:

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

make run
make test
make build

License

Released under the MIT License.

About

Keyboard-first TUI for managing software project items with optional GitHub Issues sync

Topics

Resources

License

Stars

Watchers

Forks

Packages