gh-oss

Stop scrolling https://goodfirstissue.dev. Find issues where you already work.

gh-oss is a GitHub CLI extension that helps you discover open source issues from your terminal, with a fast TUI for browsing and saving.

Install

gh extension install maxbeizer/gh-oss

Quick start

gh oss find

gh oss find --lang go --label good-first-issue
gh oss find --lang go,rust --topic cli --stars ">100"
gh oss find --org cli --repo cli/cli
gh oss find --user marcus

gh oss profile --lang go,typescript --topic cli --stars 50
gh oss saved

Commands

gh oss find

Interactive TUI browser for open issues.

Flags:

• --lang go,rust
• --label good-first-issue,help-wanted
• --stars ">100"
• --recent 7d
• --topic cli
• --org kubernetes
• --repo cli/cli
• --user marcus

By default, results are sorted by most recently updated and filtered to issues updated within the last year. Issues labeled stale are excluded.

Note: --recent filters by updated date and supports days (7d), months (6m), and years (1y). Use --recent none to disable the default filter and see all matching issues.

Controls:

• Arrow keys to navigate
• Enter to view issue details
• o to open in browser
• s to save/bookmark
• esc to go back
• q to quit

gh oss profile

View or set default preferences stored in ~/.gh-oss/profile.json.

gh oss profile --lang go,typescript --topic cli --label good-first-issue,help-wanted --stars 50

gh oss saved

View saved issues in a TUI list. Press d to remove an issue.

gh oss save <issue-url>

Bookmark an issue directly from a URL.

gh oss unsave <issue-url>

Remove a bookmarked issue.

gh oss stats

Show your OSS contribution stats (PRs to repos you don’t own), including:

• Total PRs
• Repos contributed to
• Languages breakdown
• Recent contributions

Profile format

{
  "languages": ["go", "typescript"],
  "topics": ["cli", "developer-tools"],
  "labels": ["good-first-issue", "help-wanted"],
  "minStars": 50,
  "orgs": [],
  "repos": [],
  "users": []
}

Development

make build        # build the binary
make test         # run unit tests
make ci           # full CI check (build + vet + test-race)
make fmt          # format code

See CONTRIBUTING.md for more details.

License

MIT