paseo.cafe
All plugins

paseo-limits

by ortschun

Subscription limits for the active agent's provider as a composer pill in Paseo: 5-hour and weekly usage at a glance, full breakdown on press.

v0.1.1 Requires Paseo >=0.8.0

Gallery

Install

paseo plugin add ortschun/paseo-limits --ref main

Security status covers commit 4c92092a1f42. This command tracks main. Refresh the listing before installing if the branch changed.

From the plugin's README

paseo plugin add ortschun/paseo-limits

Plugins must be enabled on the daemon (Settings → Plugins → Enable plugins). Requires Paseo 0.8 or later.

To install from a local checkout instead:

git clone https://github.com/ortschun/paseo-limits
cd paseo-limits && npm install && npm run typecheck
paseo plugin install "$PWD"

README

paseo-limits

Subscription limits for the agent you're talking to, as a pill above the composer in Paseo.

The pill shows the provider's logo and its rate-limit windows, e.g. 5h 18% · wk 16%. Press it for the full breakdown: every window as a bar, reset times, plan, and balances. When a window passes 70% a small amber dot appears on the logo; past 90% it turns red.

The pill follows the agent's provider. A Claude agent shows Claude limits, a Codex agent shows Codex limits, and nothing else.

Install

paseo plugin add ortschun/paseo-limits

Plugins must be enabled on the daemon (Settings → Plugins → Enable plugins). Requires Paseo 0.8 or later.

To install from a local checkout instead:

git clone https://github.com/ortschun/paseo-limits
cd paseo-limits && npm install && npm run typecheck
paseo plugin install "$PWD"

How it works

  • Usage comes from Paseo's own provider usage service (paseo.providers.listUsage()), the same source the context-window tooltip uses. No credentials or vendor calls in the plugin.
  • Polls every 2 minutes, plus a throttled refresh whenever the popover opens.
  • Client-only: no daemon subprocess, no RPCs, no filesystem or network access.
  • Works on desktop and mobile. Colors follow the active theme.

Limitations

  • Placement. Paseo plugins can't add to the composer's bottom row, so the pill lives in the track bar above the composer next to Tasks and Subagents.
  • Codex window naming. Paseo reports Codex's primary window as "Session" without its duration. The plugin classifies it by reset time: anything resetting more than six hours out is labeled weekly. Accounts whose API returns only one window show a single value.
  • Providers. Only providers Paseo's quota fetcher supports report usage: Claude, Codex, and GLM at the time of writing. Other providers show "No limits".
  • Logos. Claude and OpenAI marks are bundled. Other providers get a small two-bar meter instead.

Development

npm install
npm run typecheck
paseo plugin install "$PWD"      # first time
paseo plugin reload paseo-limits # after edits
paseo plugin logs paseo-limits

License

MIT

Scanned 15 Sep 2026, 07:11 UTC from ortschun/paseo-limits.