sidekick-agent-hub 0.19.3 → 0.21.0

package/README.md

@@ -6,6 +6,16 @@ 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 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`.
@@ -37,7 +47,7 @@ If `sqlite3` is missing or not executable in the current shell environment, Side
 
 ```bash
 sidekick dashboard [options]
-sidekick tasks|decisions|notes|stats|quota|status|account|handoff|search|context [options]
+sidekick tasks|decisions|notes|stats|quota|status|account|handoff|search|context|extract [options]
 ```
 
 The standalone commands open the dashboard directly to a specific panel or run a one-shot query. All accept `--project` and `--provider` flags.
@@ -87,6 +97,38 @@ Global flags `--project` and `--provider` also apply.
 
 You can also press `r` in the TUI dashboard to generate a report for the current session.
 
+## Extract Session Assets
+
+```bash
+sidekick extract [options]
+```
+
+Pull actionable assets from recent Claude Code and Codex sessions for exactly the current project directory: URLs, validated file paths, commands the agent suggested for you to run, and plan-mode plans. Text output is grouped by type and labels each item with its source agent; `--json` returns the same grouped shape plus `inChat` and per-item provenance for scripts; `-i` opens an interactive picker where Enter opens URLs and copies other assets.
+
+This feature was contributed by [@B33pBeeps](https://github.com/B33pBeeps) (Juan Fourie) and adapted from his MIT-licensed [`trawl`](https://github.com/B33pBeeps/trawl) project.
+
+| Flag | Description |
+|------|-------------|
+| `--type <types>` | Comma list: `url`, `path`, `command`, `plan` (aliases: `urls`, `files`, `cmds`, `plans`) |
+| `--limit <n>` | Positive integer maximum items per type |
+| `-i`, `--interactive` | Interactive picker with copy/open actions |
+
+Global flags `--project`, `--provider`, and `--json` also apply. `--provider claude-code` scopes to Claude Code, `--provider codex` scopes to Codex, and `auto` reads both. Invalid `--type` or `--limit` values fail fast with a clear error. OpenCode extraction is not supported yet.
+
+```bash
+# Grouped text output
+sidekick extract
+
+# URLs and file paths only
+sidekick extract --type url,path
+
+# JSON for scripts
+sidekick extract --limit 10 --json
+
+# Interactive picker
+sidekick extract -i
+```
+
 ## API Status
 
 ```bash
@@ -130,6 +172,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. Each provider degrades independently — if one provider's quota can't be fetched, its error is shown inline and the other still renders (the command never aborts on a single provider's failure). `--all --json` emits a `{ claude, codex }` payload for dashboards and automation.
+
 ### Quota History
 
 ```bash
@@ -162,14 +206,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
 
@@ -273,7 +320,7 @@ Override with `--provider claude-code`, `--provider opencode`, or `--provider co
 
 ## See Also
 
-**[sidekick-shared](https://www.npmjs.com/package/sidekick-shared)** — the shared data access library used by this CLI. Published as a standalone npm package for building custom tools on Sidekick session data — types, parsers, providers, event aggregation, model pricing, and more. Install with `npm install sidekick-shared`.
+**[sidekick-shared](https://www.npmjs.com/package/sidekick-shared)** — the shared data access library used by this CLI. Published as a standalone npm package for building custom tools on Sidekick session data — types, parsers, providers, event aggregation, model pricing, actionable session-asset extraction, and more. Install with `npm install sidekick-shared`.
 
 **[Sidekick Docker](https://github.com/cesarandreslopez/sidekick-docker)** — the same TUI dashboard experience for Docker management. Monitor containers, Compose projects, images, and volumes from a keyboard-driven terminal. Install with `npm install -g sidekick-docker`.