sidekick-agent-hub 0.18.2 → 0.18.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -130,6 +130,26 @@ Use `--json` for machine-readable output. Use `--provider codex` to explicitly c
130
130
 
131
131
  When multi-account is enabled, `sidekick quota` shows the active account email above the quota bars.
132
132
 
133
+ ### Quota History
134
+
135
+ ```bash
136
+ sidekick quota history
137
+ ```
138
+
139
+ Renders a 13-week, GitHub-contributions-style heatmap of quota utilization for the current workspace. Each cell is one day; brightness encodes the peak utilization observed (`· ░ ▒ ▓ █` → ≤0% / <25% / <50% / <75% / ≥75%). Days that hit `available: false` render as a red `×`.
140
+
141
+ ```
142
+ Claude · 13 weeks · 41 day(s) with samples
143
+ Sun ·░▒▒▓█░░░ ·░░·· ·▒▒
144
+ Mon ··▒▒▓█▒░· ·░░·· ·▒▓
145
+
146
+ Peak 92% · Avg 38% · Samples 612
147
+ ```
148
+
149
+ Flags: `--weeks <n>` (1-26, default 13), `--provider claude|codex` (default both, stacked), `--workspace <path>` (default `cwd`). `--json` emits a `{ workspaceId, weeks, providers: { claude?, codex? }, generatedAt }` payload — the same shape consumed by the VS Code dashboard's Quota History panel.
150
+
151
+ History is stored at `~/.config/sidekick/quota-history/<workspaceId>/<provider>.jsonl` (mode `0600`, 60-second debounce, 91-day retention). The workspace id is `sha256(realpath)[0..16]`, so the same folder yields the same store whether sampled from the CLI or VS Code.
152
+
133
153
  ## Account Management
134
154
 
135
155
  ```bash