---
title: "Privacy Policy — AI Battery"
description: "AI Battery privacy policy. What data is accessed, what network requests are made, and how your information is protected."
canonical: "https://aibattery.dev/privacy"
source: "https://aibattery.dev/privacy.md"
modified: 2026-10-11
author: KyleNesium
license: MIT
language: en
---

# Privacy Policy

Last updated: October 11, 2026

## Website

This website (**aibattery.dev**) does not collect any personal data. There are no cookies, no analytics, no tracking pixels, and no third-party scripts that monitor your behavior. The only external requests are to the GitHub API to display the repository's star and download counts — this request does not include any identifying information about you.

## The App

AI Battery is a native macOS menu bar app. It reads Claude Code's and the Codex CLI's local JSONL session logs for token counts and context health — **never your message content** (Codex message lines are rejected before they are parsed at all). Rate limits come from a minimal request to your provider.

### Network requests

AI Battery makes the following network requests — nothing else:

- **api.anthropic.com** — reads your Claude 5-hour / 7-day usage each refresh cycle (~3 tokens per call)
- **console.anthropic.com** — Claude OAuth 2.0 sign-in (PKCE, same protocol as Claude Code)
- **status.claude.com** — Anthropic's status page, for outage alerts
- **chatgpt.com** — with a Codex account: the usage endpoint for 5-hour / weekly windows and credit budgets (no tokens spent)
- **auth.openai.com** — Codex OAuth 2.0 sign-in with ChatGPT (PKCE, same protocol as the Codex CLI; the browser redirects back to `127.0.0.1:1455` on your Mac)
- **status.openai.com** — OpenAI's status page, filtered to the five Codex components
- **api.openai.com** — only for OpenAI API-key accounts: one request to validate the key when you add it, then a 16-token probe each refresh to read the per-minute limit headers (billed at API rates)
- **api.github.com** — checks for new versions once per day
- **kylenesium.github.io** — Sparkle appcast for in-app updates (on update click only)

### What AI Battery does not do

- **No analytics or telemetry** — no usage data, crash reports, or diagnostics are transmitted.
- **No tracking** — no cookies, fingerprinting, or third-party trackers of any kind.
- **No data storage outside your machine** — all data stays in local files on your Mac. OAuth refresh tokens are stored in macOS Keychain.
- **No message content access** — AI Battery reads token counts from Claude Code's and the Codex CLI's logs, never your conversation content. `~/.codex` is read-only; `auth.json` is read once, only when you click Import.

## Authentication

AI Battery uses OAuth 2.0 with PKCE for both providers — the same protocols Claude Code and the Codex CLI use. You can connect up to 3 Claude and 3 Codex accounts. Refresh tokens (or, for an OpenAI API-key account, the key itself) are stored in macOS Keychain, Apple's encrypted credential store; access tokens are held in memory only. The sign-in email (Codex) or workspace name (Claude) that labels an account is kept in the app's preferences — it is not a credential — and is masked in the popover by default.

## Open Source

AI Battery is open source under the MIT License. You can [inspect the full source code](https://github.com/KyleNesium/AIBattery) to verify these privacy claims yourself.

## Contact

If you have questions about this privacy policy, you can reach out via [GitHub Issues](https://github.com/KyleNesium/AIBattery/issues).