akiiwa-games

Usage Float — Development skill for Claude Code

Development community

Borderless Windows HUD & CLI quota monitor for Claude Code, ChatGPT Codex, Grok, Google Antigravity (agy), Magpie & LiteLLM.

How to install Usage Float

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

What Usage Float does

Borderless Windows HUD & CLI quota monitor for Claude Code, ChatGPT Codex, Grok, Google Antigravity (agy), Magpie & LiteLLM. Tracks multi-account 5h/7d rate-limit windows, redeems Claude/Codex limit-reset credits, and doubles as an mpv live wallpaper.

Alternatives in Development

Claude Swap — Switch between multiple Claude Code accounts, with automatic rate-limit rotation, usage dashboard, and paralle 2k ★
Mem0 Chrome Extension — OpenMemory Chrome Extension: Long-term memory for ChatGPT, Claude, Perplexity, Grok etc 671 ★
Mcpx — MCPX 是运行在开发环境中的 MCP Runtime（网关） 370 ★

README

usage-float

A borderless Windows **AI subscription quota HUD**, **headless CLI rate-limit monitor**, and **auxiliary-screen dashboard** that tracks live 5-hour and 7-day usage windows across **Claude Code** (Claude Max / Pro), **OpenAI Codex CLI** / **ChatGPT Pro**, **Grok**, **Google Antigravity** (`agy` / Gemini CLI), **Magpie**, and **LiteLLM / OpenAI-compatible API proxies** — and switches to a folder-based **live wallpaper player** (`mpv` or embedded borderless web view) with a double-tap of `Ctrl`. No title bar and no taskbar entry.

Multi-Account Local Quota Discovery: Reads multiple local credentials (~/.claude, ~/.claude-2, ~/.claude-*, ~/.codex, ~/.codex-2, ~/.codex-*, ~/.grok, agy, Paseo provider directories, and remote Magpie /v1/magpie/quotas) directly on your machine without rotating OAuth tokens.
One-Click Rate-Limit Reset Redemption: Inspects and redeems Claude weekly rate-limit resets (cedar_ember), Claude 5-hour session wall resets (juniper_tide), and ChatGPT / Codex rate-limit reset credits (/backend-api/wham/rate-limit-reset-credits) directly from the HUD.
Headless CLI & JSON Cache for Agents: Run python usage_float.py once (or read ~/.usage-float/usage-cache.json) from scripts, routers, or coding agents to query remaining subscription percentages and reset timestamps programmatically.

AgentCompass integration

[AgentCompass](https://github.com/akiiwa-games/AgentCompass) uses Usage Float as its subscription quota collector and optional floating HUD. Usage Float also runs independently; AgentCompass adds task routing, quota scheduling, and a Windows management panel.