Back to guides
Agent usage

Agent Usage Setup

View account balances, plan quotas and reset times.

View account balances, plan quotas and reset times. Requires Redock Pro, a paired host, and App / Hook versions that support usage sources.

Set up a source

  1. Enable usage sync in Agent Settings → Usage, then open Usage sources and select a paired host. Choose its SSH connection if none is associated. Sources belong to the paired host.
  2. Codex and Claude Code need no added source: install their Hooks and sign in with official accounts on the host. Collection starts when usage is available. API-key or gateway modes may not expose official account quotas.
  3. For other services, select Add source. Under Authentication, enter either an API key or a host environment-variable name such as DEEPSEEK_API_KEY, not its value. Supported services can also reuse a local CLI login.
  4. Select Test on host, check the preview, then Save and enable. Testing neither enables the source nor uploads usage. Retest after editing.
  5. View results in Agent Updates → Usage, or use the usage shortcut at the top left of a conversation. Filter by host; use the card menu for reset reminders when a reset time is available.

Supported services and keys

Choose the provider or gateway that actually bills you, rather than relying on the Agent name. The official links help you obtain keys; no third-party sign-in inside Redock is required.

Service Data and credentials
DeepSeek Account balance; create or reuse a key in API Keys.
Kimi Code Coding quota; use a Kimi Code Console key or an existing host Kimi CLI login.
GLM / Z.ai Coding quota; obtain a key from BigModel or the Z.ai instructions. Match the account region.
MiniMax Legacy Coding Plan quota; use its plan key, following the credential guide. The newer Token Plan is not yet supported.
OpenRouter Current key usage and limit; use a model key from Keys, not a management key. An unlimited key does not mean unlimited account credit.
Moonshot Open-platform account balance; follow the API Keys guide. These keys are separate from Kimi Code plan keys.
Alibaba Coding Plan Plan quota, available for some accounts only. Obtain a plan-specific key using the official guide. If console login is required, this account cannot currently be queried; a pay-as-you-go key is not a replacement.

Existing host credentials

Service Setup
Volcengine Ark CLI Authenticate with the official CLI and confirm arkcli usage plan --format json works.
Grok Build Run grok login. This method does not query general xAI API credit.

Redock reuses host authentication without an App key field. Use the same host user for the CLI and Hook.

Gateways

Service Setup
New API Site URL + its model API key. No admin access token or user ID is needed.
sub2api Site URL + its model API key. Private deployments must expose the matching usage API.

Obtain the key from the site’s Tokens / API Keys page. Use a base address such as https://api.example.com, without /v1 or a chat endpoint. Public and LAN addresses require HTTPS; HTTP is allowed only for host loopback addresses.

Limits and troubleshooting

  • Updates take minutes. Host Agent activity triggers enabled sources. Added sources are typically queried every 5–15 minutes; separate uploads are at least 15 minutes apart. Idle hosts may not update. Pull to refresh reads the last synced data; check the card's timestamp.
  • Credentials stay on the host. Keys are sent over SSH, not Relay or iCloud. Environment variables must be visible to the Hook process; a temporary export in another terminal is insufficient. If unsure, enter the API key. Renew expired logins or keys, then test and save again.
  • Read the displayed unit. Account balances, key limits and plan quotas are distinct; New API quota is not automatically USD. Reset reminders require a real reset time.
  • Up to 6 added sources per host, plus built-in Codex / Claude Code. The same account on multiple hosts is shown separately. No historical billing or per-model token reports.
  • Agent support does not imply quota support. Configure the actual providers used by Pi, OpenCode or Oh My Pi. Antigravity quotas, custom scripts and arbitrary private protocols are not supported. On failure, check the SSH target, Hook version, key type and region. Unsupported responses are not treated as zero usage.

Try Redock while following this guide

Steer terminal coding agents on your own host, right from your phone.