Claude's Keeper

A sleek, Claude-branded Windows 11 desktop application that monitors your Claude API usage in real-time. Keep track of your 5-hour and 7-day usage limits with smart notifications and a beautiful, minimal interface.

Features

• 🎯 Real-time Usage Monitoring - Track 5-hour and 7-day usage limits simultaneously
• 📊 Beautiful Dashboard - Anthropic-branded interface with dark mode support
• 🔔 Smart Notifications - Get alerted at 25%, 50%, 75%, and 90% usage thresholds
• 🎨 Minimized View - Ultra-compact display for taskbar monitoring
• ⚙️ Always On Top - Toggle to keep the window above other apps
• 🔒 Encrypted Session Storage - Your session cookie is encrypted at rest
• 🌙 Dark Mode - Easy on the eyes, day or night
• 🔄 Auto-refresh - Automatically updates every 5 minutes (configurable)
• 🖼️ System Tray - Quick access from the taskbar

Prerequisites

• Windows 11
• Internet connection
• An active Claude account (get one at claude.ai)

Installation

For Users (Recommended)

1. Download the latest release from Releases
2. Extract Claudes-Keeper-Portable-v1.1.zip to your desired location
3. Run RUN_Claude's Keeper.bat from the extracted folder
4. Click "🔓 Re-login" to authenticate with your Claude account
5. Grant access to your usage data

Note: No installation required - the portable app runs directly from the extracted folder. No admin rights needed.

For Developers

1. Clone the repository:

git clone https://github.com/FrameDeptCo/claudes-keeper.git
cd claudes-keeper

2. Install dependencies:

npm install

3. Start development (requires 3 terminals):

Terminal 1 - React Dev Server:

npm run react-start

Terminal 2 - TypeScript Watcher:

npx tsc --project tsconfig.electron.json --watch --outDir public

Terminal 3 - Electron App:

wait-on http://localhost:3000 && electron .

Or run all at once:

npm run dev

Building for Distribution

Create a portable Windows executable:

npm run build
npx electron-packager . "Claude's Keeper" --platform=win32 --arch=x64 --out=dist

Then create a portable zip:

Compress-Archive -Path 'dist/Claude''s Keeper-win32-x64' -DestinationPath 'Claudes-Keeper-Portable-v1.1.zip' -Force

Output will be Claudes-Keeper-Portable-v1.1.zip ready for distribution.

Project Structure

src/
  ├── App.tsx                 # Main application component
  ├── index.tsx              # React entry point
  ├── index.css              # Global styles with Anthropic design
  ├── global.d.ts            # TypeScript definitions for Electron IPC
  └── components/
      ├── Dashboard.tsx       # Usage dashboard display
      ├── SessionForm.tsx     # Session cookie input
      ├── Settings.tsx        # Settings/preferences panel
      ├── UsageDisplay.tsx    # Metrics display
      ├── MinimizedIcon.tsx   # Minimized tray view
      ├── SparkIcon.tsx       # Spark icon component
      └── MinimizedIcon.tsx   # Taskbar icon display

public/
  ├── main.ts                # Electron main process
  ├── main.js                # Compiled main process
  ├── preload.ts             # Secure IPC bridge
  ├── preload.js             # Compiled preload
  ├── index.html             # HTML template
  └── fonts/                 # Anthropic font files

fonts/
  └── Anthropic/             # Official Anthropic typography

svg/
  ├── claude-spark-clay.svg   # Brand spark icon
  ├── claude-icon-square.svg  # Square icon
  └── claude-icon-rounded.svg # Rounded icon

png/
  └── claude-icon-square.png  # PNG icon asset

How It Works

1. Login - Click "🔓 Re-login" in settings
2. Authenticate - Log into Claude.ai through the built-in browser window
3. Authorize - Grant Claude's Keeper access to your usage data
4. Monitor - View real-time usage with automatic refresh every 5 minutes
5. Notifications - Receive alerts at usage milestones (25%, 50%, 75%, 90%)

Security & Privacy

Session Management

• Your session cookie is encrypted at rest using your machine's identity
• Cookies are automatically cleared when you close the app
• Session validity is checked on startup and periodically validated
• No passwords are ever stored - only session cookies from legitimate Claude.ai authentication

Data Handling

• All requests use HTTPS only
• Your data is only sent to Anthropic's official APIs
• No telemetry or analytics tracking
• No third-party services access your information
• Everything is stored locally in encrypted electron-store

Recommended Security Practices

• Log out before sharing your computer with others
• Don't share your machine with untrusted users
• The portable .exe doesn't require admin rights - safer if unsure

Troubleshooting

"Session expired or invalid"

• Click "🔓 Re-login" in settings to authenticate again
• Make sure you're logged into Claude.ai in the browser window
• Your session may have expired - this is normal security behavior

Usage data won't load

• Check your internet connection
• Verify you have an active Claude subscription
• Try re-logging in

App won't start

• Make sure Windows 11 is up to date
• Try the portable .exe instead of the installer
• Download a fresh copy from Releases

Dark mode not saving

• The app will remember your preference next time you open it

Development

Stack

• Frontend: React 18 + TypeScript + Tailwind CSS
• Desktop: Electron 41
• Build: electron-packager for Windows distribution
• Storage: electron-store with machine-specific encryption
• Security: Electron context isolation + encrypted session storage
• Typography: Anthropic Mono & Serif (official brand fonts)

Contributing

Found a bug or have a feature request? Feel free to open an issue!

License

MIT