English | 简体中文

TokenFlow

TokenFlow is a Windows and macOS desktop app for managing AI coding accounts and their provider-native quota windows in one place.

It brings account connections, quota windows, request activity, local logs, and workspace organization into a single desktop workflow for AI coding.

Why TokenFlow

• One desktop workspace for your main AI coding accounts
• Provider-native quota windows with each provider's own semantics
• Fast account overview for plan, health, reset windows, and recent updates
• Local logs and request visibility for troubleshooting
• Local-first storage with secrets kept in the system credential store
• Windows and macOS desktop bundles with channel-aware update flow

Supported Providers

TokenFlow currently focuses on these providers:

• OpenAI Codex
• Cursor
• Trae
• Anti-Gravity
• GitHub Copilot

Support differs by provider. Some providers use OAuth, some read local sessions, and some expose richer quota windows than others.

Screenshots

Dashboard	Providers

Logs	API Keys

Settings	About

Installation

Download

Download the latest build from the Releases page.

Release assets include:

• a versioned NSIS .exe installer
• a versioned .msi installer
• a versioned macOS .dmg bundle
• signed updater metadata for in-app updates

Build from source

1. Clone the repository:

git clone https://github.com/howarddong711/TokenFlow.git
cd TokenFlow

2. Install dependencies:

npm install

3. Start the desktop app in development mode:

npm run tauri -- dev

4. Build the frontend:

npm run build

5. Build release bundles for your current OS target:

npm run tauri -- build

macOS channel builds

TokenFlow supports both macOS GitHub distribution and Mac App Store channel policy.

• Initialize local updater signing key once:

npm run setup:updater-signing

Then export signing vars in your shell (especially TAURI_SIGNING_PRIVATE_KEY):

export TAURI_SIGNING_PRIVATE_KEY_PATH="$HOME/.tokenflow/updater/tokenflow-updater.key"
export TAURI_SIGNING_PRIVATE_KEY="$(cat "$TAURI_SIGNING_PRIVATE_KEY_PATH")"
export TAURI_SIGNING_PRIVATE_KEY_PASSWORD="<your-key-password>"

• Build macOS GitHub channel artifacts (in-app updater enabled):

npm run release:mac:github -- 0.1.4

• Build macOS App Store channel artifacts (in-app updater disabled):

npm run release:mac:mas -- 0.1.4