kaji
Health Warn
- License — License: MIT
- Description — Repository has a description
- Active repo — Last push 0 days ago
- Low visibility — Only 5 GitHub stars
Code Fail
- network request — Outbound network request in Resources/quota.py
- rm -rf — Recursive force deletion command in install.sh
- rm -rf — Recursive force deletion command in scripts/build-app.sh
- rm -rf — Recursive force deletion command in scripts/build-local.sh
- rm -rf — Recursive force deletion command in scripts/make-icon.sh
Permissions Pass
- Permissions — No dangerous permissions requested
No AI report is available for this listing yet.
A beautiful macOS menu bar for AI usage.
Kaji
A beautiful macOS menu bar for AI usage.
Local-first quota rings for Claude, Codex, MiniMax, and Ark Agent.
Install
curl -fsSL https://raw.githubusercontent.com/interesting-vibe-coding/kaji/main/install.sh | bash
Requires macOS 13+ on Apple Silicon. The installer downloads the latest release,
moves Kaji into /Applications, and launches the menu bar app.
Kaji is currently unsigned. The installer clears the Gatekeeper quarantine flag
transparently; this goes away after signing and notarization.
What It Shows
- Menu bar rings - compact dual-ring status for the providers you choose to show.
- Quota popover - 5h usage, 7d usage, local reset time, provider toggles, S/M/L size, used/remaining mode, and EN/CN language.
- Provider coverage - Claude, Codex, MiniMax, and Ark Agent.
- Quiet styling - native menu bar behavior, light/dark themes, mono or color mode.
- Update hint - a small dot appears when a newer GitHub Release is available.
How It Works
local CLI/account data -> bundled quota.py reader -> SwiftUI menu bar + popover
Kaji reads local quota/account windows through a bundled Python reader, then
renders the result in a native SwiftUI menu bar surface. Nothing is uploaded.
Network use is intentionally narrow:
- GitHub Releases for update checks.
- Volcengine/Ark endpoints only when Ark Agent credentials are configured.
Build from Source
swift run # development menu bar app
./scripts/build-app.sh # release bundle -> dist/KajiGauge.app
On CLT-only machines where SwiftPM linking fails, use:
./scripts/build-local.sh # raw swiftc build, installs to /Applications
Limitations
Kaji is a local status app, not a billing source of truth. Provider APIs and
local file formats can change; unavailable windows render as empty or unknown
until the reader can see usable data again.
License
MIT - see LICENSE.
Reviews (0)
Sign in to leave a review.
Leave a reviewNo results found