GitBar

GitBar is an xbar plugin that will keep you updated on the branches and open pull requests on one or many repository. It refreshes every minute by default.

Information displayed

Header

• Name and status icon for the first repo of the list with :
  • PR ready to merge counter (✅)
  • PR with changes requested counter (❌)
  • PR with review requested counter (👀)

Per-repository display

• Repository name (link with a status icon for the default branch)
• Status checks (each check’s description, direct link, and relative time)
  • On my setup, I get the CI and Deployment status checks (TODO : Should become configurable)
• Pull requests grouped:
  • Review requested (👀)
  • Already reviewed (👍) (or no reviews needed)
  • Your open PRs (🤓)
• Branches without an open PR :
  • Number of branches (🌳)
  • List of branches (🔗) with a link to "compare and open PR" page
  • Not displayed if there are no branches without an open PR
• Open in terminal (💻)
  • Link to the local path of the repository (if configured)
• For each PR:
  • Title (link)
  • Branch name (link)
  • Latest review state per reviewer
  • Combined status check state (CI status, Deployment status if any)
  • Mergeability (No conflict, Conflicts, etc)
  • Time since last update (for items awaiting your review)

Footer:

• “Last updated” timestamp
• “Offline mode” message if connection is lost

Installation

Git Clone this repo, cd in the folder and run the following commands to install the plugin:

As said above, it is an xbar plugin, so you'll need it installed to use GitBar :

brew install --cask xbar

GitBar uses gh to fetch the latest release of the repo. You will need to install GitHub CLI to use GitBar and also login to your github account.

brew install gh
gh auth login

Inside gitbar_app/config, you'll find a settings.json.example, update the username and repositories list before next step and rename it to settings.json.

Finally, there is a script to install the app in xbar plugins. Make this script executable and run it to copy the GitBar plugin inside the xbar plugins folder. You don't have to use this script, it is just here to make it easier to copy the plugin files to the correct location.

chmod +x copy_to_plugins.sh
./copy_to_plugins.sh

You can change the refresh rate by changing the "1m" in the name of this file to any other time value 10s, 2h, etc (if you want to do it manually, just rename the file to the new time value and re-run ./copy_to_plugins.sh).

gitbar.10s.rb
gitbar.2h.rb

Whenever you need to make changes to the config file, update the settings.json file and re-run ./copy_to_plugins.sh

Offline mode

Whenever the GitBar runs, it will check if you are connected to the internet. If you are, it will fetch all the data needed and persist it in the view.json file. If you are not, it will display a message in the header and the footer and use the last persisted data in the view.json file.

Last updated: 2025-10-19 12:00:00
Offline mode

Troubleshooting

If you are having issues with the plugin, please check the following:

• Make sure you are connected to the internet
• Make sure you are logged in to your GitHub account with gh auth login
• Make sure you have the gh CLI installed and configured

If you are still having issues, please open an issue on the GitHub repository.

Contributing

If you want to contribute to the project, please feel free to fork the repository and open a pull request.

Credits

• GitHub CLI
• xbar