copilot-session-usage 0.1.0__tar.gz → 0.2.1__tar.gz

copilot_session_usage-0.2.1/.github/guidelines/knowledge-base.guidelines.md

@@ -0,0 +1,86 @@
+---
+applyTo: "knowledge/**/*.md"
+description: "The minimal rules a coding agent must follow to maintain the OKF knowledge bundle in knowledge/."
+---
+
+# Knowledge Base Maintenance Guidelines
+
+`knowledge/` is an [OKF](https://github.com/gsemet/okf-schema) bundle. Each `.md`
+file has a `type` in its frontmatter that maps to a schema in `_schema/`. This
+document is the strict minimal rule set for maintaining it correctly.
+
+## 1. Choose the right type
+
+| You want to record… | type | Folder | Nature |
+|---------------------|------|--------|--------|
+| A stable idea / "what is this?" | `Concept` | `concepts/` | Explanatory |
+| How an object is composed / works | `Structure` | `structures/` | Descriptive |
+| A standard or convention (agreed with humans) | `Principle` | `principles/` | Normative |
+| A step-by-step procedure to perform | `Playbook` | `guides/` | Procedural |
+| Exact values, fields, or lookup tables | `Reference` | `reference/` | Lookup |
+| What you observed/believed at time T | `Finding` | `findings/` | Empirical, dated |
+| A reusable procedure to test a claim | `Experiment` | `experiments/` | Template, run 1–2× |
+
+Rules of thumb:
+
+- Document only what is **non-trivial** for coding agents. Do not paraphrase code
+  or existing docs — link instead.
+- Keep each file focused and concise, important information first.
+- Findings and Experiments are the empirical layer; the other five are the stable
+  layer. Agents dump Findings freely; stable docs are promoted deliberately by the
+  `consolidate-knowledge-base` skill — never dumped ad hoc.
+
+## 2. Required frontmatter
+
+All documents (except `index.md` and `log.md`) require:
+
+```yaml
+type: <one of the types above>   # must match the const in _schema/<Type>.schema.yaml
+title: Human-Readable Title       # non-empty
+description: Short summary.        # non-empty
+tags: [keyword]                    # optional but encouraged
+timestamp: 2026-07-02T00:00:00Z   # ISO 8601 (YYYY-MM-DDTHH:MM:SSZ)
+```
+
+Type-specific required fields:
+
+- **Finding**: also `timestamp`, `confidence` (`low|medium|high`), and `context`
+  (what you believed and the scope you actually tested).
+- **Experiment**: also `hypothesis` and `steps`.
+
+## 3. Finding immutability & contradictions
+
+- A Finding's **body and claim are frozen** once written. Never reword or delete.
+- To correct a Finding, write a NEW Finding with `contradicts: [<old-id>]` or
+  `supersedes: [<old-id>]`.
+- The only permitted edits to an existing Finding are the lifecycle fields
+  `status` (`contradicted|superseded`), `contradicted_by`, `superseded_by`,
+  appended by the `consolidate-knowledge-base` review.
+- Promotion of converged Findings into Concept/Structure/Principle is done by
+  `consolidate-knowledge-base` with human confirmation — Principles are always
+  agreed with humans.
+
+## 4. Skills
+
+- **`record-finding`** (fast, non-interactive): dump one Finding after an
+  investigation or debugging session.
+- **`consolidate-knowledge-base`** (interactive, human-confirmed): detect
+  contradictions, mark findings, propose Experiments, propose promotions.
+
+## 5. Validate before commit
+
+```bash
+just knowledge-lint          # auto-format frontmatter + rebuild index
+just knowledge-validate      # 0 errors, 0 warnings required
+just knowledge-lint-check    # verify no pending format changes
+```
+
+Pre-commit checklist:
+
+- [ ] Correct `type` and folder for the information recorded.
+- [ ] Required frontmatter present and valid.
+- [ ] No Finding body was reworded or deleted.
+- [ ] All three commands above pass (also covered by `just preflight`).
+
+Add a dated entry to `knowledge/log.md` for significant changes. Use plain
+ISO-8601 date headings; avoid parenthetical annotations (they trigger warnings).

copilot_session_usage-0.2.1/.github/skills/consolidate-knowledge-base/SKILL.md

@@ -0,0 +1,68 @@
+---
+name: consolidate-knowledge-base
+description: 'Interactively review the OKF knowledge base to detect contradictions between Findings, mark contradicted/superseded Findings, propose Experiments to resolve open questions, and propose promotions of converged Findings into stable Concept/Structure/Principle documents. Every mutation is confirmed by a human before it is written. Use periodically or after a batch of recorded Findings.'
+---
+
+# consolidate-knowledge-base
+
+Turn a pile of dated Findings into consolidated, trustworthy knowledge — without
+ever rewriting history. This skill is **interactive**: it proposes, the human
+confirms, then it writes.
+
+## When to use
+
+- After a batch of Findings has been dumped by `record-finding`.
+- Periodically, to keep the empirical layer coherent with the stable layer.
+- When you suspect two findings disagree.
+
+## Guardrails
+
+- NEVER edit or delete a Finding's body. Only append lifecycle frontmatter
+  (`status`, `contradicted_by`, `superseded_by`).
+- NEVER promote to a Principle without explicit human confirmation — principles
+  are agreed with humans.
+- Ask before every write, using `vscode_askQuestions`.
+
+## Procedure
+
+### 1. Scan
+Read `knowledge/findings/`, plus `principles/`, `structures/`, `concepts/`.
+Build a map of claims, tags, and existing `contradicts`/`supersedes` links.
+
+### 2. Detect contradictions
+Identify pairs where a newer Finding disagrees with an older Finding, or where a
+Finding conflicts with a Principle/Structure/Concept. Present each candidate
+contradiction to the human for confirmation.
+
+### 3. Mark (on confirmation)
+For each confirmed contradiction, append metadata-only fields:
+- On the newer finding: `contradicts: [<old-id>]` (if not already present).
+- On the older finding: `status: contradicted` and `contradicted_by: [<new-id>]`.
+Use the same pattern with `supersedes`/`superseded_by` for replacements.
+The body of both files stays untouched.
+
+### 4. Propose Experiments
+For unresolved or low-confidence contradictions, propose a new `Experiment`
+document (hypothesis, steps, expected_signals, `max_runs: 1–2`) that would
+settle the question. Write it to `knowledge/experiments/` only on confirmation.
+
+### 5. Propose promotions
+When several Findings converge on a stable truth, propose promoting the insight
+into the stable layer:
+- "how it works" → `Structure` in `structures/`
+- "the idea" → `Concept` in `concepts/`
+- "the standard/convention" → `Principle` in `principles/` (always human-agreed)
+Link the promoted doc back to its supporting findings (`supported_by` /
+`related_concepts`). Write only on confirmation. Findings remain untouched.
+
+### 6. Validate
+```bash
+just knowledge-lint
+just knowledge-validate
+```
+Both must pass before finishing.
+
+## Output
+
+A short chat summary: contradictions found and marked, experiments proposed,
+promotions made, and any open questions left for a future run.

copilot_session_usage-0.2.1/.github/skills/record-finding/SKILL.md

@@ -0,0 +1,62 @@
+---
+name: record-finding
+description: 'Dump a single empirical Finding into the OKF knowledge base after an investigation or debugging session. Fast and non-interactive. Records what you truthfully observed and believed at this moment, with confidence and context, as an immutable dated note under knowledge/findings/. Use after diagnosing a bug, verifying behavior, or discovering something non-trivial worth remembering.'
+---
+
+# record-finding
+
+Record ONE Finding: a dated, empirical, falsifiable note of what you observed and
+believed right now. Findings can later be wrong — that is fine. Be truthful about
+the moment, not about eternal truth.
+
+## When to use
+
+- You just finished an investigation, debugging session, or verification.
+- You learned something non-trivial about how the external world (VS Code,
+  Copilot, pricing, logs) behaves.
+- You want to hand off "what I found and believed" for later consolidation.
+
+Do NOT use this to record standards/conventions (that is a Principle), how an
+object is composed (Structure), or a stable idea (Concept). Those are promoted
+deliberately by `consolidate-knowledge-base`, not dumped.
+
+## Procedure
+
+1. Write exactly one file to `knowledge/findings/<slug>.md` where `<slug>` is a
+   short hyphenated summary of the claim.
+2. Use this frontmatter (all listed fields are required):
+
+   ```yaml
+   ---
+   type: Finding
+   title: Short claim as a title
+   description: One-sentence summary of the finding.
+   tags: [relevant, keywords]
+   timestamp: <ISO-8601 UTC, e.g. 2026-07-02T14:30:00Z>
+   confidence: low | medium | high
+   context: >-
+     What you believed and the situation at the time — including assumptions
+     that may later prove wrong, and the scope you actually tested.
+   ---
+   ```
+
+3. In the body, state plainly: what was observed, why it matters, and the
+   caveats / limits of what you verified.
+4. If this finding contradicts or replaces an earlier one, add
+   `contradicts: [<finding-id>]` or `supersedes: [<finding-id>]`. Do NOT edit the
+   older finding — the `consolidate-knowledge-base` skill handles backlinks.
+5. If a run of an Experiment produced this finding, add `derived_from: <experiment-id>`.
+
+## Immutability
+
+Once written, never reword or delete a finding's body. This is enforced by the
+`Findings Are Immutable` principle. Corrections happen by writing a NEW finding.
+
+## Validate
+
+```bash
+just knowledge-lint
+just knowledge-validate
+```
+
+Both must pass. Do not run `consolidate-knowledge-base` here — dumping stays fast.

{copilot_session_usage-0.1.0 → copilot_session_usage-0.2.1}/.github/workflows/ci.yml

@@ -43,6 +43,7 @@ jobs:
         with:
           files: ./coverage.xml
           fail_ci_if_error: false
+          token: ${{ secrets.CODECOV_TOKEN }}
 
   cross-platform:
     runs-on: ${{ matrix.os }}

copilot_session_usage-0.2.1/.readthedocs.yaml

@@ -0,0 +1,24 @@
+# Read the Docs configuration file
+# See https://docs.readthedocs.io/en/stable/config-file/v2.html for details
+
+version: 2
+
+build:
+  os: ubuntu-24.04
+  tools:
+    python: "3.13"
+  jobs:
+    post_checkout:
+      - git fetch --tags
+    pre_build:
+      - uv run cz changelog
+
+sphinx:
+  configuration: docs/source/conf.py
+
+python:
+  install:
+    - method: uv
+      command: sync
+      groups:
+        - dev

copilot_session_usage-0.2.1/CHANGELOG.md

@@ -0,0 +1,13 @@
+## Unreleased
+
+## v0.2.0 (2026-07-02)
+
+### Fix
+
+- bad cost compuation for Opus 4.8
+
+## v0.1.0 (2026-07-02)
+
+### Feat
+
+- initial implementation

{copilot_session_usage-0.1.0 → copilot_session_usage-0.2.1}/PKG-INFO

@@ -1,9 +1,9 @@
 Metadata-Version: 2.4
 Name: copilot-session-usage
-Version: 0.1.0
+Version: 0.2.1
 Summary: Usage and cost analytics for GitHub Copilot and Copilot-CLI session logs
 Project-URL: Homepage, https://github.com/gsemet/copilot-session-usage
-Project-URL: Documentation, https://copilot-session-usage.readthedocs.io
+Project-URL: Documentation, https://copilot-session-usage.readthedocs.io/en/stable/
 Project-URL: Repository, https://github.com/gsemet/copilot-session-usage
 Project-URL: Issues, https://github.com/gsemet/copilot-session-usage/issues
 Author-email: Gaetan Semet <gaetan@xeberon.net>
@@ -20,6 +20,7 @@ Description-Content-Type: text/markdown
 [![Coverage](https://img.shields.io/codecov/c/github/gsemet/copilot-session-usage)](https://codecov.io/gh/gsemet/copilot-session-usage)
 [![PyPI](https://img.shields.io/pypi/v/copilot-session-usage)](https://pypi.org/project/copilot-session-usage/)
 [![Python Versions](https://img.shields.io/pypi/pyversions/copilot-session-usage)](https://pypi.org/project/copilot-session-usage/)
+[![Docs](https://readthedocs.org/projects/copilot-session-usage/badge/?version=stable)](https://copilot-session-usage.readthedocs.io/en/stable/)
 [![Code style: ruff](https://img.shields.io/badge/code%20style-ruff-000000.svg)](https://github.com/astral-sh/ruff)
 [![Type checked](https://img.shields.io/badge/type%20checked-mypy%2Fty-blue.svg)](./)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
@@ -182,6 +183,8 @@ just docs
 just docs-serve
 ```
 
+**Full documentation:** [copilot-session-usage.readthedocs.io](https://copilot-session-usage.readthedocs.io/)
+
 ## License
 
 MIT — see [LICENSE](LICENSE).

{copilot_session_usage-0.1.0 → copilot_session_usage-0.2.1}/README.md

@@ -4,6 +4,7 @@
 [![Coverage](https://img.shields.io/codecov/c/github/gsemet/copilot-session-usage)](https://codecov.io/gh/gsemet/copilot-session-usage)
 [![PyPI](https://img.shields.io/pypi/v/copilot-session-usage)](https://pypi.org/project/copilot-session-usage/)
 [![Python Versions](https://img.shields.io/pypi/pyversions/copilot-session-usage)](https://pypi.org/project/copilot-session-usage/)
+[![Docs](https://readthedocs.org/projects/copilot-session-usage/badge/?version=stable)](https://copilot-session-usage.readthedocs.io/en/stable/)
 [![Code style: ruff](https://img.shields.io/badge/code%20style-ruff-000000.svg)](https://github.com/astral-sh/ruff)
 [![Type checked](https://img.shields.io/badge/type%20checked-mypy%2Fty-blue.svg)](./)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
@@ -166,6 +167,8 @@ just docs
 just docs-serve
 ```
 
+**Full documentation:** [copilot-session-usage.readthedocs.io](https://copilot-session-usage.readthedocs.io/)
+
 ## License
 
 MIT — see [LICENSE](LICENSE).

copilot_session_usage-0.2.1/docs/source/_static/changelog.js

@@ -0,0 +1,25 @@
+/* Rewrite changelog category headings */
+document.addEventListener('DOMContentLoaded', function () {
+    const map = {
+        'Feat': '✨ Features',
+        'Fix': '🔧 Bug Fixes',
+        'Docs': '📚 Documentation',
+        'Chore': '🧹 Chores',
+        'Refactor': '🛠 Refactors',
+        'Test': '🧪 Tests',
+        'CI': '🤖 CI',
+        'Perf': '⚡ Performance',
+        'Build': '🏗 Build',
+        'Style': '🎨 Styles',
+    };
+
+    document.querySelectorAll('h3').forEach(function (h3) {
+        const text = h3.childNodes[0];
+        if (text && text.nodeType === Node.TEXT_NODE) {
+            const trimmed = text.textContent.trim();
+            if (map[trimmed]) {
+                text.textContent = ' ' + map[trimmed] + ' ';
+            }
+        }
+    });
+});

copilot_session_usage-0.2.1/docs/source/_static/custom.css

@@ -0,0 +1,142 @@
+/* Custom styles for copilot-session-usage documentation */
+
+/* ── Changelog ── */
+#changelog h2 {
+    font-size: 1.4em;
+    font-weight: 600;
+    margin-top: 2.5em;
+    padding-bottom: 0.4em;
+    border-bottom: 1px solid var(--color-background-border);
+}
+
+#changelog h2:first-of-type {
+    margin-top: 0.5em;
+}
+
+#changelog h2#unreleased {
+    color: var(--color-brand-primary);
+}
+
+#changelog h3 {
+    font-size: 0.8em;
+    font-weight: 600;
+    text-transform: uppercase;
+    letter-spacing: 0.08em;
+    margin: 1.5em 0 0.6em;
+    padding: 0.3rem 0.6rem;
+    display: inline-block;
+}
+
+/* Features */
+#changelog section[id="feat"] > h3,
+#changelog section[id="id1"] > h3,
+#changelog section[id="id4"] > h3,
+#changelog section[id="id6"] > h3,
+#changelog section[id="id8"] > h3,
+#changelog section[id="id10"] > h3 {
+    font-size: 0;
+    color: transparent;
+    background: rgba(26, 127, 55, 0.08);
+}
+
+#changelog section[id="feat"] > h3::before,
+#changelog section[id="id1"] > h3::before,
+#changelog section[id="id4"] > h3::before,
+#changelog section[id="id6"] > h3::before,
+#changelog section[id="id8"] > h3::before,
+#changelog section[id="id10"] > h3::before {
+    content: "✨ Features";
+    font-size: 0.8rem;
+    color: #1a7f37;
+}
+
+/* Bug Fixes */
+#changelog section[id="fix"] > h3,
+#changelog section[id="id2"] > h3,
+#changelog section[id="id3"] > h3,
+#changelog section[id="id5"] > h3,
+#changelog section[id="id7"] > h3,
+#changelog section[id="id9"] > h3 {
+    font-size: 0;
+    color: transparent;
+    background: rgba(154, 103, 0, 0.08);
+}
+
+#changelog section[id="fix"] > h3::before,
+#changelog section[id="id2"] > h3::before,
+#changelog section[id="id3"] > h3::before,
+#changelog section[id="id5"] > h3::before,
+#changelog section[id="id7"] > h3::before,
+#changelog section[id="id9"] > h3::before {
+    content: "🔧 Bug Fixes";
+    font-size: 0.8rem;
+    color: #9a6700;
+}
+
+#changelog ul {
+    margin-top: 0.5em;
+    padding-left: 1.2em;
+}
+
+#changelog li {
+    margin-bottom: 0.35em;
+    line-height: 1.6;
+}
+
+/* ── Landing page cards ── */
+.sd-card {
+    transition: transform 0.2s ease, box-shadow 0.2s ease;
+}
+
+.sd-card:hover {
+    transform: translateY(-2px);
+    box-shadow: 0 4px 12px rgba(0, 0, 0, 0.15);
+}
+
+/* ── Copy button ── */
+button.copybtn {
+    opacity: 0.6;
+    transition: opacity 0.2s;
+}
+
+button.copybtn:hover {
+    opacity: 1;
+}
+
+/* ── CLI tables ── */
+table.docutils {
+    font-size: 0.95em;
+}
+
+table.docutils th {
+    background: var(--color-background-secondary);
+}
+
+/* ── API signatures ── */
+dl.py.function,
+dl.py.class,
+dl.py.method {
+    margin: 1.5em 0;
+}
+
+dl.py.function > dd,
+dl.py.class > dd,
+dl.py.method > dd {
+    margin-left: 0;
+    padding-left: 1em;
+}
+
+dt.sig.sig-object.py {
+    background: var(--color-background-secondary);
+    border-left: 3px solid var(--color-brand-primary);
+    border-radius: 0;
+    margin-left: 0;
+    margin-right: 0;
+    padding: 0.6em 0.8em;
+    line-height: 1.6;
+    text-indent: 0;
+}
+
+dl.py.class > dt.sig.sig-object.py {
+    border-left-color: var(--color-brand-content);
+}

copilot_session_usage-0.2.1/docs/source/changelog.md

@@ -0,0 +1,4 @@
+# Changelog
+
+```{include} ../../CHANGELOG.md
+```

{copilot_session_usage-0.1.0 → copilot_session_usage-0.2.1}/docs/source/conf.py

@@ -17,6 +17,8 @@ extensions = [
     "sphinx.ext.napoleon",
     "sphinx_click",
     "sphinx_autodoc_typehints",
+    "sphinx_design",
+    "sphinx_copybutton",
 ]
 
 myst_enable_extensions = ["colon_fence", "deflist"]
@@ -24,6 +26,8 @@ myst_enable_extensions = ["colon_fence", "deflist"]
 html_theme = "furo"
 html_title = f"copilot-session-usage {version}"
 html_static_path = ["_static"]
+html_css_files = ["custom.css"]
+html_js_files = ["changelog.js"]
 
 autodoc_member_order = "bysource"
 autodoc_typehints = "description"

copilot_session_usage-0.2.1/docs/source/explanation/how-cost-estimation-works.md

@@ -0,0 +1,96 @@
+# How Cost Estimation Works
+
+`copilot-session-usage` estimates session costs from VS Code debug logs.
+This page explains each step.
+
+---
+
+## Where the logs live
+
+VS Code stores one directory per workspace under `workspaceStorage`. Inside
+each workspace directory, the Copilot extension writes debug logs:
+
+```
+workspaceStorage/
+└── <workspace-hash>/
+    └── GitHub.copilot-chat/
+        └── debug-logs/
+            └── <session-uuid>/
+                ├── *.jsonl      ← token events
+                └── ...
+```
+
+Default locations by platform:
+
+| Platform | Path |
+|----------|------|
+| macOS | `~/Library/Application Support/Code/User/workspaceStorage/` |
+| Linux | `~/.config/Code/User/workspaceStorage/` |
+| Windows | `%APPDATA%\Code\User\workspaceStorage\` |
+| WSL2 (remote) | `~/.vscode-server/data/User/workspaceStorage/` |
+
+The tool also checks `Code - Insiders` variants automatically.
+
+---
+
+## How sessions are discovered
+
+The tool reads the session title from VS Code's SQLite workspace database
+(`state.vscdb`). Sessions are sorted by the last-modified time of their
+debug-log directory, most recent first.
+
+The `list` command reads only metadata (no JSONL parsing). The `analyze`,
+`id`, and `batch` commands parse the full JSONL files.
+
+---
+
+## Parsing JSONL logs
+
+Each `.jsonl` file contains one JSON object per line. The tool extracts
+token-count events emitted by the Copilot extension for each LLM call:
+
+- `input_tokens` — tokens sent to the model
+- `output_tokens` — tokens generated by the model
+- `cached_tokens` — input tokens served from the provider's prompt cache
+- `model` — the model name as reported by the provider
+
+A single session may call multiple models (e.g., Claude Sonnet for the main
+request and Claude Haiku for a subagent). Each model's tokens are summed
+separately, then costs are computed per model and aggregated.
+
+---
+
+## Cost calculation
+
+For each model, cost is computed as:
+
+```
+cost = (input_tokens - cached_tokens) / 1_000_000 × input_price
+     + cached_tokens / 1_000_000 × cached_input_price
+     + output_tokens / 1_000_000 × output_price
+```
+
+Prices come from the bundled `models-and-pricing.yml`. For models with
+long-context tier switching (e.g., GPT-5.4 above 272K tokens), the tool
+selects the correct price row automatically.
+
+---
+
+## Subagent attribution
+
+`runSubagent` calls appear in the JSONL as a distinct event type. The tool
+tracks them separately so `--detail full` can show which fraction of tokens
+was consumed by subagents vs. the main conversation.
+
+---
+
+## Accuracy
+
+Prices match the published GitHub Copilot per-token rates for each model.
+The tool applies the same formula GitHub uses: input tokens (minus cached)
+at the full input rate, cached tokens at the cache-hit rate, output tokens
+at the output rate. Long-context tier switching is automatic.
+
+The main source of variance is pricing lag: the bundled table is updated
+manually with each release. Run `just refresh-pricing` to pull the latest
+rates.

copilot_session_usage-0.2.1/docs/source/explanation/index.md

@@ -0,0 +1,9 @@
+# How It Works
+
+Background and design notes.
+
+```{toctree}
+:maxdepth: 1
+
+how-cost-estimation-works
+```

copilot_session_usage-0.2.1/docs/source/how-to/analyze-specific-session.md

@@ -0,0 +1,46 @@
+# Analyze a Specific Session
+
+Use this when you know the path to a session's debug-log directory or its UUID,
+and `latest` would pick the wrong session.
+
+## By debug-log path
+
+Each session is a directory inside VS Code's `workspaceStorage`:
+
+```bash
+copilot-session-usage analyze \
+  "/path/to/workspaceStorage/<hash>/GitHub.copilot-chat/debug-logs/<session-uuid>"
+```
+
+The path always ends in a UUID directory. Use `list` to find the right one if
+you're unsure.
+
+## By UUID
+
+If you have a session ID from a previous `list` or `find` run:
+
+```bash
+copilot-session-usage id 3a91c012-1b4e-4c8a-9f72-ab12cd34ef56
+```
+
+The tool searches all workspaceStorage roots automatically.
+
+## By title substring
+
+```bash
+copilot-session-usage find "CI pipeline"
+```
+
+Matching is case-insensitive substring search. If multiple sessions match,
+the tool lists them and exits without analyzing — then use `id` to pick one.
+
+## Locating workspaceStorage manually
+
+| Platform | Default path |
+|----------|-------------|
+| macOS | `~/Library/Application Support/Code/User/workspaceStorage/` |
+| Linux | `~/.config/Code/User/workspaceStorage/` |
+| Windows | `%APPDATA%\Code\User\workspaceStorage\` |
+
+Each subdirectory under `workspaceStorage/` corresponds to one VS Code workspace.
+Inside it, `GitHub.copilot-chat/debug-logs/` contains one directory per session.