Paperclip Agent Usage Plugin

Track AI provider usage quotas inside [Paperclip](https://github.com/paperclipai/paperclip) — dashboard widget, dedicated usage page, scheduled polling, and agent tools so agents can check remaining capacity before committing to an expensive call. npm package paperclip-plugin-agent-usage (v0.1.x). MIT.

Features

Dashboard widget — current Claude usage (session, weekly, per-model) with color-coded bars Full usage page — detailed view with history and reset times Agent tools — get-usage and get-usage-summary for self-throttle decisions Scheduled polling — refreshes usage on an interval (default 15 minutes) Auto-detection — reads Claude OAuth tokens from ~/.claude or the macOS Keychain Reset times — see when each quota window rolls over

Supported providers

| Provider | Method | | --- | --- | | Claude (Anthropic) | OAuth usage API · CLI fallback |

More providers are planned; see upstream CONTRIBUTING to add one.

Install

Install via your Paperclip instance Plugin Manager UI, or the plugins REST API:

http POST /api/plugins/install Content-Type: application/json

{ "packageName": "paperclip-plugin-agent-usage" }