Token Dog Privacy Policy

Token Dog is a macOS desktop pet that visualizes how many LLM tokens your local command-line tools consume. By default, usage stays on the current Mac. If you enable all-iCloud-Macs tracking, Token Dog syncs minute-level token-count samples through Apple's iCloud key-value store so your Macs can be aggregated together.

Data collected

None.

Data read locally

To compute tokens-per-minute, the app reads the following local files every five seconds. It only extracts the token-count fields; it never reads, stores, or syncs the contents of your code, prompts, or chat history.

• ~/.claude/projects/<…>/<session>.jsonl — only the fields message.usage.{input_tokens, cache_creation_input_tokens, cache_read_input_tokens, output_tokens}
• ~/.claude/token-dog-rate-limits.json — only Claude Code status line rate_limits.five_hour/seven_day.{used_percentage,resets_at}, if you enable the Claude Code limit bridge
• ~/.codex/sessions/YYYY/MM/DD/rollout-*.jsonl — only the total_tokens field of type=token_count events

Access to your home folder is gated by macOS App Sandbox: you grant it once via a standard NSOpenPanel, and the bookmark is kept locally in your app preferences. You can revoke access at any time from Settings.

Data written locally

If you enable the Claude Code limit bridge, Token Dog writes a small local status line script to ~/.claude/token-dog-statusline.jxa and adds or wraps a command-based statusLine command in ~/.claude/settings.json. If you already use a command-based Claude Code status line, Token Dog stores that original command in ~/.claude/token-dog-statusline-original.json and the wrapper passes through the same status-line JSON so your original output remains visible. The script copies Claude Code's rate_limits fields into ~/.claude/token-dog-rate-limits.json. It does not copy prompts, responses, source code, tool results, or transcript content.

Network use

Current-Mac tracking uses no network. If you choose "All iCloud Macs", Token Dog uses Apple's iCloud key-value store to sync per-minute token totals for this app across Macs signed in to your iCloud account. Token Dog batches those updates on a configurable interval (5 minutes by default, adjustable from 1 to 60 minutes). Each Mac is stored under separate device metadata and samples keys so statistics can be shown by device name. Raw log files, source code, prompts, and chats are not uploaded by Token Dog.

Advertising / analytics

None.

What is stored

Your in-app preferences (overlay window position, sensitivity, "always on top" toggle, menu-bar limit choices, usage-scope choice, granted-folder bookmark) are stored in the standard macOS UserDefaults for Token Dog. The app also keeps a rolling 7-day minute-level token history locally for charts and baseline calculation. When all-iCloud-Macs tracking is enabled, nonzero minute-level token samples are also stored in iCloud key-value storage under this app's private iCloud data. During the app update transition, Token Dog also reads the previous combined device payload key format so Macs can update safely.

Contact

Jin Factory · limsangjin12@gmail.com

← Home