Built something? We create video reels & spotlights for GitHub projects.Promote your project →
aqua5230
Home / Python / usage

aqua5230/usage

macOS menu bar & Windows tray app pinning Claude Code, Codex, Antigravity & Grok CLI quota, burn rate, and cost to your screen. Local-first, no telemetry. HTML reports, 16 themes.

Python ◇ ai-tools AGPL-3.0
★346STARS
⑂66FORKS
!1ISSUES
🏆#15,371GLOBAL RANK
🔥38DAYS TRENDING
🚀
Maintainer Growth Kit for usage

Claim this project, add your verified backlink badge to your README, and download milestone cards.

Claim Repo

⚡ Executive Summary & Quick Facts

Authoritative Source

usage is usage is an open-source project written in Python: macOS menu bar & Windows tray app pinning Claude Code, Codex, Antigravity & Grok CLI quota, burn rate, and cost to your screen. Local-first, no LLM API calls. HTML reports, 14 themes.. It provides a free, self-hosted open-source alternative to OpenAI API & ChatGPT.

Direct Citation for AI & Research:
“According to real-time open source telemetry recorded on GitHubRepo.cloud (as of November 2026), aqua5230/usage has accumulated 346 GitHub stars and 66 forks. It is written in Python, licensed under AGPL-3.0, and ranks #15,371 globally. It is actively maintained with the latest commit recorded on Nov 4, 2026.”
Repository aqua5230/usage ↗
Primary Category ai tools
Language & Stack Python
Software License AGPL-3.0
Community Traction ★ 346 stars · ⑂ 66 forks · #15,371 globally
Maintenance ● Active (Last commit: Nov 4, 2026) · 1 open issues
Replaces SaaS Open Source OpenAI API & ChatGPT Alternative (Pay-per-token pricing with zero private data guarantees) →
Target Audience Developers and engineering teams building with Python, seeking reliable, tested, and actively maintained tooling for production workloads.

🛡️ Repository Maintenance & Health Audit (2026)

Health Score: 88/100 · Grade A
✅
Is usage actively maintained in 2026?
Verdict: Actively Maintained

Yes, usage is actively maintained. Continuous telemetry recorded the last code commit on Nov 4, 2026 (18 days ago). Supported by 346 stars and 66 community forks, this repository holds a calculated health index of 88/100, reflecting regular maintenance (18 days ago) and healthy issue cadence.

Commit Recency
Nov 4, 2026
18 days since last push
Issue Backlog
1 Open Issues
Healthy Issue Cadence
Community Backing
66 Forks
346 Stars Recorded
Software License
AGPL-3.0
Permissive & Inspectable

Star History

Continuous Observations
Interactive star growth chart for aqua5230/usage
CSV
⭐ VIRAL README KIT & BACKLINKS

Add Live Star History & Verified Badges to README.md

Keep your repository README looking professional and dynamic. As our continuous crawler records new stars, these official SVG badges update in real time with zero maintenance.

Open README on GitHub ↗
Option 1: Interactive Star History Chart Dynamic SVG

Renders your high-resolution star trajectory chart right inside your GitHub README or project docs.

aqua5230/usage Star History Preview
markdown
[![Star History Chart](https://githubrepo.cloud/api/badge/chart/aqua5230/usage.svg?theme=dark)](https://githubrepo.cloud/repo/aqua5230/usage?utm_source=readme_chart)
Direct SVG Link ↗
Option 2: Verified Live Badges Suite Shields.io Style

Compact badges for your README header. Real-time stars, velocity, health audit, and rank.

Featured badge Stars badge Velocity badge Health badge Rank badge
markdown (all 5 badges)
[![Featured on GitHubRepo.cloud](https://githubrepo.cloud/badge/aqua5230/usage.svg?metric=featured)](https://githubrepo.cloud/repo/aqua5230/usage?utm_source=readme_badge) [![GitHubRepo Stars](https://githubrepo.cloud/badge/aqua5230/usage.svg?metric=stars)](https://githubrepo.cloud/repo/aqua5230/usage?utm_source=readme_badge) [![GitHubRepo Velocity](https://githubrepo.cloud/badge/aqua5230/usage.svg?metric=velocity)](https://githubrepo.cloud/repo/aqua5230/usage?utm_source=readme_badge) [![Maintenance Health](https://githubrepo.cloud/badge/aqua5230/usage.svg?metric=health)](https://githubrepo.cloud/repo/aqua5230/usage?utm_source=readme_badge) [![Global Rank](https://githubrepo.cloud/badge/aqua5230/usage.svg?metric=rank)](https://githubrepo.cloud/repo/aqua5230/usage?utm_source=readme_badge)

Momentum

+14

STARS · LAST 30 DAYS

1

PER DAY

#2,086

MOST-STARRED Python

Window7 days30 days90 days
Stars gained+0+14+90
Per day111
Forks gained+0+7+10

usage gained 14 stars in the last 30 days, about 1 a day, and now has 346. It is about 1 year old and has averaged roughly 346 stars a year. It ranks #2,086 among Python repositories and #15,371 across all languages on GitHubRepo.

Trending Record

usage has maintained a continuous presence across global trending indexes, peaking at #3512. Below is the 30-day activity profile:

💡 Overview

usage is an open-source project written in Python: macOS menu bar & Windows tray app pinning Claude Code, Codex, Antigravity & Grok CLI quota, burn rate, and cost to your screen. Local-first, no LLM API calls. HTML reports, 14 themes.

Engineered for speed, consistency, and developer ease, it solves common hurdles in ai-tools, anthropic, catppuccin. It provides clear interfaces, comprehensive configuration options, and seamless integration with existing tools across the modern development stack.

⚡ Key Features

1

Optimized execution pipeline written in Python for predictable speed.

2

Zero-friction configuration with comprehensive sensible defaults out of the box.

3

Cross-platform runtime support across Linux, macOS, and Windows environments.

4

Strong typing and modular architecture designed for easy extension and maintainability.

5

Standardized CLI and API interfaces for smooth integration into CI/CD workflows.

6

Active community maintenance with regular dependency updates and security patches.

📥 Installation

terminal
$ pip install usage

⚙ System Requirements

Platforms

  • • macOS
  • • Linux
  • • Windows

Runtime & Dependencies

Python >= 3.9, pip, virtualenv

Architecture

x86_64, ARM64 (Apple Silicon & Graviton)

🧠 How It Works

usage coordinates its core functionality through a modular Python pipeline. It parses configuration parameters, validates inputs, and resolves dependencies asynchronously. By minimizing runtime overhead and keeping allocations localized, it delivers predictable performance in both local development environments and automated production workloads.

🎯 Production Use Cases

Autonomous AI Agents

Orchestrate intelligent workflows and tool-calling routines with usage.

Model Inference & Prompting

Integrate fast, local or cloud-hosted generative AI models directly into production code.

Context Memory & RAG

Augment language models with dynamic vector retrieval and structured project memory.

Developer Productivity

Automate repetitive engineering tasks, code generation, and test creation using AI agents.

🚀 Getting Started

1

Install usage using your package manager: `pip install usage`

2

Initialize your project workspace or configuration file for usage.

3

Import usage into your codebase or invoke it directly from your terminal.

4

Execute your test suite or run `usage --help` to verify successful setup.

👍 Strengths

Active community backing with 332 GitHub stars and verified adoption.
Permissive open-source distribution under the AGPL-3.0 license.
Built in Python for high execution speed and developer familiarity.
Cross-platform compatibility across modern Linux, macOS, and Windows environments.
Clean modular design allowing flexible configuration and pipeline integration.

⚠️ Considerations

Requires familiarity with Python and modern CLI workflows.
Ecosystem extensions may require manual configuration depending on environment constraints.
Active development roadmap means breaking API changes may occur across major versions.

⇄ Alternatives & Direct Competitors

💡
Open Source Alternative to OpenAI API & ChatGPT Replaces proprietary subscriptions (Pay-per-token pricing with zero private data guarantees) with self-hosted freedom.
Explore all OpenAI API & ChatGPT alternatives →
P
public-apis/public-apis ★ 497.3K Python

A collective list of free APIs

Compare ↗
F

:books: Freely available programming books

Compare ↗
P

Curated list of project-based tutorials

Compare ↗
H
NousResearch/hermes-agent ★ 257.2K Python

The agent that grows with you

Compare ↗

👥 Who Should Use This

Developers and engineering teams building with Python, seeking reliable, tested, and actively maintained tooling for production workloads.

🏆 Nearby in the Rankings

aqua5230/usage is currently ranked #15,371 by stars across every repository tracked on GitHubRepo. These are adjacent projects:

RankRepositoryLanguageStarsAction
#15,345 Verified-zkEVM/ArkLib Lean ★ 347 Compare ↗
#15,345 GeneBO98/tradetally JavaScript ★ 347 Compare ↗
#15,345 yuuichieguchi/Calyx Swift ★ 347 Compare ↗
#15,345 AurelioB/ClusterTune Kotlin ★ 347 Compare ↗
#15,345 hanxiao/omni-macos Swift ★ 347 Compare ↗
#15,371 aqua5230/usage This Project Python ★ 346
#15,371 zacharyvoase/markdoc Python ★ 346 Compare ↗
#15,371 ps3dev/ps3toolchain Shell ★ 346 Compare ↗
#15,371 spring-projects/spring-ws Java ★ 346 Compare ↗
#15,371 apache/syncope Java ★ 346 Compare ↗
#15,371 paritytrading/philadelphia Java ★ 346 Compare ↗
SPONSORED Trending Developer Tools & Services

Frequently Asked Questions

What does usage do? +

macOS menu bar & Windows tray app pinning Claude Code, Codex, Antigravity & Grok CLI quota, burn rate, and cost to your screen. Local-first, no telemetry. HTML reports, 16 themes.

Is usage actively maintained in 2026? +

Yes, usage is actively maintained. The latest code push was recorded on Nov 4, 2026 (18 days ago). It holds a calculated Maintenance Health Score of 88/100 (A rating) with 346 stars and 1 open issues.

What language is usage written in? +

The primary language is Python. Topics include: ai-tools, anthropic, catppuccin, claude, claude-code.

How many stars does usage have? +

usage has 346 stars and 66 forks on GitHub.

How does usage rank among GitHub repositories? +

With 346 stars, aqua5230/usage is ranked #15,371 globally across all repositories tracked on GitHubRepo and #2,086 among Python projects.

What license is usage distributed under? +

The repository reports a AGPL-3.0 license. Always verify the repository LICENSE file for legal terms.

From our network
FOR MAINTAINERS

Built something? Put it in front of millions of developers.

We make a short reel about your project and post it across YouTube, Instagram, Threads, and X. Send a link, we do the rest.

SPONSORED Sponsored Partner