paseo.cafe
All plugins

usage-sidebar

by RUIIIOVO

Provider plan usage in the Paseo sidebar: an openable panel plus an always-visible meter under the sidebar entry, read from Paseo's own usage data so the numbers match Settings → Usage.

v1.1.3 Requires Paseo >=0.8.0

Gallery

Install

paseo plugin add RUIIIOVO/paseo-usage-sidebar --ref a10505da7ffd3f385666f66cfaaa9ba1a2712a14

Git security status and fallback installation are pinned to commit a10505da7ffd.

From the plugin's README

Option A — From the app

  1. Open Paseo and go to Settings → Plugins.
  2. Turn on Enable plugins.
  3. Paste the repository URL into Plugin source: 
    https://github.com/RUIIIOVO/paseo-usage-sidebar.git
  4. Press Install plugin.

A successful install looks like this:

Option B — From the command line

paseo plugin add RUIIIOVO/paseo-usage-sidebar

README

Paseo Usage Sidebar 📊

💡 Overview

Paseo Usage Sidebar is an elegant usage monitoring plugin designed for Paseo. It seamlessly integrates AI provider quotas and consumption tracking directly into your sidebar, featuring pinned mini progress bars and an expandable detailed panel to keep your usage visible at a glance.

Zero configuration required—it reads Paseo's own provider.usage.list, so the numbers always agree with Settings → Usage. No API keys, no vendor CLI, no second polling path.

✨ Features

  • 📊 Pinned Mini Meters: Compact progress bars embedded right below the sidebar item for effortless quota monitoring without page switching. (Desktop and web only; the panel works everywhere.)
  • 🔍 Expandable Detail Panel: One-click access to a dashboard showing provider quotas, reset schedules, balances, and status.
  • ⚡ Zero Setup & Live Sync: Refreshes every 60 seconds, and on demand from Refresh—no manual API key entry or configuration.
  • 🎛️ Pin, Hide & Reorder: Choose exactly which quota windows live in the sidebar, and drag them into the order you want.
  • 🎨 Native Look & Feel: Follows all seven built-in themes, picking up a theme switch without a reload.
  • 🌐 i18n Ready: Localized into all nine languages Paseo ships—English, Simplified Chinese, Arabic, Spanish, French, Japanese, Korean, Portuguese (Brazil), and Russian.

📸 Preview

Pinned Mini Meter Expandable Detail Panel
Light
Dark

🚀 Quick Start

Requires Paseo 0.8.0 or later. Paseo 0.7 and earlier cannot load this plugin.

Installation

Option A — From the app

  1. Open Paseo and go to Settings → Plugins.
  2. Turn on Enable plugins.
  3. Paste the repository URL into Plugin source: 
    https://github.com/RUIIIOVO/paseo-usage-sidebar.git
  4. Press Install plugin.

A successful install looks like this:

Option B — From the command line

paseo plugin add RUIIIOVO/paseo-usage-sidebar

Usage

  • Quick Glance: The sidebar shows a mini meter for every pinned quota window, directly under the Plan usage entry.
  • Detailed View: Pick Plan usage in the sidebar, or run Open plan usage from the Command Center (Cmd/Ctrl + K).
  • Reorder & Customize: Every window in the panel carries a + / − button that pins it to, or hides it from, the sidebar. Drag rows in the Sidebar order block to change the order the meter paints.

🔄 Updating

Update with:

paseo plugin update usage-sidebar

🤝 Contributing

Issues and Pull Requests are welcome—see CONTRIBUTING.md for what to run and how commits are written. If you find this plugin helpful, please consider giving it a ⭐️.

📄 License

This project is licensed under the MIT License.

Scanned 15 Oct 2026, 12:35 UTC from RUIIIOVO/paseo-usage-sidebar.