Sundayable

Paseo Usage Remaining — Development skill for Claude Code

Development community

Paseo plugin: remaining Claude / Fable / Codex / Grok / Cursor usage above the composer.

How to install Paseo Usage Remaining

This entry records only its repository, not the path inside it, so there is no exact command to give. Open Sundayable/paseo-usage-remaining and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Paseo Usage Remaining does

Paseo plugin: remaining Claude / Fable / Codex / Grok / Cursor usage above the composer.

Alternatives in Development

  • Nexting — Remote control for Claude Code, Codex, Grok, and Cursor on Mac or PC 1.3k ★
  • Codenotch — A macOS app that pins usage limits from Claude Code, Cursor, Codex, and Antigravity to a screen edge 1.3k ★
  • Mcpx — MCPX 是运行在开发环境中的 MCP Runtime(网关) 370 ★

README

usage-remaining

A [Paseo](https://paseo.sh) plugin that shows how much AI usage you have **left** — right above the composer.

The original two-line display is preserved on Paseo Desktop, web, and compatible native clients:

  • 5H — provider logos, colored remaining percentages, and session reset times
  • WK — Claude, Fable, Codex, Grok, and Cursor (monthly) with their reset times

Green, yellow, and red percentages show remaining capacity. Refresh inline, or click for the full dashboard. On narrow web screens the reset labels and refresh button move out of the inline display; all providers still fit, and the dashboard has details.

On iOS, the colored two-row display stays above the input. Tap it to open all providers in a scrollable sheet. Cards show each provider’s logo and name, colored remaining capacity, and one reset label. Narrow screens stack the header above a 44px refresh button. The full dashboard uses the same responsive cards. Failed refreshes preserve the last values and show an error.

What it reads

Provider Source Notes
Claude (session + weekly + Fable weekly) Claude Code login (macOS Keychain / ~/.claude/.credentials.json / CLAUDE_CODE_OAUTH_TOKEN) Fable's model-scoped weekly limit is shown as its own entry
Codex Codex CLI login (~/.codex/auth.json) Windows classified by reported length; plans that report only a weekly window (e.g. Pro) show no Codex 5H entry
Grok Grok CLI login (~/.grok/auth.json) Supports unified-billing (weekly %) and legacy monthly credits
Cursor Cursor desktop / cursor-agent login Individual plans only — team-billed seats don't expose plan usage

Everything is read **locally and read-only**. No credentials are written, logged, or sent anywhere except each provider's own usage API.

Install

Requires Paseo **0.8.0 stable** on the daemon and client. Early 0.8 betas use an older composer API. The last revision for Paseo 0.7 is commit `8e4da65`.