TokenFlow: Local-First AI Token Analytics

TokenFlow is a tool designed to help developers track exactly where their AI tokens are being spent. It works directly on your computer to monitor live costs, token usage, and model performance across different AI coding assistants. The software provides a menu bar app for macOS and a web dashboard to visualize data. It focuses on accuracy and privacy by ensuring no data leaves your machine.

Benefits

TokenFlow offers several key advantages for developers who use AI tools daily. First, it prioritizes privacy by operating on a local-first principle. No API keys, accounts, or personal data are sent to external servers. The tool reads data from your local files and binds its server to your local network only. Second, it ensures high accuracy. Many other dashboards make mistakes like double-counting cached tokens or inflating totals from streaming logs. TokenFlow fixes these issues by using strict rules to prevent errors. Third, it provides clear visibility. Users can see breakdowns by provider, source, and specific AI model. The tool also includes capacity meters and forecasts to help users manage their budgets and avoid unexpected costs.

Use Cases

TokenFlow is built for developers and teams who rely on AI coding assistants. It supports a wide range of tools including Anthropic, OpenAI, Codex, OpenCode, Hermes, Cline, Cursor, and Headroom. It can also analyze any Git repository to track work signals independently. The tool is useful for individuals who want to monitor their monthly spending limits or teams that need to compare usage across different developers. The menu bar app is ideal for quick checks on daily or monthly spending, while the web dashboard offers deep dives into usage patterns, efficiency, and time-based trends. Users can set custom limits and receive alerts when they approach their budget caps.

Pricing

TokenFlow is available as an open-source project under the MIT license. This means it is free to download and use for personal or commercial purposes. There are no subscription fees or hidden costs associated with the software itself. Users can install it via Homebrew on macOS, npm for cross-platform use, or by downloading the manual app build. While the software is free, users may need to consider their own internet connection for syncing data across machines if they choose to use that optional feature.

Vibes

As an open-source tool, TokenFlow has not yet gathered a large volume of public reviews or testimonials. However, the project has received attention from the developer community for its focus on accuracy and privacy. The creator has included extensive testing and linting rules to ensure the data is correct. Early feedback from users who have tried the tool highlights its ability to provide clear insights into AI spending that other tools miss. The emphasis on local data storage and the absence of telemetry has been well-received by privacy-conscious developers.

Additional Information

TokenFlow is developed by an independent creator and is hosted on GitHub. The project welcomes contributions from the community, particularly for creating new adapters for different AI tools. The codebase includes over 145 tests to maintain quality. The tool requires Node 22.5 or higher to run. It is designed to be lightweight and efficient, with incremental refresh capabilities that allow it to update data quickly without re-reading entire files. The project is actively maintained and updated to support new AI tools and features as they emerge.