# docs/user/usage.md · screen/t3code-personal [View on GitCafe](https://git.cafe/screen/t3code-personal/blob/d4a33457cb0da797728f4846a9da8592d7d81d36/docs/user/usage.md) Repository: [screen/t3code-personal](https://git.cafe/screen/t3code-personal) Visibility: public Requested revision: d4a33457cb0da797728f4846a9da8592d7d81d36 Requested commit: d4a33457cb0da797728f4846a9da8592d7d81d36 Commit: d4a33457cb0da797728f4846a9da8592d7d81d36 Blob: cb6cb1a761a514f73cdcd3671844475f020bf71c Size: 6419 bytes [Immutable source](https://git.cafe/screen/t3code-personal/blob/d4a33457cb0da797728f4846a9da8592d7d81d36/docs/user/usage.md?format=markdown) ``` # Usage and limits ## Understand your usage **Usage** combines Codex, Claude Code, and Grok Build session history from your connected environments. It shows token use, cache savings, model breakdowns, and estimated API-equivalent cost. These estimates are not your subscription bill. Totals depend on the history available on each server. Grok turns without a saved completed-turn record are missing from the totals. Usage includes each configured account's history, including disabled accounts. Custom homes follow the account's home setting or its `CODEX_HOME`, `CLAUDE_CONFIG_DIR`, or `GROK_HOME` environment variable. Use absolute paths or `~/` paths in the account's environment settings; relative environment paths depend on each project's working directory and cannot be reliably discovered by Usage. Accounts sharing a history directory count once. On web and desktop, use the environment dropdown to filter costs, tokens, and limits. All environments are selected by default. The dropdown shows which environments are still scanning; results appear as each one responds. If recent work is missing or a new model shows no cost, refresh to rescan session history and update model pricing. ## Set custom model prices On web or desktop, open the environment dropdown on **Usage**, then choose **Model prices** to add, edit, or reset a model's estimated price. **Apply to** starts with your current Usage filter; choose all environments or select individual destinations. Enter the exact model ID and USD rates per million input and output tokens. You can enter any model ID, including models without public pricing. Cache read and cache write rates are optional and use the input rate when blank. Enter `0` for tokens that are free. Saved prices replace automatic pricing for all of that environment's history and are shared with clients connected to it. When environments have different prices, cells show **Mixed**. Edit rates directly in the table, then choose **Save changes** to apply all edited rows. Untouched cells keep each environment's rate. Select one environment to inspect its prices. **Reset to automatic** marks a model's override for removal when you save; you can undo it before saving. Each destination reports whether the change saved. Offline or unavailable environments are marked **Not saved**. Reconnect them and choose **Retry failed saves** to finish the same change without writing again to environments that already saved. Changes are not queued after you close the dialog. ## Track subscription limits **Usage → Limits** pools every subscription account it can see per provider, so with several Codex or Claude accounts across your environments and hubs you read one number per window rather than a list. Each window card shows how much of the pool is left and a bar with one segment per account, kept in the same column across windows. Accounts are ordered by their 5-hour reset, soonest first, or by the first available window when no account reports a 5-hour limit. A gap means the account does not report that window. When the provider reports reset times, the card also says when the next reset lands and how much it hands back. The hatched part of a segment is what that reset restores. Tap a segment or account row for the account's plan, where it is signed in, and its reset time. On web, you can hover too. Codex and Claude accounts with banked reset credits show a ticket count and the **Use reset** action in the account details. Claude resets are not available when the server runs on macOS, where Claude keeps its login in the Keychain. On narrow screens, numbered rows below the bar show each account's quota, countdown, and credits. Tap a row to open its details. The same account signed in on more than one environment, or reported by a hub as well, counts once. Filter with the environment dropdown to see what a single machine has. Opening Limits checks the selected connected environments automatically. Each client waits at least five minutes between automatic checks of an environment, including after a failed check. If a window still looks stale, refresh Limits to re-check every provider and hub. Pick `/usage-limits` from the composer's command menu, or send it as a message, to check the current model's limits without leaving the conversation. The result opens above the composer and closes when you dismiss it or send your next message. It uses the same snapshot as **Usage → Limits**, so it does not run the agent or refresh anything. The command is offered only for providers that appear under **Usage → Limits**. OpenCode Go reports its session, weekly, and monthly allowance when OpenCode runs locally in the environment. T3 cannot report limits for external OpenCode servers because their credentials belong to the remote server. Cursor reports its monthly allowance, including separate Auto and API usage, using a file-based CLI login or `CURSOR_AUTH_TOKEN`. Cursor's default macOS keychain login does not currently report limits. On macOS, use `AGENT_CLI_CREDENTIAL_STORE=file` when signing in and in the provider's environment to use a file-based login. Grok reports the remaining subscription allowance and reset time for its current billing period after signing in with `grok login`. Explicit `XAI_API_KEY` connections and custom authentication or endpoint configurations do not report subscription limits. API-key accounts may not report subscription limits. This also applies to Claude connections using a proxy through `ANTHROPIC_AUTH_TOKEN`. ## Connect a CLIProxyAPI hub To see pooled accounts, open **Settings → Providers → Usage providers → Add hub**. Choose the environment that will connect to the hub and enter its URL and management key. The accounts appear under **Usage → Limits**. Codex accounts show banked reset credits; select an account and choose **Use reset** to redeem one. No hub plugin is required. This connection supplies usage information; configure the provider separately to send agent requests through the hub. Remove the hub from the same settings section when you no longer need it. ## Subscription usage widget Add **Subscription usage** from your iOS or Android widget gallery to see remaining Codex and Claude quotas. Tap it to open **Usage → Limits**. On iOS, use **Edit Widget** to choose Session, Weekly, or both for each provider. Reopen T3 to refresh expired readings. ```