Skip to content

README.md

Latest commit

 

History

History
54 lines (36 loc) · 1.67 KB

README.md

File metadata and controls

54 lines (36 loc) · 1.67 KB

ClaudeBar

Note: This project is heavily inspired by and a spiritual successor to steipete/CodexBar.

ClaudeBar Icon

A minimal macOS menu bar application to monitor your Claude Code token usage and session limits.

ClaudeBar Screenshot

Features

  • 🧠 Real-time Usage Tracking: Reads directly from your local Claude Code logs.
  • ⚡️ Session Limits (5h): Visual progress bar for the rolling 5-hour window.
  • 📅 Daily Limits (24h): Track your total daily consumption.
  • 🕵️ Privacy Focused: Runs locally, no external API calls (except checking your git email for the UI).
  • 🎨 Native Design: Built with SwiftUI, fits perfectly in the macOS menu bar.

Installation

  1. Download the latest release (or build from source).
  2. Move ClaudeBar.app to your Applications folder.
  3. Open it. You'll see a small Claude icon in your menu bar.

Building from Source

# Compile the Swift code
swiftc -parse-as-library ClaudeBar/ClaudeBar.swift -o ClaudeBarApp

# Create App Bundle Structure
mkdir -p ClaudeBar.app/Contents/MacOS ClaudeBar.app/Contents/Resources
mv ClaudeBarApp ClaudeBar.app/Contents/MacOS/

# Add Info.plist (Required for Menu Bar App)
# (See source for Info.plist content)

# Codesign (Ad-hoc)
codesign -s - --deep --force ClaudeBar.app

Requirements

  • macOS 13.0 or later
  • Claude Code CLI installed and initialized (~/.claude directory must exist).

License

MIT