All manual topics

AI widgets

Keep an eye on your coding assistants without leaving what you’re doing. Quai reads what these tools keep on your Mac, and asks the ones you already use for your usage.

AI Limits

Shows how much of each usage window is left, as numbers, rings or bars.

  • Codex is read through its own command line tool, and GitHub Copilot through the gh tool.
  • Claude Code and Antigravity CLI are read through a small status line bridge that Quai adds to their settings, keeping any status line you already use. Quai also asks Claude Code itself every two minutes, so sessions in VS Code and JetBrains count too.

When a limit runs out

When a window reaches 100%, the tile counts down to its reset: Claude back in 2:13:08. Hover the tile to see your other limits underneath. When the window resets, Quai pings, the tile turns green (Claude is back) and macOS shows a notification; click the tile to dismiss it, or just start using Claude again. If another window is still out (your weekly limit, say), the countdown waits for that one instead. Turn these off with Count Down When a Limit Runs Out and Notify When a Limit Is Back in the widget’s right-click menu or in Customize.

AI Activity

The tokens you used with one tool — Codex, Claude or Grok — for today, the last 7 or 30 days, or this month. Grok’s figures are estimates.

Claude, Codex, Kilo and Cursor Sessions

Lists your recent sessions and what each one is doing: working, waiting for you, or idle. Claude sessions show the conversation’s name, as on its tab in VS Code (the one you gave it with /rename, or the one Claude Code picked); turn off Show Conversation Names to see the project folder instead.

When a session finishes, the whole tile turns into Claude is ready (or Codex, Kilo or Cursor) with the conversation’s name for three seconds; click it to open the conversation. Turn it off with Announce When Claude Is Ready. You also get a notification; turn it off with Notify When Claude Is Waiting (or Codex, Kilo or Cursor) in the widget’s right-click menu. Claude and Codex Sessions also count down while your limit is out and say when it’s back, like AI Limits; turn that off with Limit Countdown and Return.

Click a session — on its line in the Dock or in the pane — to jump to it: a Claude Code chat opens in VS Code, and a session in Terminal or iTerm brings its tab forward (macOS asks once to let Quai control your terminal). A Kilo session opens its folder in VS Code.

Cursor Sessions follows the agent conversations of the Cursor app, by name. Besides a finished turn, it tells you when an agent stops to ask: a step waiting for your approval shows approve and a plan from Plan mode shows plan ready, each with its own notification. Click a conversation to bring its project’s Cursor window forward. While Cursor is closed, its conversations show as idle.

If notifications never show up, they’re probably turned off for Quai in System Settings › Notifications; the widget’s pane says so, with a button to turn them back on.