ghbounty

A GitHub bounty aggregator CLI. Find and track open bounties across GitHub repositories.

Install

npm install -g ghbounty

Or run directly:

npx ghbounty scan

Setup

Set a GitHub token for higher API rate limits (optional but recommended):

export GITHUB_TOKEN=ghp_your_token_here

Usage

Scan for bounties

# Find all open bounties
ghbounty scan

# Filter by minimum amount and language
ghbounty scan --min 200 --lang typescript

# Deep scan (multiple search strategies, finds more results)
ghbounty scan --deep

# Sort by comments (popular/competitive bounties)
ghbounty scan --sort comments

# Output as JSON for scripting
ghbounty scan --json

# Show detailed info for each bounty
ghbounty scan --detail

Watch mode

Continuously monitor for new bounties with desktop notifications:

# Default: check every 5 minutes
ghbounty watch

# Check every 60 seconds for TypeScript bounties over $500
ghbounty watch --min 500 --lang typescript --interval 60

# Quiet mode: only desktop notifications, no console output
ghbounty watch --quiet

Stats

Track your bounty hunting activity:

# View stats dashboard
ghbounty stats

# Export stats as JSON
ghbounty stats --json

# Reset all stats
ghbounty stats --reset

Open a bounty

ghbounty open https://github.com/org/repo/issues/123

How it works

1. Scan — Searches GitHub Issues API for bounty-labeled issues (bounty, reward, bug bounty, etc.)
2. Parse — Extracts dollar amounts from issue titles, labels, and bodies using pattern matching
3. Enrich — Fetches repository metadata (language, etc.) for each result
4. Display — Renders a formatted table sorted by bounty value
5. Notify — Sends macOS desktop notifications for new bounties in watch mode
6. Track — Persists scan history and stats to ~/.ghbounty/

Filters

| Flag | Description | Example | |------|-------------|---------| | --min <n> | Minimum bounty amount (USD) | --min 200 | | --max <n> | Maximum bounty amount (USD) | --max 5000 | | --lang <lang> | Programming language | --lang rust | | --sort <field> | Sort by: created, updated, comments | --sort comments | | --limit <n> | Max results | --limit 50 | | --deep | Multi-strategy scan | --deep |

Data storage

Stats and seen-bounty tracking are stored in ~/.ghbounty/:

~/.ghbounty/
  stats.json    — scan history & aggregated stats
  seen.json     — URLs of previously seen bounties (for watch mode)

Dependencies

• commander — CLI framework
• Node.js built-in fetch (Node 18+)

Zero other runtime dependencies.

License

MIT