goose

Review Goose 🪿

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.

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.

Linux/BSD/Windows Quick Start

1. Install the GitHub CLI and Go via your platforms recommended methods
2. Compile and install Goose:

go install github.com/codeGROOVE-dev/goose/cmd/review-goose@latest

1. Copy goose from $HOME/go/bin to wherever you prefer
2. Add goose to your auto-login so you never foget about PRs again

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!

Usage

• macOS/Windows: Click the tray icon to show the menu
• Linux/BSD: Right-click the tray icon to show the menu (left-click refreshes PRs)

Known Issues

• Visual notifications won't work reliably on macOS until we release signed binaries.
• Tray icons on GNOME require snixembed and enabling the Legacy Tray extension. Goose will automatically launch snixembed if needed, but you must install it first (e.g., apt install snixembed or yay -S snixembed).

Pricing

• Free forever for public open-source 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

License

This project is licensed under the GPL-3.0 License - see the LICENSE file for details.

Built with 🪿 by codeGROOVE - PRs welcome!