gh-triage is a tool that helps you manage and triage GitHub issues, pull requests, and discussions through unread notifications.

Key features of gh-triage are:

• Done: Mark Issues, Pull Requests, and Discussions that match specified conditions as done
• Read: Mark Issues, Pull Requests, and Discussions that match specified conditions as read
• Unsubscribe: Unsubscribe from notifications for Issues, Pull Requests, and Discussions that match specified conditions
• Open: Open Issues, Pull Requests, and Discussions that match specified conditions in a browser
• List: Display Issues, Pull Requests, and Discussions that match specified conditions in a list

ref: Managing notifications from your inbox

$ gh triage

gh-triage supports multiple configuration profiles. You can create different profiles for different workflows or environments.

# Use default profile
$ gh triage

# Use specific profile
$ gh triage --profile work
$ gh triage -p personal

• Default profile: default.yml
• Named profiles: {profile-name}.yml

For example:

• ~/.local/share/gh-triage/default.yml (default profile)
• ~/.local/share/gh-triage/work.yml (work profile)
• ~/.local/share/gh-triage/personal.yml (personal profile)

$ gh extension install k1LoW/gh-triage

The configuration file is located at:

• ${XDG_DATA_HOME}/gh-triage/default.yml (if XDG_DATA_HOME is set)
• OR ~/.local/share/gh-triage/default.yml (default location)

It will be automatically created on first run.

If you are upgrading from a previous version, your existing config.yml will be automatically migrated to default.yml on first run. The migration process:

1. Checks if default.yml exists
2. If not, looks for the old config.yml file
3. If found, copies the content to default.yml
4. Removes the old config.yml file
5. Logs the migration process

This ensures a smooth transition without losing your existing configuration.

done:
  max: 1000
  conditions: # Auto-mark merged and closed PRs / issues as done
    - "merged"
    - "closed"

open:
  max: 1
  conditions: # Open PRs awaiting my review
    - "is_pull_request && me in reviewers && passed && !approved && open && !draft"

list:
  max: 1000
  conditions: # List all unread notifications
    - "*"

• done: Conditions and maximum number for marking as done
• read: Conditions and maximum number for marking as read
• unsubscribe: Conditions and maximum number for unsubscribing from notifications
• open: Conditions and maximum number for opening in browser
• list: Conditions and maximum number for listing

Each action has the following parameters:

• max: Maximum number of items to process at once
• conditions: Processing conditions (no processing if empty array)

gh-triage retrieves the following information for each notification, which can be used in condition evaluation:

Conditions are evaluated using the expr-lang library. You can write conditions such as:

conditions:
  - "merged"                    # Merged Pull Request
  - "closed"                    # Closed Issue/PR/Discussion
  - "approved"                  # Approved Pull Request
  - "is_pull_request"           # Pull Request
  - "is_issue"                  # Issue
  - "is_discussion"             # Discussion
  - "answered"                  # Answered Discussion
  - "state == 'open'"           # Open state
  - "passed"                    # All checks passed

conditions:
  - "merged && approved"                   # Merged and approved
  - "is_pull_request && state == 'open'"   # Open Pull Request
  - "author == 'username'"                 # Created by specific user
  - "len(labels) > 0"                      # Has labels

conditions:
  - "'bug' in labels"                      # Has bug label
  - "'hotfix' in labels"                   # Has hotfix label
  - "len(assignees) > 0"                   # Has assignees
  - "'APPROVED' in review_states"          # Review states include approved

conditions:
  - "*"                                    # Match all (always true)

done:
  max: 1000
  conditions:
    - "merged"
    - "closed"

done:
  max: 100
  conditions:
    - "is_pull_request && failed"

read:
  max: 1000
  conditions:
    - "merged"

# Use default profile
$ gh triage

# Use work profile
$ gh triage --profile work

# Use personal profile
$ gh triage -p personal

open:
  max: 5
  conditions:
    - "author == me"
    - "me in assignees"

list:
  max: 100
  conditions:
    - "'urgent' in labels"
    - "'bug' in labels"

read:
  max: 1000
  conditions:
    - "is_pull_request && state == 'open' && !approved"

unsubscribe:
  max: 100
  conditions:
    - "closed" # Closed Issues/Discussions
    - "merged" # Merged Pull Requests

done:
  max: 100
  conditions:
    - "is_discussion && answered"

list:
  max: 100
  conditions:
    - "is_discussion && !answered && open"

To use this project from source, instead of a release:

go build .
gh extension remove triage
gh extension install .