QuotaHalo-Linux

skill
Guvenlik Denetimi
Uyari
Health Uyari
  • License — License: MIT
  • Description — Repository has a description
  • Active repo — Last push 0 days ago
  • Low visibility — Only 5 GitHub stars
Code Uyari
  • network request — Outbound network request in quota_halo_status.py
Permissions Gecti
  • Permissions — No dangerous permissions requested

Bu listing icin henuz AI raporu yok.

SUMMARY

A GNOME Shell top-bar widget for Linux that shows your GitHub Copilot, OpenAI Codex, and Claude Code usage quotas alongside system status.

README.md

QuotaHalo Linux

中文说明

QuotaHalo Linux is a GNOME top-bar widget that keeps your Copilot, Codex, and Claude usage quotas on screen, along with local system status.

What It Shows

  • GitHub Copilot AI Credits usage
  • OpenAI Codex 5-hour and 7-day quotas
  • Claude Code 5-hour and 7-day quotas
  • CPU, memory, and GPU usage
  • Network download/upload speed

Data Sources

Codex and Claude quotas come directly from the subscription information of the currently signed-in account, with no extra configuration required.

Copilot requires a GitHub token to read AI Credits usage. Copy .env.example and fill it in:

GITHUB_TOKEN=your_github_personal_access_token_here
GITHUB_USERNAME=your_github_username_here

Getting a GitHub Fine-Grained Personal Access Token

  1. Open GitHub Settings > Developer settings > Personal access tokens > Fine-grained tokens.
  2. Click Generate new token.
  3. Give it a name, for example Copilot Usage Monitor.
  4. Under Repository access, choose Public Repositories (read-only) or All repositories. QuotaHalo only reads account-level billing information and does not read repository contents.
  5. Under Account permissions, find Plan and set it to Read-only.
  6. Click Generate token, then copy the generated token into GITHUB_TOKEN in .env.

Note: the token must have the Plan: Read-only permission, otherwise it cannot read billing and usage information.

Install

git clone https://github.com/eddy0619/QuotaHalo-Linux.git
cd QuotaHalo-Linux

# Optional: only needed if you want Copilot usage
cp .env.example .env
# Fill in .env

./install.sh

If the top bar does not update immediately after installation:

  • X11: press Alt+F2, type r, and press Enter.
  • Wayland: log out and back in.

Requirements

  • Linux + GNOME Shell
  • Python 3.10+

The install script automatically installs the required Python dependencies: requests and python-dotenv.

License

This project is licensed under the MIT License. See LICENSE for details.

Attribution

QuotaHalo Linux is an unofficial project. It is not affiliated with, endorsed by, or sponsored by GitHub, Microsoft, OpenAI, Anthropic, or the GNOME Foundation.

Special thanks to the following open-source projects for reference:

  • burninc0de/copilot-usage-tracker

  • steipete/CodexBar

  • The GitHub and GitHub Copilot names, logos, and related icons are owned by GitHub, Inc. and/or Microsoft Corporation.

  • The OpenAI and Codex names, logos, and related icons are owned by OpenAI.

  • The Claude and Anthropic names, logos, and related icons are owned by Anthropic.

  • The GNOME and GNOME Shell names are owned by the GNOME Foundation and its respective rights holders.

  • Third-party names and icons that appear in this project are used solely to identify the corresponding services; these third-party assets are not covered by this project's MIT License.

  • Copilot usage data comes from the GitHub REST Billing API; the token permission requirements follow the Plan: Read-only permission for Fine-grained Personal Access Tokens described in GitHub's official documentation.

All trademarks, service names, and icons not explicitly listed remain the property of their respective rights holders.

Yorumlar (0)

Sonuc bulunamadi