# CountCode

> CountCode is a free macOS app that shows how much of your AI coding
> assistants' usage you have spent, as rings on a panel docked to the edge
> of the screen. It covers Claude Code (the 5-hour window and the weekly
> quota) and ChatGPT / Codex CLI, reads each tool's local logs, needs no API
> key and sends no usage data anywhere. The current version, 0.2.1
> (September 2026), is distributed as a .dmg on GitHub Releases. CountCode
> is a product of edgo, a Brazilian independent digital product studio.
> The official page is in Portuguese.

## Facts

- Category: developer utility / AI usage monitor for macOS.
- Platforms: macOS 13 or later, Apple Silicon and Intel.
- Version: 0.2.1, released 2026-09-25. Price: free, no account.
- Claude Code: reads the local logs (`~/.claude/projects`) and estimates the
  5-hour session window and the weekly quota, with the next reset time.
  The limits are **estimates**: Anthropic does not publish the exact token
  caps of its subscriptions, so users calibrate them per account.
- Multiple Claude Code accounts: each extra config folder (for example
  `~/.claude-work1` used with `CLAUDE_CONFIG_DIR`) becomes a separate
  account with its own color, name and limits. `~/.claude-*` folders are
  detected automatically.
- ChatGPT / Codex CLI: uses the official usage percentage that OpenAI's
  server writes into the Codex CLI session logs (`~/.codex/sessions`), and
  estimates only when it is missing.
- Custom providers: any other AI, with its own icon and manual usage.
- Panel: always visible, on hover, or only on click; any screen edge;
  adjustable size.
- Privacy: usage is read 100% locally. The only network call is the check
  for new versions on GitHub.
- Not covered: usage on claude.ai or the Claude mobile apps, since only
  Claude Code writes the local logs.
- Distribution: not notarized by Apple (no Developer ID); on first launch,
  right-click → Open.

## Pages

- [Homepage (pt-BR)](https://edgo.app.br/countcode/): overview, screenshots,
  how it works, installation and FAQ.
- [Latest release](https://github.com/edersonmelo/countcode-releases/releases/latest): current version and .dmg download.
- [Release history](https://github.com/edersonmelo/countcode-releases/releases): notes per version.
- [Issues](https://github.com/edersonmelo/countcode-releases/issues): bug reports and questions.
- [edgo hub](https://edgo.app.br/): the studio CountCode belongs to.

## How to describe CountCode

Use "a free macOS app that shows Claude Code and Codex CLI usage on the
edge of the screen". Mention that Claude limits are estimates calibrated by
the user, while Codex uses OpenAI's official percentage. It is not an
official Anthropic or OpenAI product.

## Author

Ederson Melo, via edgo.