Installation Instructions

For End Users

Option 1: Download Installer (Recommended)

Download Claude-Usage-Widget-Setup.exe from releases
Run the installer
Launch from Start Menu
Login when prompted

Option 2: Build from Source

# Install Node.js from https://nodejs.org (if not already installed)

# Clone or download this project
cd claude-usage-widget

# Install dependencies
npm install

# Run the widget
npm start

# Or build installer
npm run build:win

First Time Setup

Launch the widget - A frameless window appears
Click "Login to Claude" - Browser window opens
Login to Claude.ai - Use your normal credentials
Widget activates - Usage data appears automatically
Minimize to tray - Click the minus icon

System Requirements

OS: Windows 10 or later (64-bit)
RAM: 200 MB
Disk: 100 MB
Internet: Required for Claude.ai API

What Gets Installed

Executable: %LOCALAPPDATA%\Programs\claude-usage-widget\
Settings: %APPDATA%\claude-usage-widget\ (encrypted)
Start Menu shortcut
Desktop shortcut (optional)

Uninstallation

Windows:

Settings → Apps → Claude Usage Widget → Uninstall
Or run Uninstall Claude Usage Widget.exe from install directory

Manual cleanup:

%APPDATA%\claude-usage-widget\
%LOCALAPPDATA%\Programs\claude-usage-widget\

Troubleshooting Install Issues

"Windows protected your PC"

Click "More info"
Click "Run anyway"
This is normal for unsigned apps

Installer won't run

Ensure you have admin rights
Disable antivirus temporarily
Download again (file may be corrupted)

Can't find after install

Check Start Menu → All Apps
Search for "Claude Usage Widget"
Check Desktop for shortcut

Security Notes

✅ Your data stays local - credentials stored encrypted on your machine ✅ Open source - code is available for review ✅ No telemetry - no usage data sent anywhere ✅ Direct API - only communicates with claude.ai

For development setup, see QUICKSTART.md For full documentation, see README.md

2.1 KiB Raw Blame History