Tokaware

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.

SystemFileHow
Windowstokaware-windows-x64.exeInstead of the command above, run it: Tokaware installs for your user, gets a Start menu entry and opens.
macOS, Apple Silicontokaware-macos-arm64.dmgOpen it and drag Tokaware to Applications.
macOS, Inteltokaware-macos-x64.dmgOpen it and drag Tokaware to Applications.
Linuxtokaware-linux-x64.AppImageMake 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 account

Questions 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.

related