sidekick-agent-hub 0.18.1 → 0.18.3
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 +22 -2
- package/dist/sidekick-cli.mjs +1141 -131
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -114,7 +114,7 @@ sidekick quota
|
|
|
114
114
|
Provider-aware quota and rate-limit display. The command auto-detects the active provider:
|
|
115
115
|
|
|
116
116
|
- **Claude Code**: Shows Claude Max subscription quota — 5-hour and 7-day windows with color-coded progress bars, projections, and reset countdowns. Includes a peak-hours summary line.
|
|
117
|
-
- **Codex**: Shows rate limits from
|
|
117
|
+
- **Codex**: Shows rate limits from Codex `token_count.rate_limits` events — primary and secondary windows with progress bars and reset countdowns. The default path is local-only: current workspace rollout, recent account-level rollouts, then the active account's cached snapshot. Add `--refresh` to explicitly refresh from Codex's usage API before falling back to local data.
|
|
118
118
|
- **OpenCode**: Prints an informational message (no rate-limit data available).
|
|
119
119
|
|
|
120
120
|
```
|
|
@@ -126,10 +126,30 @@ Subscription Quota
|
|
|
126
126
|
|
|
127
127
|
When quota data is unavailable, `sidekick quota` shows structured auth, rate-limit, network, server, or unexpected-failure messaging instead of a generic raw error. The dashboard Sessions panel also keeps a compact inline quota/rate-limit state visible instead of hiding the section entirely.
|
|
128
128
|
|
|
129
|
-
Use `--json` for machine-readable output. Use `--provider codex` to explicitly check Codex rate limits. Claude Code requires active credentials (read from the system Keychain on macOS, or `~/.claude/.credentials.json` on Linux/Windows). JSON output includes `failureKind`, `httpStatus`, and `retryAfterMs` on unavailable responses.
|
|
129
|
+
Use `--json` for machine-readable output. Use `--provider codex` to explicitly check Codex rate limits, and `--refresh` to opt in to a Codex usage API refresh. Claude Code requires active credentials (read from the system Keychain on macOS, or `~/.claude/.credentials.json` on Linux/Windows). JSON output includes `failureKind`, `httpStatus`, and `retryAfterMs` on unavailable responses.
|
|
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
|