updated October 3, 2026
Install the Tokaware desktop app
On Windows, paste one command into PowerShell; on macOS and Linux, download the installer for your system and run it. Tokaware opens in its own window and keeps running in the tray. The installers are not code-signed yet, so on Windows and macOS a downloaded one asks you once to confirm.
Windows: one command in PowerShell
Open PowerShell (Start menu, type PowerShell), paste this and press Enter. It downloads the newest installer from downloads.tokaware.com, checks it against the release's checksum and runs it, with nothing to confirm; Tokaware opens when it is done.
irm https://tokaware.com/install.ps1 | iex
Download
Pick the file for your system on the releases page, which links each release's files at downloads.tokaware.com with SHA256SUMS.txt, the checksum of each to check a download against.
| System | File | How |
|---|---|---|
| Windows | tokaware-windows-x64.exe | Instead of the command above, run it: Tokaware installs for your user, gets a Start menu entry and opens. |
| macOS, Apple Silicon | tokaware-macos-arm64.dmg | Open it and drag Tokaware to Applications. |
| macOS, Intel | tokaware-macos-x64.dmg | Open it and drag Tokaware to Applications. |
| Linux | tokaware-linux-x64.AppImage | Make it executable (chmod +x), then run it. If it asks for FUSE, install libfuse2 or run it with --appimage-extract-and-run. |
The first start
- Windows: the PowerShell command asks nothing. A downloaded installer may be stopped by SmartScreen, saying it protected your PC: click More info, then Run anyway.
- macOS: after dragging the app to Applications, allow it once in System Settings, Privacy & Security, or run xattr -dr com.apple.quarantine "/Applications/Tokaware.app" in Terminal.
- Linux: nothing to confirm; the AppImage runs as it is.
Choose your first task
Home asks what you want to do first: see account limits, find and continue chats, or connect to a team. Pick one; Finish setup in the navigation brings you back if you leave halfway through.
For limits, use an existing Claude Code or Codex login if detected, or connect another provider account. Setup finishes when a fresh limits reading arrives. Your Tokaware sign-in is separate: it syncs your linked accounts and connected computers.
For chats, open a local conversation in Sessions without signing in. To read from your phone, choose Use these sessions on my phone, sign in to Tokaware, connect the computer and review its session content settings. Reading chats and allowing remote commands are separate permissions. Keep the computer awake with Tokaware running.
For a team, sign in with the account that accepted the invitation, select the team and review what its policy allows before connecting. Setup confirms the connection after the computer reports successfully.
What the app adds to the website
- It lives in the tray, so scheduled hellos and notifications keep going with the window closed, and the tray icon shows whether each provider has room.
- System notifications when a limit resets, crosses 90% or runs out, with quiet hours and muted accounts in Settings.
- Sessions reads recent Claude Code, Codex, Gemini CLI, OpenCode, Kilo Code and Cline chats from this computer. Computers contains its connection, access settings and local activity. Accounts & limits has separate tabs for usage, terminal logins and Claude desktop profiles; scheduled messages are under a saved terminal login's advanced options.
- Sessions → Transfer Claude chats guides you through choosing chats, reviewing Copy, Move or Link and sync, and opening the destination profile. Linked chats share conversation files on disk; use one profile at a time and make a chat independent before deleting shared files.
- Connect this computer to your team, so its coding sessions show on the Team page.
- It keeps itself up to date on Windows and Linux; on macOS it tells you when a new version is out.
Where it keeps its data
Everything is in one folder: %LOCALAPPDATA%\Tokaware on Windows, ~/Library/Application Support/Tokaware on macOS, ~/.local/share/tokaware on Linux, or the folder a copy installed as AI Cooldown already had. Settings, General, opens it. The key that encrypts saved logins in its local database is made on your computer the first time it runs.
see your exact numbers
Want the exact reset for your accounts?
Connect your Claude and Codex accounts to Tokaware and get every window with a live countdown, which one is limiting you, and which account to use next. Free for individuals, and it reads the same official usage endpoints the CLIs use.
Connect an accountQuestions people ask
- Do I need an account to use the desktop app?
- No. As a guest everything stays on your computer and the app talks to Claude and OpenAI directly. Signing in with your Tokaware account shows the same synced accounts as on the website.
- I had AI Cooldown installed. What happens to it?
- It keeps working, but it no longer updates itself. Install Tokaware, the same app under its new name, from this page: your accounts, sign-in, settings and history stay as they are. On Windows its installer replaces AI Cooldown, which still opens at login as Tokaware; on macOS, drag Tokaware to Applications, then move AI Cooldown to the Trash; on Linux, run the Tokaware AppImage in place of the old one.
- Port 3477 is taken. What now?
- Set the TOKAWARE_PORT environment variable to another port before starting the app. The window's storage is kept per address, so stick to one port.