amirfish1

Usage On Mac — Development skill for Claude Code

Development community

SwiftBar plugin for Anthropic Pro/Max weekly usage % on macOS.

How to install Usage On Mac

This entry records only its repository, not the path inside it, so there is no exact command to give. Open amirfish1/usage_on_mac and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Usage On Mac does

SwiftBar plugin for Anthropic Pro/Max weekly usage % on macOS.

Alternatives in Development

Codenotch — A macOS app that pins usage limits from Claude Code, Cursor, Codex, and Antigravity to a screen edge 1.3k ★
Dario — A local OpenAI- and Anthropic-compatible proxy that brings your Claude Pro/Max subscription to Cursor, Cline 485 ★
Huashu Mac Use — 让任何 agent 操控 Mac 上没有 API 的原生 app，读后台、写不打扰、每步留取证 · Agent Skill for macOS computer use 228 ★

README

Claude Usage — macOS Menu Bar

A pair of [xbar](https://xbarapp.com) plugins that sit in your macOS menu bar:

claude-usage.5m.py — shows your real Anthropic Pro/Max weekly usage %, 5-hour session %, and a pace indicator (are you on track to stay under limits this week?). Pulls live data straight from the same endpoint that powers claude.ai/settings/usage. Also shows Codex, Kimi (Kimi Code CLI), Google Antigravity (agy CLI), and Grok (xAI Grok CLI) usage — weekly %, 5h session %, pace, and extra-usage balance — sourced locally from each CLI's own data (Codex rollout logs; Kimi's OAuth token calling the same api.kimi.com/coding/v1/usages endpoint its /usage command uses; Antigravity's JSON output calling agy --print /usage; Grok's local credits log at ~/.grok/logs/unified.jsonl). Features real brand Retina icons for each provider in the dropdown and authentic brand symbols in the menu bar.
mac-health.1m.py — system load, memory pressure, zombie-process watchdog, and cleanup suggestions for heavy or leaked processes.

![screenshot showing menu bar with weekly % and dropdown with pace details](docs/screenshot.png)

What you see

**Menu bar headline:** `✳ 62%·69 ⬡ 99%·209 🌙 71%·215 ✦ 52%·170 ✦3P 0%·0 𝕏 8%·8`

(xbar draws this as a Retina image with real brand icons; the line above is the text fallback, captured from a live `./claude-usage.5m.py` run.)

Hybrid Coloring Scheme:
- Weekly Usage % is rendered in each provider's authentic brand color (dark / light):
  - Claude: apricot (#FEB95F) / terracotta (#C4411E)
  - Codex: mint emerald (#34D399) / forest emerald (#058C5F)
  - Kimi: ice cyan (#7DD3FC) / deep sky (#0278BE)
  - Antigravity / Gemini: lavender lilac (#DCB9FF) / deep purple (#732DDC)
  - Grok: white (#FFFFFF) / charcoal (#191E28)
- Projected End-of-Week Pace % is rendered in health status colors (dark / light):
  - 🟢 Green (#4ADE80