{"id":"paseo-limits","repo":"ortschun/paseo-limits","url":"https://github.com/ortschun/paseo-limits","name":"paseo-limits","description":"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.","categories":["monitoring","productivity"],"platforms":[],"caveats":[],"images":["https://raw.githubusercontent.com/ortschun/paseo-limits/4c92092a1f42a39b84bc2c286c87901f436bd489/images/pill.png"],"health":{"manifestValid":true,"hasReadme":true,"hasLicense":true,"hasTests":false,"hasTypecheckScript":true,"updatedRecently":true},"scannedAt":"2026-09-15T07:11:48.187Z","addedAt":"2026-09-15T07:08:56Z","version":"0.1.1","security":{"status":"passed","blockingFindings":0,"advisoryFindings":0,"scannedAt":"2026-09-15T07:10:23.436Z","commit":"4c92092a1f42a39b84bc2c286c87901f436bd489"},"author":"Orcun Simsek","license":"MIT","paseoVersionRequirement":">=0.8.0","manifest":{"id":"paseo-limits","requirements":{"paseo":">=0.8.0"}},"repoMeta":{"stars":0,"defaultBranch":"main","pushedAt":"2026-09-15T01:58:51Z"},"owner":{"login":"ortschun","avatarUrl":"https://avatars.githubusercontent.com/u/1612171?v=4"},"installNotesHtml":"<pre><code class=\"language-bash\">paseo plugin add ortschun/paseo-limits\n</code></pre>\n<p>Plugins must be enabled on the daemon (<strong>Settings → Plugins → Enable plugins</strong>). Requires Paseo 0.8 or later.</p>\n<p>To install from a local checkout instead:</p>\n<pre><code class=\"language-bash\">git clone https://github.com/ortschun/paseo-limits\ncd paseo-limits &#x26;&#x26; npm install &#x26;&#x26; npm run typecheck\npaseo plugin install \"$PWD\"\n</code></pre>","limitationsNotesHtml":"<ul>\n<li><strong>Placement.</strong> 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.</li>\n<li><strong>Codex window naming.</strong> 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.</li>\n<li><strong>Providers.</strong> Only providers Paseo's quota fetcher supports report usage: Claude, Codex, and GLM at the time of writing. Other providers show \"No limits\".</li>\n<li><strong>Logos.</strong> Claude and OpenAI marks are bundled. Other providers get a small two-bar meter instead.</li>\n</ul>","readmeText":"# paseo-limits\n\nSubscription limits for the agent you're talking to, as a pill above the composer in [Paseo](https://paseo.sh).\n\nThe 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.\n\nThe pill follows the agent's provider. A Claude agent shows Claude limits, a Codex agent shows Codex limits, and nothing else.\n\n![The limits pill above the Paseo composer](images/pill.png)\n\n## Install\n\n```bash\npaseo plugin add ortschun/paseo-limits\n```\n\nPlugins must be enabled on the daemon (**Settings → Plugins → Enable plugins**). Requires Paseo 0.8 or later.\n\nTo install from a local checkout instead:\n\n```bash\ngit clone https://github.com/ortschun/paseo-limits\ncd paseo-limits && npm install && npm run typecheck\npaseo plugin install \"$PWD\"\n```\n\n## How it works\n\n- 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.\n- Polls every 2 minutes, plus a throttled refresh whenever the popover opens.\n- Client-only: no daemon subprocess, no RPCs, no filesystem or network access.\n- Works on desktop and mobile. Colors follow the active theme.\n\n## Limitations\n\n- **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.\n- **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.\n- **Providers.** Only providers Paseo's quota fetcher supports report usage: Claude, Codex, and GLM at the time of writing. Other providers show \"No limits\".\n- **Logos.** Claude and OpenAI marks are bundled. Other providers get a small two-bar meter instead.\n\n## Development\n\n```bash\nnpm install\nnpm run typecheck\npaseo plugin install \"$PWD\"      # first time\npaseo plugin reload paseo-limits # after edits\npaseo plugin logs paseo-limits\n```\n\n## License\n\nMIT\n"}