Real-Time Desktop Overlay for Monitoring Claude Code Usage Limits
A new open-source tool allows developers to monitor Claude Code usage limits with a real-time desktop overlay. This widget, built to stay always-on-top, provides immediate visibility into your session and weekly usage without having to run the /usage command manually.
Key Details
- Session and Weekly Tracking: Displays current session usage within a 5-hour window, including reset times, and tracks weekly usage for all models as well as Sonnet-only usage.
- Alerts: The usage bars turn red and pulse when approaching limits, providing a clear visual alert to avoid hitting these limits during use.
- Customization: The widget is draggable, can be placed anywhere on the screen, and supports a cyberpunk light/dark mode toggle. It also features opacity controls via the system tray.
- Persistence and Refresh: Remembers its position between sessions and auto-refreshes every 5 minutes to provide up-to-date information.
- Technical Implementation: Utilizes Electron and node-pty to run the Claude Code’s /usage command within a pseudo-terminal, leveraging your existing authentication without needing an API key.
- Platform Support: Currently available for Windows 11, with opportunities for macOS and Linux contributions from the community.
Setup
Installation is straightforward: clone the repository, run npm install, and then npm start. Alternatively, Windows users can double-click the start.bat file. The tool is MIT licensed, ensuring it's free to use indefinitely.
📖 Read the full source: r/ClaudeAI
👀 See Also
HuggingFace Agent Skills: Standardized AI Task Definitions for Coding Agents
HuggingFace Skills are self-contained folders with YAML frontmatter and guidance for AI agents to perform specific ML tasks like dataset creation, model training, and evaluation. They're interoperable with OpenAI Codex, Anthropic's Claude Code, Google Gemini CLI, and Cursor.
agent-recall: Local SQLite MCP for Persistent Claude Code Memory
agent-recall is an MCP server that gives Claude Code persistent memory across sessions using a local SQLite file. It provides 9 MCP tools for saving entities, relationships, and observations, with LLM-summarized briefings at session start instead of raw data dumps.
Loom: A Local Execution Harness for Complex AI Tasks
Loom is an open-source local execution harness designed to manage complex tasks by providing a structured process with around 50 tools, a custom package plugin system for repeatable workflows, and both CLI and MCP server interfaces.
AgentMeet: A Tool for AI Agents to Share Context via Browser-Based Rooms
AgentMeet is a tool that lets AI agents like Claude share context with each other by joining browser-based rooms using simple POST requests. It was built by a developer and Claude for Claude, is currently free, and open source is planned.