https://github.com/rygel/aiconsumptiontracker

Token usage tracker for (not only) OpenCode
https://github.com/rygel/aiconsumptiontracker

antigravity claude-code github-copilot kimi minimax openai-codex opencode synthetic windows xiaomi zai

Last synced: 6 days ago
JSON representation

Token usage tracker for (not only) OpenCode

• Host: GitHub
• URL: https://github.com/rygel/aiconsumptiontracker
• Owner: rygel
• License: mit
• Created: 2026-02-04T15:52:09.000Z (12 days ago)
• Default Branch: main
• Last Pushed: 2026-02-09T20:58:33.000Z (7 days ago)
• Last Synced: 2026-02-09T23:41:19.114Z (7 days ago)
• Topics: antigravity, claude-code, github-copilot, kimi, minimax, openai-codex, opencode, synthetic, windows, xiaomi, zai
• Language: C#
• Homepage:
• Size: 16.7 MB
• Stars: 11
• Watchers: 0
• Forks: 0
• Open Issues: 4
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • License: LICENSE
  • Agents: AGENTS.md

Awesome Lists containing this project

README

          
#  AI Consumption Tracker

![Version](https://img.shields.io/badge/version-1.8.4-blue)

![License](https://img.shields.io/badge/license-MIT-green)

![Platforms](https://img.shields.io/badge/platforms-Windows%20|%20Linux%20-blue)

![Language](https://img.shields.io/badge/language-C%23%20|%20.NET-purple)

[![](https://dcbadge.limes.pink/api/server/AZtNQtWuJA?style=flat)](https://discord.gg/AZtNQtWuJA)

![Downloads](https://img.shields.io/github/downloads/rygel/AIConsumptionTracker/total)

![Dashboard](docs/screenshot_dashboard_privacy.png)

A streamlined Windows dashboard and tray utility to monitor AI API usage, costs, and quotas across multiple providers.

## Support

If you want to support me and are interested in different AI model providers, you can sign up with my referral codes:

- [Z.AI](https://z.ai/subscribe?ic=JQTB1W1M0L): GLM-4.7, GLM-4.6, GLM-4.7-flash

- [synthetic.new](https://synthetic.new/?referral=SNJDbFCgSUZso9E): Minimax M2.1, Kimi K2.5, GLM-4.7, etc.

### Documentation

- [User Manual](docs/user_manual.md)

- [CLI Reference](docs/cli_documentation.md)

- [Agent Guidelines](AGENTS.md)

### Community

Join the discussion on our [Discord Server](https://discord.gg/AZtNQtWuJA).

## Download

Download the latest installer or .zip file from the [Release](https://github.com/rygel/AIConsumptionTracker/releases) page.

## Key Features

- **Multi-Provider Support**: Track usage for Anthropic, Gemini, OpenRouter, OpenCode, Kilo Code, DeepSeek, OpenAI, Google Cloud Code, GitHub Copilot, Codex, Mistral, and more.

- **Smart Discovery**: Automatically scans environment variables, Claude Code credentials, and standard configuration files for existing API keys.

- **Auto-Updates**: Notifies you of new releases directly in the dashboard with a one-click download link.

- **Minimalist Dashboard**: A compact, topmost window providing a quick overview of your current spend and token usage.

- **Compact Settings UI**: Streamlined provider cards with 40-50% less vertical space, larger dialog for better visibility.

- **Dynamic Tray Integration**:

  - **Auto-Hide**: Dashboard hides automatically when focus is lost.

  - **Individual Tracking**: Option to spawn separate tray icons for specific providers.

  - **Live Progress Bars**: Tray icons feature "Core Temp" style bars that reflect usage levels in real-time.

- **Inverted Progress Bars**: Default "Health Bar" mode showing **Remaining** capacity (starting green/full) instead of "Used" capacity.

- **Improved DeepSeek Support**: Detailed multi-currency (CNY/USD) balance tracking with official branding.

- **Secure Management**: Manage all keys and preferences through a refined, dark-themed settings menu.

## Supported Providers

| Provider | Integration | Status | Notes |

|:---------|:------------|:-------|:------|

| **Anthropic (Claude)** | OAuth / API Key | ✅ Tested | Usage dashboard only |

| **Antigravity** | GUI Auth | ✅ Tested | Multi-model quotas |

| **DeepSeek** | API Key¹ | ⚠️ Beta | **testers needed** |

| **Gemini** | API Key | 🚧 Planned | Not yet integrated |

| **GitHub Copilot** | OAuth Device | ✅ Tested | Auto-discovery via CLI |

| **Kimi (Moonshot)** | API Key¹ | ⚠️ Beta | **testers needed** |

| **Minimax** | API Key¹ | ⚠️ Beta | China & International |

| **Mistral** | API Key | ✅ Tested | API usage not available |

| **OpenAI (Codex)** | OAuth | ⚠️ Beta | Via OpenCLI |

| **OpenRouter** | API Key¹ | 🚧 Planned | Testers needed |

| **Opencode Zen** | API Key¹ | ✅ Tested | Pay-as-you-go & Plans |

| **Synthetic** | API Key¹ | ✅ Tested | Multi-model support |

| **Z.AI** | API Key¹ | ✅ Tested | Coding plans |

**Legend:** ✅ Tested | ⚠️ Beta | 🚧 Planned

¹API Keys can be entered manually or discovered from opencode config files*  

*Providers with OAuth support automatic token discovery*

### Screenshots

**Dashboard**

![Dashboard](docs/screenshot_dashboard_privacy.png)

**Settings**

![Settings](docs/screenshot_settings_privacy.png)

**Info Dialog**

![Info](docs/screenshot_info_privacy.png)

**Tray Icons**

Provider usage reflected in real-time with dynamic progress bars:

- ![Good Status](docs/tray_icon_good.png) (Healthy/Good)

- ![Warning Status](docs/tray_icon_warning.png) (Warning)

- ![Danger Status](docs/tray_icon_danger.png) (Critical/Over Limit)

**Context Menu**

Right-click system tray icon for quick access:

![Context Menu](docs/screenshot_context_menu_privacy.png)

## Installation

### Manual

1. Download the latest `AIConsumptionTracker_Setup_v1.7.12.exe` from the [Releases](https://github.com/rygel/AIConsumptionTracker/releases) page.

2. Run the installer.

3. The app will launch and automatically scan for common API keys.

## Configuration & Settings

Access the **Settings** menu by right-clicking the tray icon or using the gear icon on the dashboard.

### Application Settings

- **Show All Providers**: Toggle to show all configured providers, even those with 0 usage or errors.

- **Compact Mode**: Reduces the height of each item, removing the icon and condensing the layout.

- **Pin Window**: Keeps the dashboard open even when focus is lost.

- **Always On Top**: Ensures the dashboard floats above other windows.

- **Invert Progress Bars**: 

    - **Checked**: Bars represent **Remaining** capacity (Start Full/Green -> End Empty/Red).

    - **Unchecked**: Bars represent **Used** capacity (Start Empty -> End Full/Red).

- **Color Thresholds**: Customize the percentage at which bars turn Yellow (Warning) or Red (Critical).

- **Auto Refresh Interval**: 

    - **Minutes**: Set how often (in minutes) the app should automatically check provider APIs for new consumption data.

    - **Disable**: Set to **0** to disable automatic background refreshing.

### Provider Management

- **API Keys**: enter or update specific keys for each provider.

- **Track in Tray**: Check the box next to any provider to add a dedicated icon for it in your system tray.

- **Sub-Quotas**: For complex providers like Antigravity, you can pin specific model quotas to the tray.

## Storage

Configuration is stored in `auth.json` in the application data directory.

- **Automatic Backup**: Your previous configuration is preserved during updates.

- **Secure**: API keys are stored locally.

## License

MIT