WAT321 - Willy's AI Tools

Does manually refreshing AI usage limits give you anxiety?

Now you can live in fear in real-time!

Real-time AI usage widgets for your VS Code status bar.

WAT321 ships with six status bar widgets for Claude and Codex. Claude tools are enabled by default. Codex tools are included but disabled - enable them in Settings.

What's Included

Claude Usage

Live progress bars showing your 5-hour session utilization and weekly limits. Simple hover for information breakdown.

Claude Session Tokens

Tracks your active Claude Code session's context window usage against the auto-compact ceiling. See how much room you have before compaction kicks in.

Codex Usage

Same concept, green bars for Codex. Shows remaining capacity - the bars deplete as you use more.

Codex Session Tokens

Monitors your Codex session's context window fill level. Same layout as Claude session tokens.

Display Modes

WAT321 supports three display densities. Search "wat321" in Settings to change.

• Full - 10-block progress bars with all details (default)
• Compact - 5-block progress bars, session tokens show text only
• Minimal - text-only, usage bars move to tooltips on hover

Installation

From the Marketplace

1. Open VS Code
2. Go to Extensions (Ctrl+Shift+X / Cmd+Shift+X)
3. Search "WAT321"
4. Click Install

From a .vsix file

1. Ctrl+Shift+P / Cmd+Shift+P then Extensions: Install from VSIX
2. Select the .vsix file
3. Reload window

Enabling Codex Widgets

All six tools install together, but Codex is disabled by default. To enable:

1. File > Preferences > Settings (Ctrl+, / Cmd+,) and search for "wat321"
2. Check Enable Codex - widgets appear immediately, no reload needed

Customize Visible Widgets

You can show or hide individual widgets by right-clicking the status bar or using the overflow menu (>>):

How It Works

• Claude Usage and Codex Usage poll their respective APIs on a safe interval (~2 minutes) with built-in rate-limit protection
• Session Tokens (both providers) read local transcript files - no API calls, no network access
• All data sources are read-only - WAT321 never modifies Claude, Codex, or user config files. The only files written are internal timestamps under ~/.wat321/
• One shared API polling path per provider prevents duplicate calls even with multiple widgets active
• Settings changes (enable/disable, display mode) take effect immediately - no window reload needed
• If Claude or Codex CLI hasn't been used yet, widgets show "Not Connected" and activate automatically when you start using the CLI

What It Doesn't Do

• Will not affect your usage limits. Usage widgets poll a read-only stats endpoint on a safe interval. Session token widgets only read local files - no API calls, no network access. Nothing WAT321 does counts toward your Claude or Codex usage.
• WAT321 does not store, transmit, or modify your credentials. It only writes cooldown timestamps to ~/.wat321/
• WAT321 does not interfere with Claude Code, Codex CLI, or any other extension

Requirements

• VS Code 1.85.0 or later
• Claude widgets need an active Claude account with CLI credentials (~/.claude/.credentials.json)
• Codex widgets need Codex CLI credentials (~/.codex/auth.json)
• Session token widgets need an active session in the respective CLI tool

Supported Plans

API-only Anthropic accounts without CLI OAuth credentials will see Claude widgets showing "Not Connected", which is expected. They will activate automatically if CLI credentials are set up later.

Rate Limits

Both Claude and Codex usage APIs have rate limits. WAT321 polls conservatively to stay well within safe thresholds. However, repeatedly reinstalling or reloading the extension in quick succession can trigger a temporary rate-limit lockout.

If a lockout occurs, the status bar will show "Offline" and the tooltip will display a countdown timer. The extension will automatically reconnect when the lockout expires - no action needed.

Additional Settings

• Auto-Compact Threshold - Override the percentage ceiling shown in the Claude session token widget. Set to 0 (default) to use Claude's own setting, or enter a value like 85 for 85%.
• Status Bar Priority - Adjust widget ordering if they overlap with other extensions.

Reset WAT321

To start fresh, open the command palette (Ctrl+Shift+P / Cmd+Shift+P) and run WAT321: Clear All Settings, or check the Reset WAT321 checkbox at the bottom of the WAT321 settings page. This resets all settings to defaults and removes stored data.

Issues & Feedback

Found a bug or have a feature request? Open an issue on GitHub.

License

MIT