# Indicators

> Native macOS menu bar app that shows live AI rate-limit usage (Claude Code, OpenAI Codex, Gemini CLI) with reset times, ccusage-compatible cost estimates from local CLI logs, and optional real invoiced spend from vendor admin APIs. Open source (MIT), no telemetry, no backend.

Website: https://indicators.jonymusky.com/
Source: https://github.com/jonymusky/indicators
Download: https://github.com/jonymusky/indicators/releases/latest
Install one-liner: curl -fsSL https://indicators.jonymusky.com/install.sh | sh
Requirements: macOS 14+. Builds with Xcode Command Line Tools only (SwiftPM).

## What it shows
- Claude: 5-hour session and weekly windows (%, reset time), per-model weekly windows, extra usage. Source: Claude Code OAuth login. Costs from ~/.claude/projects transcripts. Real spend via Anthropic Admin API cost report.
- OpenAI: plan rate-limit windows from the Codex CLI / ChatGPT login (fallback: last values in Codex logs). Costs from ~/.codex/sessions rollouts. Real spend via OpenAI Costs API.
- Gemini: per-model quota buckets from the Gemini CLI Google login. Costs from ~/.gemini/tmp chats.
- Grok: xAI exposes no subscription limits; spend and prepaid balance via xAI Management API.

## Cost method
Token counts (input, cache read, cache write incl. 1-hour tier, output) × public API list prices from the LiteLLM pricing table. Numbers match ccusage for the same logs.

## MCP server (model routing for agents)
indicators-mcp (inside the app bundle, stdio JSON-RPC) exposes: get_usage, recommend_model(task), list/set/delete_routing_rule, estimate_cost, list_models. Rules in ~/.config/indicators/routing.json map a task to a primary model, ordered fallbacks and a saturation threshold; recommend_model returns the first candidate whose provider is below the threshold, with the reason. Register: claude mcp add indicators -- /Applications/Indicators.app/Contents/MacOS/indicators-mcp

## Privacy
Runs entirely on device. Logs are read-only. Tokens read from other CLIs are used in memory for a single request to their own vendor. User-supplied keys live in the macOS Keychain.

## Docs
- README: https://github.com/jonymusky/indicators#readme
- Security & privacy details: https://github.com/jonymusky/indicators/blob/main/SECURITY.md
- Contributing: https://github.com/jonymusky/indicators/blob/main/CONTRIBUTING.md