Skip to content

codeGROOVE-dev/goose

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Review Goose 🪿

Beta Platform Goose Noises GitHub

Review Goose Logo

The only PR tracker that honks at you when you're the bottleneck. Now shipping with 100% more goose noises!

Lives in your menubar like a tiny waterfowl of productivity shame, watching your GitHub PRs and making aggressive bird sounds when you're blocking someone's code from seeing the light of production.

Review Goose Screenshot

What It Does

  • Honks when you're blocking someone's PR (authentic goose noises included)
  • Jet sounds when your own PR is ready for the next stage
  • Smart turn-based assignment - knows who is blocking a PR, knows when tests are failing, etc.
  • Auto-start on login (macOS)
  • Auto-open incoming PRs in your browser (off by default, rate-limited)
  • Org Filtering for orgs you may not care about in a home or work context
  • Multi-platform support for Linux, macOS, Windows, FreeBSD, whatever.

You can also visit the web-based dashboard at https://dash.ready-to-review.dev/

Dependencies

  • go 1.23.4 or higher
  • gh, AKA the GitHub command-line utility

macOS Quick Start ⚡ (Get Honked At)

Install dependencies:

brew install gh go

Confirm that gh is properly authenticated:

gh auth status || gh auth login

Build & run:

git clone https://github.com/ready-to-review/goose.git
cd goose && make run

This will will cause the goose to implant itself into /Applications/Review Goose.app for future invocations. To be persistently annoyed every time you login, click the Start at Login menu item.

Using a fine-grained access token

If you want more control over which repositories the goose can access, you can use a fine-grained personal access token with the following permissions:

  • Pull requests: Read
  • Metadata: Read

You can then use the token like so:

env GITHUB_TOKEN=your_token_here goose

We don't yet persist fine-grained tokens to disk - PR's welcome!

Known Issues

  • Visual notifications won't work on macOS until we release signed binaries.

Pricing

  • Free forever for public repositories ❤️
  • Private repo access will soon be a supporter-only feature to ensure the goose is fed. ($1/mo)

Privacy

  • Your GitHub token is used to authenticate against GitHub and codeGROOVE's API for state-machine & natural-language processing
  • Your GitHub token is never stored or logged.
  • PR metadata may be cached locally & remotely for up to 20 days
  • No data is resold to anyone. We don't even want it.
  • No telemetry is collected

Built with 🪿 by codeGROOVE - PRs welcome!

About

Menu bar app for smart GitHub pull request notifications

Resources

License

Security policy

Stars

Watchers

Forks

Packages

No packages published

Contributors 3

  •  
  •  
  •