← Plugins

Claude usage

Shows subscription usage windows, reset times and account details for Claude Code logins configured in Paseo.

$ clisbot plugin add lefos13/claude-accounts-usage
Report a bug
lefos13Sidebar0installs1e9f60c6986fSource
Claude usage screenshot 1

Claude usage adds a screen listing every Claude Code login Paseo is configured with, with the subscription usage each one has left. It reads the provider entries in Paseo's config file, so the list follows the claude provider and any provider that extends it, such as a second login with its own CLAUDE_CONFIG_DIR.

For each account the screen shows the session window, the weekly window, and any weekly limit scoped to a model or a surface, each with the percentage used and its reset time. Accounts show the email, organization, and plan Claude reports, and every card has its own refresh button. The screen refreshes itself every two minutes while it is open.

The plugin reads Paseo's config, Claude Code credentials from the macOS Keychain or a login's .credentials.json, and calls the Anthropic usage and profile endpoints at api.anthropic.com. On macOS the Keychain item is Claude Code-credentials for the default login and a Claude Code-credentials-<hash> item for a login with its own config directory.

Everything is read-only. The plugin never refreshes or rotates a token, never writes a credential file or the Keychain, and never sends a token to the Paseo client. An expired or missing login is shown with the command that signs it in again. Logins that use an API key, Bedrock, Vertex, Foundry, or a custom base URL are listed without usage, because they do not bill a Claude subscription.