{"id":38611089,"url":"https://github.com/dmelo/claude-code-stats","last_synced_at":"2026-02-21T16:35:47.300Z","repository":{"id":332946284,"uuid":"1135658938","full_name":"dmelo/claude-code-stats","owner":"dmelo","description":null,"archived":false,"fork":false,"pushed_at":"2026-02-14T01:28:38.000Z","size":104,"stargazers_count":7,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-02-14T08:49:32.120Z","etag":null,"topics":["claude","claude-ai","claude-code","macos","usage-data"],"latest_commit_sha":null,"homepage":"","language":"Swift","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/dmelo.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-01-16T12:10:09.000Z","updated_at":"2026-02-14T01:28:21.000Z","dependencies_parsed_at":"2026-01-21T13:02:06.723Z","dependency_job_id":null,"html_url":"https://github.com/dmelo/claude-code-stats","commit_stats":null,"previous_names":["dmelo/claude-code-stats"],"tags_count":21,"template":false,"template_full_name":null,"purl":"pkg:github/dmelo/claude-code-stats","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dmelo%2Fclaude-code-stats","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dmelo%2Fclaude-code-stats/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dmelo%2Fclaude-code-stats/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dmelo%2Fclaude-code-stats/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dmelo","download_url":"https://codeload.github.com/dmelo/claude-code-stats/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dmelo%2Fclaude-code-stats/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29686796,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-21T15:51:39.154Z","status":"ssl_error","status_checked_at":"2026-02-21T15:49:03.425Z","response_time":107,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["claude","claude-ai","claude-code","macos","usage-data"],"created_at":"2026-01-17T08:44:29.510Z","updated_at":"2026-02-21T16:35:47.285Z","avatar_url":"https://github.com/dmelo.png","language":"Swift","readme":"# Claude Code Stats\n\nA native macOS menu bar app that displays your Claude Code usage limits in real-time.\n\n![Claude Code Stats Screenshot](screenshot.png)\n\n## Features\n\n- **Real-time usage data** - Shows your actual usage from Anthropic's servers\n- **Current Session** - 5-hour rolling window usage with reset countdown\n- **Weekly Limits** - All models combined usage with reset time\n- **Sonnet Only** - Separate tracking for Sonnet model usage\n- **Auto-refresh** - Updates every 5 minutes automatically\n- **Claude service status** - Live status from [status.claude.com](https://status.claude.com) shown in the footer (Operational, Degraded, Outage, Critical)\n- **Version update detection** - Checks for new Claude Code releases hourly via GitHub; shows a red dot badge on the menu bar icon and a banner when an update is available, with a link to the changelog\n- **Native macOS app** - Built with SwiftUI, lightweight and fast\n- **Dark theme** - Matches macOS menu bar aesthetic\n\n## Requirements\n\n- macOS 14.0 (Sonoma) or later\n- Active Claude Pro/Max subscription\n- Claude Code installed and logged in\n\n## Installation\n\n### Option 1: Homebrew (Recommended)\n\n```bash\nbrew tap dmelo/tap\nbrew install --cask claude-code-stats\n```\n\n### Option 2: Download Release\n\nDownload the latest `.app` from the [Releases](https://github.com/dmelo/claude-code-stats/releases) page and drag it to your Applications folder.\n\n### Option 3: Build from Source\n\n1. Clone the repository:\n   ```bash\n   git clone https://github.com/dmelo/claude-code-stats.git\n   cd claude-code-stats\n   ```\n\n2. Open in Xcode:\n   ```bash\n   open ClaudeCodeStats/ClaudeCodeStats.xcodeproj\n   ```\n\n3. Build and run (⌘R)\n\n## Setup\n\n1. Launch the app - a chart icon will appear in your menu bar\n2. Click the icon, then click **⚙️** (settings) or **\"Configure Session\"**\n3. Get your session cookie from claude.ai:\n   - Open https://claude.ai in your browser\n   - Open Developer Tools (`Cmd + Option + I`)\n   - Go to **Application** → **Cookies** → **https://claude.ai**\n   - Find `sessionKey` and copy its value\n4. Paste the value in the app and click **Save**\n\n## Usage\n\nClick the menu bar icon to see your current usage:\n\n| Metric | Description |\n|--------|-------------|\n| **Current Session** | Usage in the current 5-hour window |\n| **Weekly Limit** | Combined usage across all models (resets weekly) |\n| **Sonnet Only** | Sonnet-specific usage tracking |\n\nThe progress bars change color based on usage:\n- 🟢 Green: 0-50%\n- 🟡 Yellow: 50-75%\n- 🔴 Red: 75-100%\n\n## Start at Login\n\nTo launch automatically when you log in:\n\n1. Open **System Settings** → **General** → **Login Items**\n2. Click **+** and add ClaudeCodeStats\n\n## Session Cookie Expiration\n\nThe claude.ai session cookie expires periodically. When you see an \"unauthorized\" error:\n\n1. Click the ⚙️ icon\n2. Get a fresh `sessionKey` from claude.ai (see Setup step 3)\n3. Paste and save\n\n## Building\n\n```bash\ncd ClaudeCodeStats\nxcodebuild -project ClaudeCodeStats.xcodeproj -scheme ClaudeCodeStats -configuration Release build\n```\n\nThe built app will be in `~/Library/Developer/Xcode/DerivedData/ClaudeCodeStats-*/Build/Products/Release/`\n\n## Project Structure\n\n```\nClaudeCodeStats/\n├── ClaudeCodeStats.xcodeproj\n└── ClaudeCodeStats/\n    ├── ClaudeCodeStatsApp.swift    # App entry point\n    ├── ContentView.swift            # Main popover view\n    ├── Services/\n    │   ├── WebSessionService.swift  # Claude.ai API client\n    │   ├── StatusService.swift      # Claude service health status\n    │   └── VersionService.swift     # Claude Code version update checker\n    └── Views/\n        ├── UsageCardView.swift      # Usage card component\n        ├── ProgressBarView.swift    # Progress bar component\n        └── SettingsView.swift       # Settings screen\n```\n\n## Privacy\n\n- Your session cookie is stored locally in UserDefaults\n- The app communicates with claude.ai to fetch your usage data, status.claude.com for service health, and the GitHub API for version checks\n- No data is sent to any third parties\n\n## License\n\nMIT License - see [LICENSE](LICENSE) for details\n\n## Acknowledgments\n\n- Built for use with [Claude Code](https://docs.anthropic.com/en/docs/claude-code) by Anthropic\n- Inspired by the Warp terminal menu bar design\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdmelo%2Fclaude-code-stats","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdmelo%2Fclaude-code-stats","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdmelo%2Fclaude-code-stats/lists"}