Struct CursorSnapshot 

pub struct CursorSnapshot {
    pub plan: String,
    pub auto_pct: i32,
    pub api_pct: i32,
    pub total_pct: i32,
    pub unlimited: bool,
    pub on_demand_enabled: bool,
    pub on_demand_used_cents: Option<i64>,
    pub on_demand_limit_cents: Option<i64>,
    pub reset_at: Option<DateTime<Utc>>,
    pub cycle_start: Option<DateTime<Utc>>,
}

Cursor — the two included-usage pools the dashboard shows, from the undocumented cursor.com/api/usage-summary endpoint (the same one the dashboard’s own frontend calls), authenticated with the session token the Cursor IDE wrote to its local state.vscdb.

Since Cursor’s mid-2026 pricing, a plan’s included compute is split into two quota pools, each shown as a percentage: Cursor Models (Auto + Composer, autoPercentUsed) and Other Models (named / third-party, apiPercentUsed). Overflow past either pool falls to on-demand spend. Percentages are integers (rounded from the wire floats) to match the dashboard and every other vendor’s integer-percent convention; they can exceed 100 when a pool is over its included allowance.

Fields

plan: String

Membership label, title-cased from membershipType (e.g. “Ultra”).

auto_pct: i32

“Cursor Models” pool — Auto + Composer (autoPercentUsed, rounded).

api_pct: i32

“Other Models” pool — named / third-party (apiPercentUsed, rounded).

total_pct: i32

Overall included usage (totalPercentUsed, rounded) — the dashboard’s “you’ve used N% of your included total usage” headline.

unlimited: bool

true when the plan reports isUnlimited — the pools don’t cap and the percentages are not meaningful.

on_demand_enabled: bool

Whether on-demand (overage) spend is turned on (onDemand.enabled).

on_demand_used_cents: Option<i64>

On-demand spend in cents (onDemand.used), when Cursor reports it.

on_demand_limit_cents: Option<i64>

Configured on-demand spending limit in cents (onDemand.limit).

reset_at: Option<DateTime<Utc>>

End of the current billing cycle (billingCycleEnd) — when the pools reset.

cycle_start: Option<DateTime<Utc>>

Start of the current billing cycle (billingCycleStart), when the API sends it. With reset_at it gives the exact window length the pace projection needs; absent, no window length is reported at all.

Implementations

impl CursorSnapshot

pub fn cycle_window(&self) -> Option<Duration>

Length of the current billing cycle, but only when the API stated both ends and they are ordered. None otherwise — older responses and every snapshot cached before billingCycleStart existed omit the start, and a guessed month would reach a frontend as an exact window and be paced as one. window_secs is absent instead; the reset time still shows.

pub fn worst_pct(&self) -> i32

The binding pool — whichever is closest to (or furthest past) its cap. Drives the bar color and the single generic session_pct alias.

Trait Implementations

impl Clone for CursorSnapshot

fn clone(&self) -> CursorSnapshot

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for CursorSnapshot

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Eq for CursorSnapshot

impl PartialEq for CursorSnapshot

fn eq(&self, other: &CursorSnapshot) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for CursorSnapshot