AI Usage

Choose what to show

Add AI Usage from the widget library’s System category. Open the widget, then its settings to choose Numbers, Rings, or Bars. The Track checkboxes enable providers, including ones you have not installed yet. Each enabled provider shows its install link and sign-in instructions below the checkbox. At least one must stay selected.

Track changes what the widget shows; it does not disconnect a provider or stop its integration. The tile shows the lowest remaining allowance across the provider’s main usage windows. Click it to see individual windows and reset countdowns. Additional Codex model limits appear in the details.

Setup instructions

In Customize, enable a provider under Track to see its installation link and sign-in steps. When no usage is available, Configure usage opens setup. Usage relies on local command-line tools (CLIs), so installing desktop apps alone does not set up every provider. Codex can also use its app’s bundled CLI; connected Claude supports a Desktop fallback.

After signing in, click Refresh usage. New widgets track all available providers. To add Grok to an existing widget, enable it under Track and follow the instructions shown there.

Show Grok usage

1. Install Grok CLI.
2. Run grok login in Terminal and sign in.
3. Click Refresh usage in Dockset. Grok loads automatically.

Dockset reads your included weekly or monthly allowance through Grok CLI’s existing login without sending a prompt. It refreshes every minute. Purchased credits, on-demand spending, and local Grok activity history are not shown.

Show Codex usage

Install the Codex CLI and run codex login in Terminal with your ChatGPT account. Dockset detects common installations, including the Codex app, and loads available usage automatically.

Dockset uses the existing local login to read your subscription limits. It does not start a task or use model tokens. API-key logins do not provide these ChatGPT subscription limits. The connection uses Codex’s local app server.

Show Claude usage

1. Install Claude Code and sign in by running claude in Terminal.
2. Open the AI Usage widget’s settings and click Connect Claude.
3. For Claude Code, send a message in a signed-in terminal session. Dockset receives any allowance windows Claude includes in its status-line updates.
4. If those updates have no fresh limits, sign in to Claude Desktop and click the widget’s refresh button. If macOS asks, allow Dockset to access Claude Safe Storage in Keychain.

Connect Claude installs a status-line hook in Claude Code’s settings and enables the Desktop fallback. An existing status-line command is preserved. Claude Code does not supply limits for every account or session; installing it alone is not enough. The fallback requires Claude Desktop installed and signed in, and reads the active Desktop organization’s five-hour and weekly limits.

Desktop login cookies are decrypted in memory and used only to request usage from claude.ai. They are not saved or logged by Dockset. Background checks never show Keychain permission prompts; use the refresh button if access is needed.

Why is there a Disconnect button only for Claude?

Disconnect Claude removes Dockset’s status-line hook, restores the previous command if it has not been changed since connecting, and disables the Desktop fallback. It does not sign you out of Claude. Codex and Grok use their existing CLI logins automatically without changing its settings, so they have no connection button. To hide a provider, use Track.

Understand refreshes and missing values

Codex refreshes once a minute while the integration is active, and when you use its refresh control. Last-known values remain visible during refreshes or temporary failures, with their original update time.

Claude Code updates when it sends status-line data. An idle session, activity on another device, or a project’s own status-line setting can leave those readings out of date. When the Claude Desktop fallback is in use, account limits refresh every five minutes or when you click refresh. You do not need to send a terminal message for Desktop refreshes, when using the Desktop fallback.

If Claude shows no limits, check that Desktop is signed in, then click refresh and allow Keychain access if requested. Claude Code alone may not provide allowance data for your login. A dash means the Claude allowance is unknown, expired, or more than ten minutes old. Open the widget to check its update time or error. Passing a reset time does not make Dockset assume your allowance is full again.

For Codex and Claude, the activity section counts sessions, tool calls, and tokens recorded on this Mac, including cached tokens. These local totals are separate from your account-wide allowance percentages.