https://github.com/ilja82/llm-budget-tracker
macOS menu bar app for monitoring LiteLLM budget usage, pacing, and daily activity charts.
https://github.com/ilja82/llm-budget-tracker
budget-tracking cost-monitoring litellm llm macos menubar menubar-app swift swiftui usage-analytics
Last synced: 8 days ago
JSON representation
macOS menu bar app for monitoring LiteLLM budget usage, pacing, and daily activity charts.
- Host: GitHub
- URL: https://github.com/ilja82/llm-budget-tracker
- Owner: ilja82
- License: mit
- Created: 2026-04-01T07:21:30.000Z (26 days ago)
- Default Branch: main
- Last Pushed: 2026-04-18T19:34:30.000Z (8 days ago)
- Last Synced: 2026-04-18T20:33:53.107Z (8 days ago)
- Topics: budget-tracking, cost-monitoring, litellm, llm, macos, menubar, menubar-app, swift, swiftui, usage-analytics
- Language: Swift
- Homepage:
- Size: 2.4 MB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Agents: AGENTS.md
Awesome Lists containing this project
README
# LLM Budget Tracker
The LLM Budget Tracker is a macOS application that sits in your status bar and monitors your LiteLLM budget usage. It retrieves your budget from your
LiteLLM proxy and displays daily activity charts.
## What it does
- Shows current budget usage directly in the macOS status bar.
- Colors the menu bar progress indicator based on pacing status.
- Opens a popover with remaining budget, reset timing, projected spend, and pacing details.
- Optionally loads daily activity data for spend, token usage, and request success/failure charts.
## Install the app
Use homebrew to install the app:
```bash
brew install --cask ilja82/tap/llm-budget-tracker
```
## Run the app
Open the installed app `llmBudgetTracker.app` using Spotlight (`⌘` + `SPACE`). The app will then appear in the menu bar.
## Configure the app
Click the menu bar item, then open Settings.
* Enter your LiteLLM proxy URL and API key, test the connection.
* Activate `Launch at Login` if you want the app to start automatically on system startup.
* Save the settings.
## Build from source
```bash
# 1. Clone
git clone https://github.com/ilja82/llm-budget-tracker.git
cd llm-budget-tracker
# 2. Install XcodeGen and additional tools (if not already installed)
brew install xcodegen swiftlint
# 3. Generate the Xcode project
xcodegen generate
# 4. Open in Xcode and run
open LLMBudgetTracker.xcodeproj
```
In Xcode run `⌘` + `R` to build and run the app.
## License
Distributed under the MIT License. See [`LICENSE`](LICENSE) for more information.