Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/brianhicks/xbar-review-request-status

Format GitHub review requests for use in an xbar script
https://github.com/brianhicks/xbar-review-request-status

Last synced: 2 months ago
JSON representation

Format GitHub review requests for use in an xbar script

Awesome Lists containing this project

README

        

# xbar review request status

This is an [xbar](https://xbarapp.com/) plugin that creates a view of your open GitHub review requests.
The menubar item opens to a list of linked PRs.

## Installing

This repo is managed using Nix, so you can do something like:

```sh
cachix use xbar-review-request-status # if you have cachix installed
nix-env -if https://github.com/BrianHicks/xbar-pr-status/archive/refs/heads/main.tar.gz
```

If you have a Rust toolchain set up, you can also clone this repo and run `cargo build`.

### Setting Up

[Create a personal GitHub access token in your developer settings](https://github.com/settings/tokens).
It needs the `repo` (all) and `read:user` scopes (you can see the exact query we make at `src/review_requests.graphql`.)

After you install xbar-review-request-status, create a new plugin like `~/Library/Application Support/xbar/plugins/rrs.5m.sh` that looks like this:

```bash
#!/usr/bin/env bash
xbar-review-request-status ghp_AAAAAAAAAAA
```

Make that file executable (`chmod +x`) and tell xbar to reload all plugins to pick it up.
(You should also be able to run it yourself to check if things look OK.)

If you want to customize the emojis used, run `xbar-pr-status --help` to see the options available to you.

## License

xbar-review-request-status is licensed under [The Hippocratic License](https://firstdonoharm.dev/), version 3.0. See LICENSE in the source for the applicable modules to this project.