cosmic-applet-github-status

A COSMIC panel applet that shows the number of GitHub PRs waiting for your review.

Features

• Displays a count of open PRs where you are a requested reviewer and have not yet approved

• Shows the count as a badge directly on the panel icon — colour indicates urgency:

  State	Badge colour
  Error	Red
  0 PRs	Green
  1–5 PRs	Blue
  6–10 PRs	Yellow
  11+ PRs	Red

• Click the applet to open a popup with the current count

• Click Open GitHub to go directly to your GitHub review queue

• Settings — configure authentication and poll interval:

  • GitHub CLI — uses gh CLI, no token needed; shows connected account
  • Personal Access Token (PAT) — uses the GitHub REST API via curl
  • Poll interval — choose between 30 sec, 1 min, 2 min, 5 min, 10 min, or 30 min

Screenshots

Panel icon	Popup	Settings

Requirements

• COSMIC desktop environment

GitHub CLI mode (default):

• GitHub CLI (gh) — authenticated via gh auth login

PAT mode:

• curl — available by default on most Linux systems
• A GitHub Personal Access Token with repo scope

Quick install

bash <(curl -fsSL https://raw.githubusercontent.com/Laeborg/cosmic-applet-github-status/main/install.sh)

Building from source

1. Build

cargo build --release

2. Install files

sudo just install

To uninstall:

sudo just uninstall

3. Add to panel

Right-click the COSMIC panel → Edit panel → click + → select GitHub Status.

4. Authenticate

Click the applet → Settings → choose your authentication method:

• GitHub CLI: run gh auth login in a terminal first, then click Check again in settings to verify
• PAT: paste your Personal Access Token and click Save

Development

• cargo build — debug build
• cargo build --release — release build
• cargo run --release — run standalone (outside the panel, for testing)
• cargo clippy — lint

Links

• libcosmic API documentation
• libcosmic book
• GitHub CLI