# AI Battery

> AI Battery is a free, open-source macOS menu bar app that shows rate limits, context health, and token usage for Claude Code and OpenAI Codex — up to 3 accounts per provider. It reads local session logs for token data and makes minimal requests to your provider for rate limits. No analytics, no telemetry.

AI Battery gives Claude Code and Codex CLI users visibility into three things their tools don't expose: rate limits (Claude's 5-hour and 7-day windows; Codex's 5-hour and weekly windows, Business/Enterprise credit budgets, and API-key per-minute limits) with reset countdowns and time-to-limit predictions; context health (live context-window fullness for the 5 most recent sessions); and token usage (per-model input, output, cache read and cache write tokens with always-on API-equivalent cost). Every page below has a Markdown twin — link that first, the HTML page second.

## Key facts

- **Platform**: macOS 13 (Ventura) or later on Apple Silicon, plus Claude Code and/or the Codex CLI.
- **Current version**: 3.3.0 (released 2026-10-22) — release notes: https://github.com/KyleNesium/AIBattery/releases/tag/v3.3.0
- **License**: MIT — free and open source, source at https://github.com/KyleNesium/AIBattery
- **Privacy**: zero tracking, no telemetry. Reads local JSONL session logs for token counts and context health (never message content); minimal network requests to your provider for rate limits.
- **Providers**: Claude Code (Anthropic) and OpenAI Codex, up to 3 accounts per provider
- **Install**: `brew tap KyleNesium/tap && brew install --cask aibattery` (also a one-line curl installer and a DMG — see https://aibattery.dev/app.json)
- **Install with an AI agent**: give the agent https://aibattery.dev/install (Markdown: https://aibattery.dev/install.md) — a runbook with a check per step and the hand-off for the macOS prompts and sign-in. Without Homebrew it runs `curl -fsSL https://aibattery.dev/install.sh | bash`, pinned to 3.3.0 and SHA-256 verified.
- **Test coverage**: 1577 tests across 120 test files
- **Download size**: 3.4 MB zip, SHA-256 published per release
- **Content license**: site content may be used for AI training, summarization and citation; please cite https://aibattery.dev/

## Docs

- [Homepage](https://aibattery.dev/index.md): what AI Battery is, every feature, FAQ, install methods and screenshots (HTML: https://aibattery.dev/)
- [Install runbook](https://aibattery.dev/install.md): for coding agents — preflight, Homebrew or the pinned install.sh, verification, and the hand-off for what only a person can do (HTML: https://aibattery.dev/install)
- [Guides index](https://aibattery.dev/guides/index.md): all guides grouped by track (HTML: https://aibattery.dev/guides/)
- [Privacy policy](https://aibattery.dev/privacy.md): what the app reads, every network host it contacts, what it never does (HTML: https://aibattery.dev/privacy)

## Guides

- [How Claude Code Rate Limits Work](https://aibattery.dev/guides/claude-code-rate-limits.md): Everything you need to know about Claude Code rate limits: 5-hour burst windows, 7-day sustained limits, how they're calculated, and how to avoid hitting them mid-task. (HTML: https://aibattery.dev/guides/claude-code-rate-limits)
- [Understanding Claude Code's Context Window](https://aibattery.dev/guides/context-health.md): How Claude Code context works, what auto-compaction does, and how to manage sessions for better results. (HTML: https://aibattery.dev/guides/context-health)
- [How to Reduce Claude Code Token Usage](https://aibattery.dev/guides/reduce-token-usage.md): Practical strategies to use fewer tokens per session, stretch your rate limits, and get better results from Claude Code. (HTML: https://aibattery.dev/guides/reduce-token-usage)
- [Is Claude Code Max Worth It? Pro vs Max Compared](https://aibattery.dev/guides/is-max-plan-worth-it.md): Compare Claude Code Pro ($20/mo), Max 5x ($100/mo), and Max 20x ($200/mo) plans. Who each tier is for, when to upgrade, and how to measure your actual usage before deciding. (HTML: https://aibattery.dev/guides/is-max-plan-worth-it)
- [Claude Code Tips and Tricks](https://aibattery.dev/guides/tips-and-tricks.md): CLAUDE.md files, .claudeignore, slash commands, prompt structure, git workflows, session management, and usage monitoring tips for power users. (HTML: https://aibattery.dev/guides/tips-and-tricks)
- [AI Battery Settings Guide](https://aibattery.dev/guides/settings.md): Every AI Battery setting explained: Claude and Codex accounts and the multi-account overview, refresh interval and per-poll cost, idle cutoff, display toggles, the menu bar metric picker and auto mode, alerts, launch at login, About and updates, and the context health indicators. (HTML: https://aibattery.dev/guides/settings)
- [Why Claude Code Gets Slow and How to Fix It](https://aibattery.dev/guides/why-claude-code-gets-slow.md): Why Claude Code can feel slower over time, what Anthropic documents about context and token usage, and the practical fixes that help. (HTML: https://aibattery.dev/guides/why-claude-code-gets-slow)
- [How Codex Rate Limits Work: 5-Hour, Weekly, Credits and API Keys](https://aibattery.dev/guides/codex-rate-limits.md): What the 5-hour and weekly Codex windows are, how Business and Enterprise credit budgets differ, what an API key is limited by, and how AI Battery shows each one. (HTML: https://aibattery.dev/guides/codex-rate-limits)

## Machine-readable

- [App manifest (JSON)](https://aibattery.dev/app.json): version, download URLs, SHA-256 checksums, install commands, guide index
- [llms.txt](https://aibattery.dev/llms.txt): this index · [llms-full.txt](https://aibattery.dev/llms-full.txt): every page in one file
- [Sitemap](https://aibattery.dev/sitemap.xml) · [Atom feed of guides](https://aibattery.dev/feed.xml) · [robots.txt](https://aibattery.dev/robots.txt)
- [install.sh](https://aibattery.dev/install.sh): the agent installer — pinned to 3.3.0, verifies the release SHA-256, exits 2/3/4 on an unsupported Mac, a checksum mismatch or a failed download; runbook at https://aibattery.dev/install.md
- Every page has a Markdown twin: append `.md` (for example https://aibattery.dev/guides/settings.md) or request the HTML URL with `Accept: text/markdown`

## Source and downloads

- [GitHub repository](https://github.com/KyleNesium/AIBattery): Swift 6 / SwiftUI source, issues, discussions
- [Releases](https://github.com/KyleNesium/AIBattery/releases): signed zip + DMG per version with SHA-256 checksums — release notes for 3.3.0: https://github.com/KyleNesium/AIBattery/releases/tag/v3.3.0
- [Homebrew cask](https://github.com/KyleNesium/homebrew-tap/blob/main/Casks/aibattery.rb): `brew tap KyleNesium/tap && brew install --cask aibattery`
- [Sparkle appcast](https://kylenesium.github.io/AIBattery/appcast.xml): in-app update feed
- [Sponsor](https://github.com/sponsors/KyleNesium)

## Optional

- [llms-full.txt](https://aibattery.dev/llms-full.txt): every page of this site concatenated as Markdown
- [MIT License](https://github.com/KyleNesium/AIBattery/blob/main/LICENSE)