explaingit

mgks/aimonitor

Analysis updated 2026-07-26

1SwiftAudience · developerComplexity · 2/5LicenseSetup · easy

TLDR

A macOS menu bar app that shows remaining usage and balances for multiple AI services like Claude, OpenRouter, and DeepSeek in one place.

Mindmap

mindmap
  root((repo))
    What it does
      Menu bar app
      Tracks AI usage
      Shows balances
    Providers
      Claude Code
      OpenRouter
      DeepSeek
      MiniMax
    Alerts
      Low quota warnings
      Reset notifications
    Install
      Download disk image
      Drag to Applications
      Bypass security warning
    Tech stack
      Swift
      macOS native
    License
      MIT licensed

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Check remaining Claude Code or OpenRouter quota without logging into each website.

USE CASE 2

Get notified before your AI service usage runs out so you are not caught off guard.

USE CASE 3

Monitor account balances across multiple AI providers in dollars or yuan.

USE CASE 4

Track both 5-hour and weekly usage windows for AI coding tools.

What is it built with?

SwiftmacOSMakefile

How does it compare?

mgks/aimonitoraakarsh-goyal/macjuicealan13367/opensnapx
Stars111
LanguageSwiftSwiftSwift
Setup difficultyeasyeasymoderate
Complexity2/51/53/5
Audiencedevelopergeneraldeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

Download a disk image and drag to Applications, then bypass a one-time macOS security warning since the app is not Apple Developer Program signed.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

In plain English

AIMonitor is a small macOS app that lives in your menu bar and tracks how much usage you have left across several AI services. Instead of logging into each provider's website to check whether you are about to hit a limit, you click one icon and see current quotas, remaining balances, and service health for all your configured providers at once. The app supports seven providers: Claude Code, Codex, Kimi, MiniMax, Z.ai (GLM), DeepSeek, and OpenRouter. Some providers use OAuth login through their official command line tools, so you run the provider's setup once and AIMonitor reads the credentials automatically, refreshing tokens when they expire. Others require an API key that you paste into the preferences screen. MiniMax and Z.ai offer a choice between international and China endpoints. The information displayed varies by provider: some show five hour and weekly usage windows with plan tier details, while others show account balances in dollars or yuan. A few practical details stand out. The app refreshes every 60 seconds by default, and you can change that interval. It sends notifications when quota drops below 20 percent, 10 percent, or when it runs out or resets. Each provider appears as a card with progress bars for both the five hour and weekly windows. Your API keys are stored in a local file on your machine rather than in the macOS Keychain, which means you will not see repeated system password prompts. Installing involves downloading a disk image file from the project's releases page and dragging the app to your Applications folder. Because the project is open source and not part of Apple's paid developer program, macOS will show a security warning on first launch. The README walks through a one time process of confirming you want to open the app anyway through System Settings. Developers can build from source using Swift and a Makefile, and the README documents how to add new providers. The project is MIT licensed with no analytics and no backend. The full README is longer than what was shown.

Copy-paste prompts

Prompt 1
Help me add a new AI provider to AIMonitor that shows a monthly usage limit and account balance. What files do I need to modify and how should I structure the provider config?
Prompt 2
I want to change the default refresh interval in AIMonitor from 60 seconds to 30 seconds. Where in the Swift code would I make that change?
Prompt 3
Write a launchd plist that starts AIMonitor automatically when I log into my Mac and keeps it running in the menu bar.

Frequently asked questions

What is aimonitor?

A macOS menu bar app that shows remaining usage and balances for multiple AI services like Claude, OpenRouter, and DeepSeek in one place.

What language is aimonitor written in?

Mainly Swift. The stack also includes Swift, macOS, Makefile.

What license does aimonitor use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is aimonitor to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is aimonitor for?

Mainly developer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.