[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-75774":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":10,"language":11,"languages":9,"totalLinesOfCode":9,"stars":12,"forks":13,"watchers":14,"openIssues":15,"contributorsCount":9,"subscribersCount":16,"size":16,"stars1d":17,"stars7d":18,"stars30d":19,"stars90d":16,"forks30d":16,"starsTrendScore":20,"compositeScore":21,"rankGlobal":9,"rankLanguage":9,"license":9,"archived":22,"fork":22,"defaultBranch":23,"hasWiki":22,"hasPages":22,"topics":24,"createdAt":9,"pushedAt":9,"updatedAt":33,"readmeContent":34,"aiSummary":35,"trendingCount":16,"starSnapshotCount":16,"syncStatus":36,"lastSyncTime":37,"discoverSource":38},75774,"ClaudeBar","tddworks\u002FClaudeBar","tddworks","A macOS menu bar application that monitors AI coding assistant usage quotas. Keep track of your Claude, Codex, Antigravity ,and Gemini usage at a glance.",null,"https:\u002F\u002Fgithub.com\u002Ftddworks\u002FClaudeBar","Swift",1220,102,7,50,0,6,27,92,18,19.04,false,"main",[25,26,27,28,29,30,31,32],"claude","claude-code","codex","gemini","githubcopilot","antigravity","kimi","glm5","2026-06-12 02:03:36","# ClaudeBar\n\n[![Build](https:\u002F\u002Fgithub.com\u002Ftddworks\u002FClaudeBar\u002Factions\u002Fworkflows\u002Fbuild.yml\u002Fbadge.svg)](https:\u002F\u002Fgithub.com\u002Ftddworks\u002FClaudeBar\u002Factions\u002Fworkflows\u002Fbuild.yml)\n[![Tests](https:\u002F\u002Fgithub.com\u002Ftddworks\u002FClaudeBar\u002Factions\u002Fworkflows\u002Ftests.yml\u002Fbadge.svg)](https:\u002F\u002Fgithub.com\u002Ftddworks\u002FClaudeBar\u002Factions\u002Fworkflows\u002Ftests.yml)\n[![codecov](https:\u002F\u002Fcodecov.io\u002Fgh\u002Ftddworks\u002FClaudeBar\u002Fgraph\u002Fbadge.svg)](https:\u002F\u002Fcodecov.io\u002Fgh\u002Ftddworks\u002FClaudeBar)\n[![Latest Release](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fv\u002Frelease\u002Ftddworks\u002FClaudeBar)](https:\u002F\u002Fgithub.com\u002Ftddworks\u002FClaudeBar\u002Freleases\u002Flatest)\n[![Swift 6.2](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FSwift-6.2-orange.svg)](https:\u002F\u002Fswift.org)\n[![Platform](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FPlatform-macOS%2015-blue.svg)](https:\u002F\u002Fdeveloper.apple.com)\n[![Homebrew](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FHomebrew-Install-brightgreen.svg)](https:\u002F\u002Fformulae.brew.sh\u002Fcask\u002Fclaudebar)\n\nA macOS menu bar application that monitors AI coding assistant usage quotas. Keep track of your Claude, Codex, Gemini, GitHub Copilot, Antigravity, Z.ai, Kimi, Kiro, Amp, OpenCode Go, and more at a glance.\n\n\u003Ctable align=\"center\">\n  \u003Ctr>\n    \u003Ctd align=\"center\">\u003Cimg src=\"docs\u002Fscreenshots\u002FScreenshot-dark.png\" alt=\"Dark Mode\" width=\"360\"\u002F>\u003Cbr\u002F>\u003Cem>Dark Mode\u003C\u002Fem>\u003C\u002Ftd>\n    \u003Ctd align=\"center\">\u003Cimg src=\"docs\u002Fscreenshots\u002FScreenshot-light.png\" alt=\"Light Mode\" width=\"360\"\u002F>\u003Cbr\u002F>\u003Cem>Light Mode\u003C\u002Fem>\u003C\u002Ftd>\n  \u003C\u002Ftr>\n  \u003Ctr>\n    \u003Ctd align=\"center\">\u003Cimg src=\"docs\u002Fscreenshots\u002FScreenshot-cli-dark.png\" alt=\"CLI Theme\" width=\"360\"\u002F>\u003Cbr\u002F>\u003Cem>CLI Theme\u003C\u002Fem>\u003C\u002Ftd>\n    \u003Ctd align=\"center\">\u003Cimg src=\"docs\u002Fscreenshots\u002FChristmas-theme.png\" alt=\"Christmas Theme\" width=\"360\"\u002F>\u003Cbr\u002F>\u003Cem>Christmas Theme\u003C\u002Fem>\u003C\u002Ftd>\n  \u003C\u002Ftr>\n\u003C\u002Ftable>\n\n## Features\n\n- **Multi-Provider Support** - Monitor Claude, Codex, Gemini, GitHub Copilot, Antigravity, Z.ai, Kimi, Kiro, Amp, and OpenCode Go quotas in one place\n- **Provider Enable\u002FDisable** - Toggle individual providers on\u002Foff from Settings to customize your monitoring\n- **Real-Time Quota Tracking** - View Session, Weekly, and Model-specific usage percentages\n- **Multiple Themes** - Light, Dark, CLI, Christmas, and [imported terminal themes](#import-terminal-theme) (.itermcolors)\n- **Automatic Adaptation** - System theme follows your macOS appearance; Christmas auto-enables during the holiday season\n- **Visual Status Indicators** - Color-coded progress bars (green\u002Fyellow\u002Fred) show quota health\n- **System Notifications** - Get alerted when quota status changes to warning or critical\n- **Auto-Refresh** - Automatically updates quotas at configurable intervals\n- **Keyboard Shortcuts** - Quick access with `⌘D` (Dashboard) and `⌘R` (Refresh)\n\n## Quota Status Thresholds\n\n| Remaining | Status | Color |\n|-----------|--------|-------|\n| > 50% | Healthy | Green |\n| 20-50% | Warning | Yellow |\n| \u003C 20% | Critical | Red |\n| 0% | Depleted | Gray |\n\n## Requirements\n\n- macOS 15+\n- Swift 6.2+\n- CLI tools installed for providers you want to monitor:\n  - [Claude CLI](https:\u002F\u002Fclaude.ai\u002Fcode) (`claude`)\n  - [Codex CLI](https:\u002F\u002Fgithub.com\u002Fopenai\u002Fcodex) (`codex`)\n  - [Gemini CLI](https:\u002F\u002Fgithub.com\u002Fgoogle-gemini\u002Fgemini-cli) (`gemini`)\n  - [GitHub Copilot](https:\u002F\u002Fgithub.com\u002Ffeatures\u002Fcopilot) - Configure credentials in Settings\n  - [Antigravity](https:\u002F\u002Fantigravity.google) - Auto-detected when running locally\n  - [Z.ai](https:\u002F\u002Fz.ai\u002Fsubscribe) - Configure Claude Code with GLM Coding Plan endpoint\n  - [Kimi](https:\u002F\u002Fwww.kimi.com\u002Fcode\u002Fconsole) (`kimi`) - CLI mode (recommended) or API mode (see below)\n  - [Kiro](https:\u002F\u002Fkiro.dev) (`kiro-cli`) - Requires kiro-cli installation (see below)\n  - [Amp](https:\u002F\u002Fampcode.com) (`amp`) - Auto-detected when CLI is installed\n  - [OpenCode Go](https:\u002F\u002Fopencode.ai\u002Fgo) (`opencode`) - Tracks OpenCode Go usage windows (5hr\u002F$12, weekly\u002F$30, monthly\u002F$60) via local SQLite DB\n\n### Kimi Setup\n\nKimi supports two probe modes, configurable in **Settings > Kimi Configuration**:\n\n**CLI Mode (Recommended)** - Launches the interactive `kimi` CLI and sends `\u002Fusage` to fetch quota data. Requires `kimi` CLI installed (`uv tool install kimi-cli`). No Full Disk Access needed.\n\n**API Mode** - Calls the Kimi API directly using browser cookie authentication. Requires **Full Disk Access** for ClaudeBar to read the `kimi-auth` browser cookie:\n1. Open **System Settings** > **Privacy & Security** > **Full Disk Access**\n2. Toggle **ClaudeBar** on (or click `+` and add it)\n3. Restart ClaudeBar\n\nYou can also set the `KIMI_AUTH_TOKEN` environment variable to bypass cookie reading in API mode.\n\n### Kiro Setup\n\nKiro monitors AWS Kiro (formerly CodeWhisperer) usage through the `kiro-cli` command-line tool.\n\n**Installation**: `uv tool install kiro-cli` or `pip install kiro-cli`\n\n**Authentication**: Run `kiro-cli` and follow the login prompts.\n\n**Kiro IDE Users**: If you use Kiro IDE, simply install kiro-cli. Both share the same authentication, so no additional login is required.\n\n## Installation\n\n### Homebrew\n\nInstall via [Homebrew](https:\u002F\u002Fbrew.sh).\n\n```bash\nbrew install --cask claudebar\n```\n\n### Download (Recommended)\n\nDownload the latest release from [GitHub Releases](https:\u002F\u002Fgithub.com\u002Ftddworks\u002FClaudeBar\u002Freleases\u002Flatest):\n\n- **DMG**: Open and drag ClaudeBar.app to Applications\n- **ZIP**: Unzip and move ClaudeBar.app to Applications\n\nBoth are code-signed and notarized for Gatekeeper.\n\n### Build from Source\n\n```bash\ngit clone https:\u002F\u002Fgithub.com\u002Ftddworks\u002FClaudeBar.git\ncd ClaudeBar\n\n# Install Tuist (if not installed)\nbrew install tuist\n\n# Install dependencies and build\ntuist install\ntuist build ClaudeBar -C Release\n```\n\n## Usage\n\nAfter building, open the generated Xcode workspace and run the app:\n\n```bash\ntuist generate\nopen ClaudeBar.xcworkspace\n```\n\nThen press `Cmd+R` in Xcode to run. The app will appear in your menu bar. Click to view quota details for each provider.\n\n## Development\n\nThe project uses [Tuist](https:\u002F\u002Ftuist.io) for dependency management and Xcode project generation.\n\n### Quick Start\n\n```bash\n# Install Tuist (if not installed)\nbrew install tuist\n\n# Install dependencies\ntuist install\n\n# Generate Xcode project and open\ntuist generate\nopen ClaudeBar.xcworkspace\n```\n\n### Build & Test\n\n```bash\n# Build the project\ntuist build\n\n# Run all tests\ntuist test\n\n# Run tests with coverage\ntuist test --result-bundle-path TestResults.xcresult -- -enableCodeCoverage YES\n\n# Build release configuration\ntuist build ClaudeBar -C Release\n```\n\n### SwiftUI Previews\n\nAfter opening in Xcode, SwiftUI previews will work with `Cmd+Option+Return`. The project is configured with `ENABLE_DEBUG_DYLIB` for preview support.\n\n## Architecture\n\n> **Full documentation:** [docs\u002FARCHITECTURE.md](docs\u002FARCHITECTURE.md)\n\nClaudeBar uses a **layered architecture** with `QuotaMonitor` as the single source of truth:\n\n| Layer | Purpose |\n|-------|---------|\n| **App** | SwiftUI views consuming domain directly (no ViewModel) |\n| **Domain** | Rich models, `QuotaMonitor`, repository protocols |\n| **Infrastructure** | Probes, storage implementations, adapters |\n\n### Key Design Decisions\n\n- **Single Source of Truth** - `QuotaMonitor` owns all provider state\n- **Repository Pattern** - Settings and credentials abstracted behind injectable protocols\n- **Protocol-Based DI** - `@Mockable` protocols enable testability\n- **Chicago School TDD** - Tests verify state changes, not method calls\n- **No ViewModel\u002FAppState** - Views consume domain directly\n\n## Import Terminal Theme\n\nMatch ClaudeBar's appearance to your terminal. Import any `.itermcolors` file:\n\n1. Open **Settings** (gear icon)\n2. Click **Import .itermcolors**\n3. Select your file (export from iTerm2: Preferences > Profiles > Colors > Color Presets > Export)\n\n450+ pre-made schemes available at [iTerm2-Color-Schemes](https:\u002F\u002Fgithub.com\u002Fmbadolato\u002FiTerm2-Color-Schemes\u002Ftree\u002Fmaster\u002Fschemes).\n\nImported themes are saved in `~\u002F.claudebar\u002Fthemes\u002F` and persist across restarts.\n\n## Contributing\n\n### Adding a New AI Provider\n\nUse the **add-provider** skill to guide you through adding new providers with TDD:\n\n```\nTell Claude Code: \"I want to add a new provider for [ProviderName]\"\n```\n\nThe skill guides you through: Parsing Tests → Probe Tests → Implementation → Registration.\n\nSee `.claude\u002Fskills\u002Fadd-provider\u002FSKILL.md` for details and `AntigravityUsageProbe` as a reference implementation.\n\n## Dependencies\n\n- [Sparkle](https:\u002F\u002Fsparkle-project.org\u002F) - Auto-update framework\n- [Mockable](https:\u002F\u002Fgithub.com\u002FKolos65\u002FMockable) - Protocol mocking for tests\n- [Tuist](https:\u002F\u002Ftuist.io) - Xcode project generation (for SwiftUI previews)\n\n## Releasing\n\nReleases are automated via GitHub Actions. Push a version tag to create a new release.\n\n**For detailed setup instructions, see [docs\u002Frelease\u002FRELEASE_SETUP.md](docs\u002Frelease\u002FRELEASE_SETUP.md).**\n\n### Release Workflow\n\nThe workflow uses Tuist to generate the Xcode project:\n\n```\nTag v1.0.0 → Update Info.plist → tuist generate → xcodebuild → Sign & Notarize → GitHub Release\n```\n\nVersion is set in `Sources\u002FApp\u002FInfo.plist` and flows through to Sparkle auto-updates.\n\n### Quick Start\n\n1. **Configure GitHub Secrets** (see [full guide](docs\u002Frelease\u002FRELEASE_SETUP.md)):\n\n   | Secret | Description |\n   |--------|-------------|\n   | `APPLE_CERTIFICATE_P12` | Developer ID certificate (base64) |\n   | `APPLE_CERTIFICATE_PASSWORD` | Password for .p12 |\n   | `APP_STORE_CONNECT_API_KEY_P8` | API key (base64) |\n   | `APP_STORE_CONNECT_KEY_ID` | Key ID |\n   | `APP_STORE_CONNECT_ISSUER_ID` | Issuer ID |\n\n2. **Verify your certificate**:\n   ```bash\n   .\u002Fscripts\u002Fverify-p12.sh \u002Fpath\u002Fto\u002Fcertificate.p12\n   ```\n\n3. **Create a release**:\n   ```bash\n   git tag v1.0.0\n   git push origin v1.0.0\n   ```\n\nThe workflow will automatically build, sign, notarize, and publish to GitHub Releases.\n\n## Contributors\n\nThanks to everyone who has contributed to ClaudeBar!\n\n\u003Ctable>\n  \u003Ctr>\n    \u003Ctd align=\"center\">\u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fhanrw\">\u003Cimg src=\"https:\u002F\u002Fgithub.com\u002Fhanrw.png?size=80\" width=\"80\" alt=\"hanrw\"\u002F>\u003Cbr\u002F>\u003Csub>\u003Cb>hanrw\u003C\u002Fb>\u003C\u002Fsub>\u003C\u002Fa>\u003C\u002Ftd>\n    \u003Ctd align=\"center\">\u003Ca href=\"https:\u002F\u002Fgithub.com\u002Framarivera\">\u003Cimg src=\"https:\u002F\u002Fgithub.com\u002Framarivera.png?size=80\" width=\"80\" alt=\"ramarivera\"\u002F>\u003Cbr\u002F>\u003Csub>\u003Cb>ramarivera\u003C\u002Fb>\u003C\u002Fsub>\u003C\u002Fa>\u003C\u002Ftd>\n    \u003Ctd align=\"center\">\u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fzenibako\">\u003Cimg src=\"https:\u002F\u002Fgithub.com\u002Fzenibako.png?size=80\" width=\"80\" alt=\"zenibako\"\u002F>\u003Cbr\u002F>\u003Csub>\u003Cb>zenibako\u003C\u002Fb>\u003C\u002Fsub>\u003C\u002Fa>\u003C\u002Ftd>\n    \u003Ctd align=\"center\">\u003Ca href=\"https:\u002F\u002Fgithub.com\u002FAlexanderWillner\">\u003Cimg src=\"https:\u002F\u002Fgithub.com\u002FAlexanderWillner.png?size=80\" width=\"80\" alt=\"AlexanderWillner\"\u002F>\u003Cbr\u002F>\u003Csub>\u003Cb>AlexanderWillner\u003C\u002Fb>\u003C\u002Fsub>\u003C\u002Fa>\u003C\u002Ftd>\n    \u003Ctd align=\"center\">\u003Ca href=\"https:\u002F\u002Fgithub.com\u002Favishj\">\u003Cimg src=\"https:\u002F\u002Fgithub.com\u002Favishj.png?size=80\" width=\"80\" alt=\"avishj\"\u002F>\u003Cbr\u002F>\u003Csub>\u003Cb>avishj\u003C\u002Fb>\u003C\u002Fsub>\u003C\u002Fa>\u003C\u002Ftd>\n    \u003Ctd align=\"center\">\u003Ca href=\"https:\u002F\u002Fgithub.com\u002FBryanQQYue\">\u003Cimg src=\"https:\u002F\u002Fgithub.com\u002FBryanQQYue.png?size=80\" width=\"80\" alt=\"BryanQQYue\"\u002F>\u003Cbr\u002F>\u003Csub>\u003Cb>BryanQQYue\u003C\u002Fb>\u003C\u002Fsub>\u003C\u002Fa>\u003C\u002Ftd>\n  \u003C\u002Ftr>\n  \u003Ctr>\n    \u003Ctd align=\"center\">\u003Ca href=\"https:\u002F\u002Fgithub.com\u002Ffrankhommers\">\u003Cimg src=\"https:\u002F\u002Fgithub.com\u002Ffrankhommers.png?size=80\" width=\"80\" alt=\"frankhommers\"\u002F>\u003Cbr\u002F>\u003Csub>\u003Cb>frankhommers\u003C\u002Fb>\u003C\u002Fsub>\u003C\u002Fa>\u003C\u002Ftd>\n    \u003Ctd align=\"center\">\u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fhagiwaratakayuki\">\u003Cimg src=\"https:\u002F\u002Fgithub.com\u002Fhagiwaratakayuki.png?size=80\" width=\"80\" alt=\"hagiwaratakayuki\"\u002F>\u003Cbr\u002F>\u003Csub>\u003Cb>hagiwaratakayuki\u003C\u002Fb>\u003C\u002Fsub>\u003C\u002Fa>\u003C\u002Ftd>\n    \u003Ctd align=\"center\">\u003Ca href=\"https:\u002F\u002Fgithub.com\u002Ftomstetson\">\u003Cimg src=\"https:\u002F\u002Fgithub.com\u002Ftomstetson.png?size=80\" width=\"80\" alt=\"tomstetson\"\u002F>\u003Cbr\u002F>\u003Csub>\u003Cb>tomstetson\u003C\u002Fb>\u003C\u002Fsub>\u003C\u002Fa>\u003C\u002Ftd>\n    \u003Ctd align=\"center\">\u003Ca href=\"https:\u002F\u002Fgithub.com\u002Flogancox\">\u003Cimg src=\"https:\u002F\u002Fgithub.com\u002Flogancox.png?size=80\" width=\"80\" alt=\"logancox\"\u002F>\u003Cbr\u002F>\u003Csub>\u003Cb>logancox\u003C\u002Fb>\u003C\u002Fsub>\u003C\u002Fa>\u003C\u002Ftd>\n    \u003Ctd align=\"center\">\u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fhansonkim\">\u003Cimg src=\"https:\u002F\u002Fgithub.com\u002Fhansonkim.png?size=80\" width=\"80\" alt=\"hansonkim\"\u002F>\u003Cbr\u002F>\u003Csub>\u003Cb>hansonkim\u003C\u002Fb>\u003C\u002Fsub>\u003C\u002Fa>\u003C\u002Ftd>\n  \u003C\u002Ftr>\n\u003C\u002Ftable>\n\n## License\n\nMIT\n","ClaudeBar 是一款 macOS 菜单栏应用程序，用于监控 AI 编码助手的使用配额。它支持 Claude、Codex、Gemini 等多个 AI 服务提供商，并允许用户在设置中启用或禁用特定的服务商以自定义监控内容。该应用提供实时配额跟踪功能，能够显示会话、周度及模型特定的使用百分比。此外，ClaudeBar 拥有多种主题（包括浅色、深色、CLI 和圣诞主题），并能根据系统外观自动切换，还具备系统通知和自动刷新等特性。适用于频繁使用 AI 辅助编程工具的开发者，帮助他们更好地管理自己的资源消耗情况。",2,"2026-06-11 03:53:19","trending"]