Privacy Policy

Last updated: April 6, 2026

TL;DR — The one-sentence version

TokenPet runs entirely on your device, never connects to any server, and never collects, transmits, or stores any of your data anywhere outside your Mac.

1. Overview

TokenPet ("the App", "we", "our") is a macOS application that reads local AI programming tool token usage data and displays it as a virtual pet. This privacy policy explains what data the App accesses, how it uses that data, and what we do (and do not do) with it.

2. Data We Access

The App reads the following data from your local filesystem:

  • JSONL log files generated by Claude Code (typically at ~/.claude/usage/)
  • JSONL log files generated by OpenAI Codex CLI (if enabled in Settings)

These files contain token counts and timestamps. The App reads only the numerical token usage data it needs to calculate your pet's hunger, mood, and level. It does not read, store, or process the content of any AI conversations.

3. Data We Do NOT Collect

We do not collect:

  • Your name, email address, or any personally identifiable information
  • The contents of any prompts, conversations, or code you write
  • Your IP address or location
  • Device identifiers or hardware information
  • Usage analytics, crash reports, or telemetry of any kind

4. Network Access

TokenPet does not make any network requests. It has no internet connectivity whatsoever. There are no servers to receive your data. All computation occurs locally on your Mac.

5. Data Storage

The App stores only its own application state locally on your Mac, including:

  • Your pet's name, level, and historical token totals
  • File read checkpoints (to avoid re-reading log files from scratch)
  • App settings (poll interval, selected data sources, custom paths)

This data is stored in macOS's standard application data directory and is never transmitted anywhere. You can delete all stored data at any time via Settings → Reset Data.

6. Third-Party Services

The App does not integrate with any third-party analytics, advertising, crash reporting, or data-sharing services. There are no SDKs embedded in the App that could transmit data on our behalf.

7. Children's Privacy

TokenPet is designed for software developers and is not directed at children under 13. We do not knowingly collect information from children.

8. Changes to This Policy

If we ever change this policy in a meaningful way, we will update the "Last updated" date above and release a new version of the App with the updated policy included. Since we collect no data, changes to this policy can only ever make it more protective of your privacy.

9. Contact

Questions about this privacy policy? Reach us at hello@tokenpet.app or open an issue on GitHub.