diff --git a/CHANGELOG.md b/CHANGELOG.md index b875a43..e0d9598 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,5 +1,23 @@ # Changelog +## 0.3.0 + +### Features + +- Added **Since last commit** usage window: plan % burned while the working tree is dirty, re-anchored on every HEAD move (automatic; no manual reset). Hidden when the tree is clean or the workspace is not a git repo +- Added **This branch** usage window: plan % while a feature branch is checked out, with active-time pause/resume so spend on other branches does not inflate the counter (hidden on the default branch) +- Optional status bar modes `sinceLastCommit` and `thisBranch` +- **Last hour** usage now persists across IDE reloads when sampling continued in the prior hour + +### UI + +- Timestamps use 24-hour format +- Git-aware windows wait for the built-in git API before rendering (no flicker / stale placeholders on startup) + +### Docs + +- Landing page and README updated for the git-aware windows + ## 0.2.0 ### Features diff --git a/README.md b/README.md index d9428d7..f50bdbd 100644 --- a/README.md +++ b/README.md @@ -2,10 +2,10 @@ **See your Cursor plan usage without leaving the editor.** -[Website](https://codykoinabox.github.io/cursor-plan-usage/) · Live **Cursor Models** and **Other Models** percentages in a dockable sidebar and status bar chip — so you always know where you stand in the billing cycle. +[Website](https://codykoinabox.github.io/cursor-plan-usage/) · Live **Cursor Models** and **Other Models** percentages in a dockable sidebar and status bar — plus git-aware windows for spend since your last commit or while you’re on a feature branch. #### You can easily install the extension through the Extensions tab inside Cursor: -image +Installing Cursor Plan Usage from the Extensions tab [Install on Open VSX](https://open-vsx.org/extension/CodyKoInABox/cursor-plan-usage) · [Report an issue](https://github.com/CodyKoInABox/cursor-plan-usage/issues) @@ -15,15 +15,17 @@ ## Features - **Sidebar panel** — CM / OM usage at a glance in the activity bar -- **Status bar chip** — `CM n% · OM n%` always visible while you work, or your **Usage so far** deltas instead +- **Status bar chip** — `CM n% · OM n%` cycle totals, or deltas for **Usage so far** / **Since last commit** / **This branch** - **Billing cycle** — progress through the period, end time, and a simple projection -- **Session deltas** — last-hour and IDE-session usage while the extension is sampling -- **Usage so far** — custom resettable window that persists across reloads; track any period you care about. Auto-resets when a new billing cycle starts +- **Session deltas** — last-hour usage persists across reloads; IDE-session usage is since this Cursor window opened +- **Usage so far** — resettable window that persists across reloads; auto-resets on a new billing cycle +- **Since last commit** — plan % burned while the working tree is dirty; resets on each commit. Hidden when the tree is clean +- **This branch** — plan % while a feature branch is checked out; pauses on `main` / other branches and restores when you return. Hidden on the default branch - **Smart refresh** — updates on focus and AI activity; pauses when Cursor is unfocused ## UI Example -Screenshot_1509 +Plan Usage sidebar showing Cursor Models, Other Models, and git-aware usage windows ## Cursor only @@ -66,7 +68,7 @@ After install, open the **Plan Usage** icon in the activity bar, or run **Plan U | --- | --- | --- | | `cursorPlanUsage.pollIntervalSeconds` | `0` | Idle poll interval (seconds) while focused. `0` = adaptive (30s burst for 2 min after AI activity, then 3 min). Polling pauses while unfocused. | | `cursorPlanUsage.refreshOnAiActivity` | `true` | Refresh when Cursor’s local AI tracking DB updates | -| `cursorPlanUsage.statusBarMode` | `absolute` | `absolute` shows cycle totals (`CM 45% · OM 20%`); `usageSoFar` shows deltas since your last Reset (`CM +4% · OM +2%`) | +| `cursorPlanUsage.statusBarMode` | `absolute` | `absolute` shows cycle totals (`CM 45% · OM 20%`); `usageSoFar` shows deltas since your last Reset (`CM +4% · OM +2%`); `sinceLastCommit` shows deltas since HEAD while dirty; `thisBranch` shows deltas while the current feature branch is checked out | | `cursorPlanUsage.apiBaseUrl` | `https://api2.cursor.sh` | Dashboard API base URL | There is no `sessionToken` setting — use the Set / Clear Session Token commands instead. @@ -77,7 +79,7 @@ There is no `sessionToken` setting — use the Set / Clear Session Token command | --- | --- | | **No token found** | Sign in to Cursor, or run **Plan Usage: Set Session Token** with a valid session token / JWT. | | **401 / unauthorized** | Re-sign into Cursor, or set a fresh token via **Plan Usage: Set Session Token**. | -| **Remote-SSH / WSL** | The extension runs in the **local** Cursor UI and uses the local session DB. If usage looks wrong in a remote window, use a local window or set a session token override. | +| **Remote-SSH / WSL** | The extension runs in the **local** Cursor UI and uses the local session DB. If usage looks wrong in a remote window, use a local window or set a session token override. **Since last commit** / **This branch** need the built-in git API and stay hidden when it is unavailable in remote UI hosts. | ## Notes diff --git a/docs/assets/sidebar.png b/docs/assets/sidebar.png index b82b176..7cbf8d9 100644 Binary files a/docs/assets/sidebar.png and b/docs/assets/sidebar.png differ diff --git a/docs/index.html b/docs/index.html index 0938cf3..c56f5f7 100644 --- a/docs/index.html +++ b/docs/index.html @@ -6,7 +6,7 @@ Cursor Plan Usage @@ -37,9 +37,11 @@ Features Install GitHubGitHub @@ -47,40 +49,60 @@
-

Cursor Plan Usage

+ +

Cursor Plan Usage

See your Cursor plan usage without leaving the editor.

Live Cursor Models and Other Models percentages in a dockable - sidebar and status bar chip — so you always know where you stand in - the billing cycle. + sidebar and status bar — plus git-aware windows for spend since your + last commit or while you’re on a feature branch.

Plan Usage sidebar showing Cursor Models and Other Models percentages +

+ Captured with + Rustshot +

What you get

-

Everything you need to track plan burn without leaving Cursor.

+

+ Cycle totals, custom windows, and git-aware deltas — without leaving + Cursor. +