sidekick-agent-hub 0.20.0 → 0.21.1

package/README.md

@@ -6,6 +6,17 @@ Full-screen terminal dashboard for monitoring AI agent sessions — standalone,
 
 Sidekick CLI reads from `~/.config/sidekick/` — the same data files the [VS Code extension](https://marketplace.visualstudio.com/items?itemName=CesarAndresLopez.sidekick-for-max) writes. Browse sessions, tasks, decisions, knowledge notes, mind maps, and more in an interactive terminal UI.
 
+## What's New
+
+- **`sidekick quota --provider zai`** — *estimated* z.ai Coding Plan quota (5-Hour / Weekly) derived from observed OpenCode traffic, with `--tier lite|pro|max|auto`. It's an estimate, not authoritative (z.ai has no usage API); see Quota & Rate Limits below.
+- **`sidekick extract`** — pull URLs, file paths, commands, and plans out of recent Claude Code and Codex chats, with `--json` and an interactive picker.
+- **`sidekick quota history`** — a 13-week, per-workspace, GitHub-style heatmap of session-limit utilization.
+- **`sidekick status` & `sidekick peak`** — one-shot Claude/OpenAI API health checks and a Claude peak-hours indicator.
+- **`sidekick account`** — manage multiple Claude Code and Codex accounts, with first-run auto-registration of your active credentials.
+- **Recent models & richer reports** — Claude Opus 4.8 and Fable 5 pricing/context, plus `report`/`dump` transcripts that interleave reasoning, tool calls, and narration.
+
+See the [full changelog](https://github.com/cesarandreslopez/sidekick-agent-hub/blob/main/CHANGELOG.md) for everything.
+
 ## Installation
 
 > **Note:** The npm package is `sidekick-agent-hub`, but the binary it installs is called `sidekick`.
@@ -147,7 +158,7 @@ Provider-aware quota and rate-limit display. The command auto-detects the active
 
 - **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.
 - **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.
-- **OpenCode**: Prints an informational message (no rate-limit data available).
+- **OpenCode / z.ai**: OpenCode has no native rate-limit data, but when it routes to a **z.ai Coding Plan** (GLM), `sidekick quota --provider opencode` auto-routes to an **estimated** z.ai quota (5-Hour / Weekly). Use `--provider zai` to request it explicitly and `--tier lite|pro|max|auto` to override the tier. The figure is an estimate, not authoritative — z.ai exposes no usage API, so utilization is derived from observed OpenCode traffic against provisional per-tier budgets, z.ai is observed-only (not a selectable inference provider) with no account management yet, and reset times are approximate unless a rate-limit error is trapped.
 
 ```
 Subscription Quota
@@ -162,6 +173,8 @@ Use `--json` for machine-readable output. Use `--provider codex` to explicitly c
 
 When multi-account is enabled, `sidekick quota` shows the active account email above the quota bars.
 
+Use `sidekick quota --all` to show Claude and Codex quota together in a single run (plus the estimated z.ai section when z.ai traffic is active). Each provider degrades independently — if one provider's quota can't be fetched, its error is shown inline and the others still render (the command never aborts on a single provider's failure). `--all --json` emits a provider-keyed payload for dashboards and automation.
+
 ### Quota History
 
 ```bash
@@ -178,7 +191,7 @@ Mon ··▒▒▓█▒░· ·░░·· ·▒▓
 Peak 92%  ·  Avg 38%  ·  Samples 612
 ```
 
-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.
+Flags: `--weeks <n>` (1-26, default 13), `--provider claude|codex|zai` (default all available, stacked), `--workspace <path>` (default `cwd`). `--json` emits a `{ workspaceId, weeks, providers, generatedAt }` payload — the same shape consumed by the VS Code dashboard's Quota History panel.
 
 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.
 
@@ -194,14 +207,17 @@ On first CLI startup, Sidekick auto-registers the active system Claude Code and
 
 | Flag | Description |
 |------|-------------|
-| `--provider <id>` | Provider: `claude-code` (default) or `codex` |
+| `--provider <id>` | Provider: `claude-code` (default), `codex`, or `all` |
 | `--add` | Save the currently signed-in account |
-| `--label <name>` | Label for the account (use with `--add`; required for Codex) |
+| `--login` | Sign in and save a **new** account via a provider-isolated login flow, without disturbing the active account until finalization |
+| `--label <name>` | Label for the account (required for Codex and `--login`; optional for Claude `--add`) |
 | `--switch` | Switch to the next saved account |
 | `--switch-to <id>` | Switch to a specific account by email, label, or ID |
 | `--remove <id>` | Remove a saved account by email, label, or ID |
+| `--launcher <name>` | Create an opt-in per-account terminal launcher for the active account |
+| `--auto-switch <pct\|off>` | Persist the auto-switch quota threshold (1–100), or `off` to disable. Continuous auto-switching runs in a long-running host such as VS Code |
 
-With no flags, lists all saved accounts and marks the active one. Use `--json` for machine-readable output.
+With no flags, lists all saved accounts and marks the active one. `--provider all` lists Claude and Codex accounts together. Use `--json` for machine-readable output (provider-keyed when `--provider all`).
 
 ## Dashboard Panels