agenttelemetry-app 2.0.0__tar.gz → 2.1.0__tar.gz

agenttelemetry_app-2.1.0/MANIFEST.in

@@ -0,0 +1,70 @@
+include pyproject.toml
+include setup.py
+include README.md
+include LICENSE
+include __init__.py
+include __main__.py
+include cli.py
+include dashboard.py
+include editor_snapshot.py
+include ledger_backups.py
+include diagnostics.py
+include session_timeline.py
+include native_activity.py
+include local_servers.py
+include local_servers_windows.py
+include parser.py
+include release_notes.py
+include native.py
+include accounts.py
+include session_names.py
+include mcp_access.py
+include mcp_backend.py
+include mcp_protocol.py
+include mcp_server.py
+include mcp_tools.py
+include telemetry_query.py
+include telemetry_insights.py
+include index.html
+include chart.umd.min.js
+include manifest.json
+include sw.js
+include docs/python-package.md
+include docs/mcp.md
+include docs/release-notes.md
+include docs/native-activity.md
+include static/app.css
+include static/apple-touch-icon.png
+include static/charts.js
+include static/core.js
+include static/icon-192.png
+include static/icon-512.png
+include static/insights.js
+include static/maintenance.js
+include static/release-notes.js
+include static/mcp.js
+include static/timeline.js
+include static/tool-icons/LICENSE.hermes.txt
+include static/tool-icons/LICENSE.openclaw.txt
+include static/tool-icons/LICENSE.simple-icons.txt
+include static/tool-icons/README.md
+include static/tool-icons/claude.svg
+include static/tool-icons/copilot.svg
+include static/tool-icons/cursor.svg
+include static/tool-icons/hermes.svg
+include static/tool-icons/openai.svg
+include static/tool-icons/openclaw.svg
+include static/tool-icons/opencode.svg
+include static/views.js
+prune tests
+prune website
+prune macos
+prune windows
+prune vscode
+prune .github
+prune build
+prune dist
+prune .usage_cache.json
+prune .usage-backups
+prune .peers
+global-exclude .usage_cache.json .usage_cache.json.tmp .peers.json server.log project-names.json release-notes.json release-notes.lock .release-notes-*.tmp *.py[cod]

{agenttelemetry_app-2.0.0/agenttelemetry_app.egg-info → agenttelemetry_app-2.1.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agenttelemetry-app
-Version: 2.0.0
+Version: 2.1.0
 Summary: A private, local dashboard for AI coding agent usage
 License-Expression: MIT
 Project-URL: Homepage, https://github.com/uttamdeb/agent-telemetry
@@ -31,11 +31,14 @@ vs Google** provider comparison, an activity calendar, and breakdowns by **model
 day, hour, weekday, tool, IDE, project and session** — plus how much **disk** all these logs
 eat, and suggestions for spending less, drawn from your own numbers.
 
-**Your data stays on your machine** — unless you turn on [Your devices](#your-devices-optional)
-to combine two of your own computers over your local network. Optional account lookups
-contact the provider only after you choose **Read once**; account metadata is never shared
-with paired devices. No account, no API key, no
-telemetry, no dependencies — just Python's standard library and a vendored copy of Chart.js.
+By default, log inventory, usage and the cache stay on this machine. Separate actions can
+share selected exports with [paired devices](#your-devices-optional), return requested
+analytics to an enabled [local MCP client](docs/mcp.md) (which may forward tool results to
+its model provider), contact a provider after a confirmed **Read once** account lookup, or
+fetch GitHub update and release-note metadata after you click **Check for updates** or
+**Load notes**. Cached release notes can be shown offline after an upgrade. No account or API key is needed
+for the dashboard; it has no runtime dependencies beyond Python's standard library and a
+vendored copy of Chart.js.
 
 Covers **Claude Code · Claude Desktop · Codex · GitHub Copilot · Cursor · OpenCode · Hermes Agent · OpenClaw**.
 
@@ -43,9 +46,9 @@ Covers **Claude Code · Claude Desktop · Codex · GitHub Copilot · Cursor · O
 
 | Platform | Download |
 | --- | --- |
-| macOS 13+ · Apple Silicon | **[Download DMG](https://github.com/uttamdeb/agent-telemetry/releases/download/v2.0.0/AgentTelemetry-2.0.0-macos-arm64.dmg)** |
-| macOS 13+ · Intel | **[Download DMG](https://github.com/uttamdeb/agent-telemetry/releases/download/v2.0.0/AgentTelemetry-2.0.0-macos-x86_64.dmg)** |
-| Windows 10/11 · x64 | **[Download EXE installer](https://github.com/uttamdeb/agent-telemetry/releases/download/v2.0.0/AgentTelemetry-2.0.0-windows-x64-setup.exe)** |
+| macOS 13+ · Apple Silicon | **[Download DMG](https://github.com/uttamdeb/agent-telemetry/releases/download/v2.1.0/AgentTelemetry-2.1.0-macos-arm64.dmg)** |
+| macOS 13+ · Intel | **[Download DMG](https://github.com/uttamdeb/agent-telemetry/releases/download/v2.1.0/AgentTelemetry-2.1.0-macos-x86_64.dmg)** |
+| Windows 10/11 · x64 | **[Download EXE installer](https://github.com/uttamdeb/agent-telemetry/releases/download/v2.1.0/AgentTelemetry-2.1.0-windows-x64-setup.exe)** |
 
 **Python is bundled — no terminal setup needed.** macOS: open the DMG, drag the app to
 Applications and open it. Windows: run the installer and open AgentTelemetry from Start.
@@ -59,7 +62,9 @@ starting monitoring. On macOS, opening the app manually also lets you import fir
 These builds are unsigned/unnotarized. macOS may require **System Settings → Privacy &
 Security → Open Anyway**; Windows SmartScreen may require **More info → Run anyway**.
 [All releases](https://github.com/uttamdeb/agent-telemetry/releases) ·
-[SHA-256 checksums](https://github.com/uttamdeb/agent-telemetry/releases/download/v2.0.0/SHA256SUMS.txt)
+[What's new in 2.1.0](docs/releases/v2.1.0.md) ·
+[SHA-256 checksums](https://github.com/uttamdeb/agent-telemetry/releases/download/v2.1.0/SHA256SUMS.txt) ·
+[PyPI package 2.1.0](https://pypi.org/project/agenttelemetry-app/2.1.0/)
 
 ---
 
@@ -78,17 +83,17 @@ Security → Open Anyway**; Windows SmartScreen may require **More info → Run
 
 ## Quick start
 
-With [uv](https://docs.astral.sh/uv/getting-started/installation/) installed:
+Install with Python 3.9+:
 
 ```bash
-uvx agenttelemetry-app
+python -m pip install agenttelemetry-app
+agenttelemetry
 ```
 
-Or install with Python 3.9+:
+Or, with [uv](https://docs.astral.sh/uv/getting-started/installation/) installed:
 
 ```bash
-python -m pip install agenttelemetry-app
-agenttelemetry
+uvx agenttelemetry-app
 ```
 
 Then open **http://127.0.0.1:7878**. The Python package starts the local browser dashboard;
@@ -114,6 +119,39 @@ Options: `python3 dashboard.py --port 9000` · `--rebuild` (ignore cache, full r
 cache and optional device-sharing files outside the checkout). Without `--data-dir`, current
 checkout behavior is unchanged. Or `./run.sh [flags]`.
 
+## Editor extension
+
+The [AgentTelemetry editor extension](vscode/README.md) brings local usage into
+VS Code compatible desktop editors, including Cursor and Antigravity IDE. Its
+Agent desk uses the app's icon and light/dark theme, with workspace totals,
+recorded main-agent/subagent relationships, and an in-memory usage baseline.
+Install from the [Visual Studio Marketplace](https://marketplace.visualstudio.com/items?itemName=agenttelemetry-team.agenttelemetry)
+in VS Code, from [Open VSX](https://open-vsx.org/extension/agenttelemetry-team/agenttelemetry)
+in Cursor and compatible editors, or use the universal VSIX following the
+[extension guide](vscode/README.md#install-a-vsix).
+
+## Recognizing subagent sessions
+
+Sessions shows a full **Subagent** label, a branching icon, and a searchable session
+identifier for transcripts that the source identifies as delegated work. Use
+**All sessions / Main agents / Subagents** to focus the list; the choice survives
+reloads and shared links without changing the other dashboard totals. Session titles
+also open details from the keyboard.
+
+Recorded delegation counts and Claude sidechain usage are explained in the drawer.
+Main agents shows sessions not marked as subagents; some tools and older logs
+do not record this marker. Parent links are not inferred. See
+[behavior and limitations](docs/subagent-sessions.md).
+
+## Recorded reasoning effort
+
+Sessions shows **Recorded effort** below the model for Claude and Codex. Open a
+session for the recorded levels and their date/model scope. Changing the date,
+model or provider filter changes this label alongside the session figures.
+Missing metadata says **Not recorded**; mixed settings and partial coverage are
+explicit. These are recorded controls, not a measurement of reasoning quality or
+thinking tokens. See [sources and limitations](docs/recorded-effort.md).
+
 ## Subscription limits and account details
 
 The bottom of Cost shows subscription limits for Codex and Claude Code when they
@@ -128,6 +166,15 @@ estimated from tokens or combined across devices. Session details show recorded
 creator/account IDs with their attribution limits. Account metadata is private to the
 source device. See [setup, research and limitations](docs/account-limits.md).
 
+## Local servers (macOS)
+
+The **Local servers** tab and menu bar can list local project listeners, pin them,
+and save an explicit launch command for Start and Restart. Process actions ask for
+confirmation. They require a ready macOS backend; Windows and Linux show the support
+limitation. Commands stay on this machine and are never included in device sharing.
+Running a saved command gives it your account's file and network access.
+See [behavior, privacy and limitations](docs/local-servers.md).
+
 ## Install the menu bar / system tray app
 
 Use the [app downloads](#download-the-app) above for a ready-to-run installation.
@@ -178,8 +225,8 @@ the sync API retain independent polling until upgraded and restarted.
 Read the [macOS guide](macos/AgentTelemetryMac/README.md) and
 [Windows guide](windows/README.md) for paths, controls and development checks. macOS
 downloads and source builds are ad-hoc signed; a Developer ID signed/notarized installer
-is not supplied. The backend remains stdlib-only and no runtime update checks
-are added. The macOS packaging step downloads a hash-pinned Python runtime explicitly.
+is not supplied. The backend remains stdlib-only and does not check for updates
+automatically. The macOS packaging step downloads a hash-pinned Python runtime explicitly.
 
 Local app integrations can use `GET /api/health` for a small readiness response that contains
 no usage data, and `GET /api/summary` for today's token total and API-equivalent estimated
@@ -191,6 +238,21 @@ retain one serialized snapshot per display tick, in memory only; the ledger is u
 as all writes. `POST /api/shutdown` additionally requires the owning Windows client's
 per-process control token; a normal standalone dashboard cannot be stopped by that route.
 
+## Local MCP access (optional)
+
+AgentTelemetry provides eight read-only MCP tools for usage, comparisons, supported insights,
+session summaries and timelines, data health, the telemetry catalog and saved subscription
+limits. MCP access is off by default. Enable it in Settings and confirm each scope. The local
+bridge requires an already-running dashboard and returns data only when the configured MCP
+client requests it. A cloud-backed client may send tool results to its provider; review that
+client's data-handling settings before enabling access. Project/device names and usage from
+connected devices require their own opt-in scopes. The MCP bridge never refreshes accounts,
+returns prompt text, or edits client configuration. See [MCP tools, setup and privacy
+limits](docs/mcp.md).
+
+The MCP bridge ships with the **2.1.0** application and Python package. It is not a separate
+marketplace listing; install/update AgentTelemetry, then use the [MCP setup guide](docs/mcp.md).
+
 > `--rebuild` deletes the cache, and with it every session whose log has since been deleted
 > from disk (see [Storage](#storage--what-these-logs-cost-you-in-disk)). Copy
 > `.usage_cache.json` somewhere safe first if you've cleaned up old logs.
@@ -315,6 +377,12 @@ Previous title metadata is backed up privately in
 This supports local Claude Code transcripts, Codex through its installed CLI’s
 [official name API](https://learn.chatgpt.com/docs/app-server), and OpenCode’s SQLite
 session stores. Other formats, remote sessions and deleted logs cannot be edited.
+Recognized local Claude subagent transcripts instead offer **Name in AgentTelemetry**.
+This saves a private display name on this device without editing Claude's transcript,
+native subagent name, or parent session. The preview states this scope explicitly.
+These names live in `AgentTelemetryNative/session-display-names.json`, outside the
+usage ledger, summaries, and device sharing. Enter the source title again to remove
+a display-name override. See [subagent name behavior](docs/subagent-sessions.md).
 Tool/provider icons are bundled locally, including the OpenAI mark for Codex; no remote
 logo requests occur. Their sources and licenses are in `static/tool-icons/README.md`.
 
@@ -340,10 +408,48 @@ search box, and `#cost`, `#sessions`… for the tab. For example
 `/?range=7d&metric=cost&tools=claude&projects=sims#cost`. Only what differs from the default
 is written, and changing a filter never adds a browser-history entry.
 
+**What changed?** — Overview and Cost compare the selected range with the preceding
+equal-length range. Switch between projects, models, tools and (for tokens/cost)
+token types to see signed contributions, including decreases and categories that
+disappeared. Each breakdown reconciles independently to the total change. Click a
+category for current-period sessions or its previous value for earlier sessions.
+All usage filters apply; All time has no comparison. Missing prior observations and
+an unfinished current period are labeled. Contributions identify where usage changed,
+not a causal explanation. Cost remains an API-equivalent estimate.
+
+**Session timeline** — the session drawer combines daily retained usage with recorded
+compaction markers and local Claude/Codex source events: model requests, tool calls,
+user turns and recorded subagent starts. No prompts or tool arguments are returned.
+The read is bounded to the first 64 MiB and 400 events in the selected date range;
+truncation is explicit. Date filters use local dates; model filters apply to events
+with model attribution. Archived/remote sessions and unsupported formats retain
+daily detail where available; missing timestamps or history are not reconstructed.
+
+**Backups and troubleshooting** — Settings shows detected-source scan results,
+actionable parsing errors, ledger failures and models missing prices. An inactive
+tool is not reported as stale merely because it has no recent activity. Backups are
+private copies of the ledger in `.usage-backups/` beside it (including with
+`--data-dir`), excluded from device sharing and installation payloads. A saved-ledger
+snapshot is kept on the first save each UTC day; updates and cache resets require a
+safety copy first. Retention keeps 7 daily snapshots and up to 5 each of manual,
+pre-restore and corrupt-file recovery copies. A failed daily backup does not stop
+normal ledger saving and is reported in Settings.
+
+Restore shows stored-session counts and requires a one-use, five-minute confirmation
+ticket. Changed backups, disk contents or newly parsed usage invalidate the preview.
+The current ledger is preserved before replacement, including unreadable bytes as
+a non-restorable recovery copy. Backups cover aggregates, not original transcripts,
+device pairing settings or native preferences; local backups do not protect against
+loss of the drive. Use `python tests/preview_features.py --port 8896` for an isolated
+preview with invented data.
+
 **Version and updates** — the sidebar footer shows the running version. *Check for updates*
-asks GitHub (the only time the dashboard goes online, and only when you click); *Update*
-fast-forwards your checkout and restarts the server. It refuses if you have local edits or
-commits that aren't on GitHub. A copy that isn't a git clone has no update button.
+asks GitHub for the latest stable release and its tagged notes only when you click; notes
+already cached on this machine can be shown offline. A first open records the current version
+as the baseline. Later upgrades can show their notes once, after which the display is
+acknowledged. *Update* fast-forwards a source checkout and restarts the server; it refuses
+local edits and commits that aren't upstream. Packaged apps link to the official release for
+manual installation. See [release notes behavior](docs/release-notes.md).
 
 ---
 

{agenttelemetry_app-2.0.0 → agenttelemetry_app-2.1.0}/README.md

@@ -7,11 +7,14 @@ vs Google** provider comparison, an activity calendar, and breakdowns by **model
 day, hour, weekday, tool, IDE, project and session** — plus how much **disk** all these logs
 eat, and suggestions for spending less, drawn from your own numbers.
 
-**Your data stays on your machine** — unless you turn on [Your devices](#your-devices-optional)
-to combine two of your own computers over your local network. Optional account lookups
-contact the provider only after you choose **Read once**; account metadata is never shared
-with paired devices. No account, no API key, no
-telemetry, no dependencies — just Python's standard library and a vendored copy of Chart.js.
+By default, log inventory, usage and the cache stay on this machine. Separate actions can
+share selected exports with [paired devices](#your-devices-optional), return requested
+analytics to an enabled [local MCP client](docs/mcp.md) (which may forward tool results to
+its model provider), contact a provider after a confirmed **Read once** account lookup, or
+fetch GitHub update and release-note metadata after you click **Check for updates** or
+**Load notes**. Cached release notes can be shown offline after an upgrade. No account or API key is needed
+for the dashboard; it has no runtime dependencies beyond Python's standard library and a
+vendored copy of Chart.js.
 
 Covers **Claude Code · Claude Desktop · Codex · GitHub Copilot · Cursor · OpenCode · Hermes Agent · OpenClaw**.
 
@@ -19,9 +22,9 @@ Covers **Claude Code · Claude Desktop · Codex · GitHub Copilot · Cursor · O
 
 | Platform | Download |
 | --- | --- |
-| macOS 13+ · Apple Silicon | **[Download DMG](https://github.com/uttamdeb/agent-telemetry/releases/download/v2.0.0/AgentTelemetry-2.0.0-macos-arm64.dmg)** |
-| macOS 13+ · Intel | **[Download DMG](https://github.com/uttamdeb/agent-telemetry/releases/download/v2.0.0/AgentTelemetry-2.0.0-macos-x86_64.dmg)** |
-| Windows 10/11 · x64 | **[Download EXE installer](https://github.com/uttamdeb/agent-telemetry/releases/download/v2.0.0/AgentTelemetry-2.0.0-windows-x64-setup.exe)** |
+| macOS 13+ · Apple Silicon | **[Download DMG](https://github.com/uttamdeb/agent-telemetry/releases/download/v2.1.0/AgentTelemetry-2.1.0-macos-arm64.dmg)** |
+| macOS 13+ · Intel | **[Download DMG](https://github.com/uttamdeb/agent-telemetry/releases/download/v2.1.0/AgentTelemetry-2.1.0-macos-x86_64.dmg)** |
+| Windows 10/11 · x64 | **[Download EXE installer](https://github.com/uttamdeb/agent-telemetry/releases/download/v2.1.0/AgentTelemetry-2.1.0-windows-x64-setup.exe)** |
 
 **Python is bundled — no terminal setup needed.** macOS: open the DMG, drag the app to
 Applications and open it. Windows: run the installer and open AgentTelemetry from Start.
@@ -35,7 +38,9 @@ starting monitoring. On macOS, opening the app manually also lets you import fir
 These builds are unsigned/unnotarized. macOS may require **System Settings → Privacy &
 Security → Open Anyway**; Windows SmartScreen may require **More info → Run anyway**.
 [All releases](https://github.com/uttamdeb/agent-telemetry/releases) ·
-[SHA-256 checksums](https://github.com/uttamdeb/agent-telemetry/releases/download/v2.0.0/SHA256SUMS.txt)
+[What's new in 2.1.0](docs/releases/v2.1.0.md) ·
+[SHA-256 checksums](https://github.com/uttamdeb/agent-telemetry/releases/download/v2.1.0/SHA256SUMS.txt) ·
+[PyPI package 2.1.0](https://pypi.org/project/agenttelemetry-app/2.1.0/)
 
 ---
 
@@ -54,17 +59,17 @@ Security → Open Anyway**; Windows SmartScreen may require **More info → Run
 
 ## Quick start
 
-With [uv](https://docs.astral.sh/uv/getting-started/installation/) installed:
+Install with Python 3.9+:
 
 ```bash
-uvx agenttelemetry-app
+python -m pip install agenttelemetry-app
+agenttelemetry
 ```
 
-Or install with Python 3.9+:
+Or, with [uv](https://docs.astral.sh/uv/getting-started/installation/) installed:
 
 ```bash
-python -m pip install agenttelemetry-app
-agenttelemetry
+uvx agenttelemetry-app
 ```
 
 Then open **http://127.0.0.1:7878**. The Python package starts the local browser dashboard;
@@ -90,6 +95,39 @@ Options: `python3 dashboard.py --port 9000` · `--rebuild` (ignore cache, full r
 cache and optional device-sharing files outside the checkout). Without `--data-dir`, current
 checkout behavior is unchanged. Or `./run.sh [flags]`.
 
+## Editor extension
+
+The [AgentTelemetry editor extension](vscode/README.md) brings local usage into
+VS Code compatible desktop editors, including Cursor and Antigravity IDE. Its
+Agent desk uses the app's icon and light/dark theme, with workspace totals,
+recorded main-agent/subagent relationships, and an in-memory usage baseline.
+Install from the [Visual Studio Marketplace](https://marketplace.visualstudio.com/items?itemName=agenttelemetry-team.agenttelemetry)
+in VS Code, from [Open VSX](https://open-vsx.org/extension/agenttelemetry-team/agenttelemetry)
+in Cursor and compatible editors, or use the universal VSIX following the
+[extension guide](vscode/README.md#install-a-vsix).
+
+## Recognizing subagent sessions
+
+Sessions shows a full **Subagent** label, a branching icon, and a searchable session
+identifier for transcripts that the source identifies as delegated work. Use
+**All sessions / Main agents / Subagents** to focus the list; the choice survives
+reloads and shared links without changing the other dashboard totals. Session titles
+also open details from the keyboard.
+
+Recorded delegation counts and Claude sidechain usage are explained in the drawer.
+Main agents shows sessions not marked as subagents; some tools and older logs
+do not record this marker. Parent links are not inferred. See
+[behavior and limitations](docs/subagent-sessions.md).
+
+## Recorded reasoning effort
+
+Sessions shows **Recorded effort** below the model for Claude and Codex. Open a
+session for the recorded levels and their date/model scope. Changing the date,
+model or provider filter changes this label alongside the session figures.
+Missing metadata says **Not recorded**; mixed settings and partial coverage are
+explicit. These are recorded controls, not a measurement of reasoning quality or
+thinking tokens. See [sources and limitations](docs/recorded-effort.md).
+
 ## Subscription limits and account details
 
 The bottom of Cost shows subscription limits for Codex and Claude Code when they
@@ -104,6 +142,15 @@ estimated from tokens or combined across devices. Session details show recorded
 creator/account IDs with their attribution limits. Account metadata is private to the
 source device. See [setup, research and limitations](docs/account-limits.md).
 
+## Local servers (macOS)
+
+The **Local servers** tab and menu bar can list local project listeners, pin them,
+and save an explicit launch command for Start and Restart. Process actions ask for
+confirmation. They require a ready macOS backend; Windows and Linux show the support
+limitation. Commands stay on this machine and are never included in device sharing.
+Running a saved command gives it your account's file and network access.
+See [behavior, privacy and limitations](docs/local-servers.md).
+
 ## Install the menu bar / system tray app
 
 Use the [app downloads](#download-the-app) above for a ready-to-run installation.
@@ -154,8 +201,8 @@ the sync API retain independent polling until upgraded and restarted.
 Read the [macOS guide](macos/AgentTelemetryMac/README.md) and
 [Windows guide](windows/README.md) for paths, controls and development checks. macOS
 downloads and source builds are ad-hoc signed; a Developer ID signed/notarized installer
-is not supplied. The backend remains stdlib-only and no runtime update checks
-are added. The macOS packaging step downloads a hash-pinned Python runtime explicitly.
+is not supplied. The backend remains stdlib-only and does not check for updates
+automatically. The macOS packaging step downloads a hash-pinned Python runtime explicitly.
 
 Local app integrations can use `GET /api/health` for a small readiness response that contains
 no usage data, and `GET /api/summary` for today's token total and API-equivalent estimated
@@ -167,6 +214,21 @@ retain one serialized snapshot per display tick, in memory only; the ledger is u
 as all writes. `POST /api/shutdown` additionally requires the owning Windows client's
 per-process control token; a normal standalone dashboard cannot be stopped by that route.
 
+## Local MCP access (optional)
+
+AgentTelemetry provides eight read-only MCP tools for usage, comparisons, supported insights,
+session summaries and timelines, data health, the telemetry catalog and saved subscription
+limits. MCP access is off by default. Enable it in Settings and confirm each scope. The local
+bridge requires an already-running dashboard and returns data only when the configured MCP
+client requests it. A cloud-backed client may send tool results to its provider; review that
+client's data-handling settings before enabling access. Project/device names and usage from
+connected devices require their own opt-in scopes. The MCP bridge never refreshes accounts,
+returns prompt text, or edits client configuration. See [MCP tools, setup and privacy
+limits](docs/mcp.md).
+
+The MCP bridge ships with the **2.1.0** application and Python package. It is not a separate
+marketplace listing; install/update AgentTelemetry, then use the [MCP setup guide](docs/mcp.md).
+
 > `--rebuild` deletes the cache, and with it every session whose log has since been deleted
 > from disk (see [Storage](#storage--what-these-logs-cost-you-in-disk)). Copy
 > `.usage_cache.json` somewhere safe first if you've cleaned up old logs.
@@ -291,6 +353,12 @@ Previous title metadata is backed up privately in
 This supports local Claude Code transcripts, Codex through its installed CLI’s
 [official name API](https://learn.chatgpt.com/docs/app-server), and OpenCode’s SQLite
 session stores. Other formats, remote sessions and deleted logs cannot be edited.
+Recognized local Claude subagent transcripts instead offer **Name in AgentTelemetry**.
+This saves a private display name on this device without editing Claude's transcript,
+native subagent name, or parent session. The preview states this scope explicitly.
+These names live in `AgentTelemetryNative/session-display-names.json`, outside the
+usage ledger, summaries, and device sharing. Enter the source title again to remove
+a display-name override. See [subagent name behavior](docs/subagent-sessions.md).
 Tool/provider icons are bundled locally, including the OpenAI mark for Codex; no remote
 logo requests occur. Their sources and licenses are in `static/tool-icons/README.md`.
 
@@ -316,10 +384,48 @@ search box, and `#cost`, `#sessions`… for the tab. For example
 `/?range=7d&metric=cost&tools=claude&projects=sims#cost`. Only what differs from the default
 is written, and changing a filter never adds a browser-history entry.
 
+**What changed?** — Overview and Cost compare the selected range with the preceding
+equal-length range. Switch between projects, models, tools and (for tokens/cost)
+token types to see signed contributions, including decreases and categories that
+disappeared. Each breakdown reconciles independently to the total change. Click a
+category for current-period sessions or its previous value for earlier sessions.
+All usage filters apply; All time has no comparison. Missing prior observations and
+an unfinished current period are labeled. Contributions identify where usage changed,
+not a causal explanation. Cost remains an API-equivalent estimate.
+
+**Session timeline** — the session drawer combines daily retained usage with recorded
+compaction markers and local Claude/Codex source events: model requests, tool calls,
+user turns and recorded subagent starts. No prompts or tool arguments are returned.
+The read is bounded to the first 64 MiB and 400 events in the selected date range;
+truncation is explicit. Date filters use local dates; model filters apply to events
+with model attribution. Archived/remote sessions and unsupported formats retain
+daily detail where available; missing timestamps or history are not reconstructed.
+
+**Backups and troubleshooting** — Settings shows detected-source scan results,
+actionable parsing errors, ledger failures and models missing prices. An inactive
+tool is not reported as stale merely because it has no recent activity. Backups are
+private copies of the ledger in `.usage-backups/` beside it (including with
+`--data-dir`), excluded from device sharing and installation payloads. A saved-ledger
+snapshot is kept on the first save each UTC day; updates and cache resets require a
+safety copy first. Retention keeps 7 daily snapshots and up to 5 each of manual,
+pre-restore and corrupt-file recovery copies. A failed daily backup does not stop
+normal ledger saving and is reported in Settings.
+
+Restore shows stored-session counts and requires a one-use, five-minute confirmation
+ticket. Changed backups, disk contents or newly parsed usage invalidate the preview.
+The current ledger is preserved before replacement, including unreadable bytes as
+a non-restorable recovery copy. Backups cover aggregates, not original transcripts,
+device pairing settings or native preferences; local backups do not protect against
+loss of the drive. Use `python tests/preview_features.py --port 8896` for an isolated
+preview with invented data.
+
 **Version and updates** — the sidebar footer shows the running version. *Check for updates*
-asks GitHub (the only time the dashboard goes online, and only when you click); *Update*
-fast-forwards your checkout and restarts the server. It refuses if you have local edits or
-commits that aren't on GitHub. A copy that isn't a git clone has no update button.
+asks GitHub for the latest stable release and its tagged notes only when you click; notes
+already cached on this machine can be shown offline. A first open records the current version
+as the baseline. Later upgrades can show their notes once, after which the display is
+acknowledged. *Update* fast-forwards a source checkout and restarts the server; it refuses
+local edits and commits that aren't upstream. Packaged apps link to the official release for
+manual installation. See [release notes behavior](docs/release-notes.md).
 
 ---
 

{agenttelemetry_app-2.0.0 → agenttelemetry_app-2.1.0}/__init__.py

@@ -1,3 +1,3 @@
 """AgentTelemetry's local dashboard package."""
 
-__version__ = "2.0.0"
+__version__ = "2.1.0"

{agenttelemetry_app-2.0.0 → agenttelemetry_app-2.1.0}/accounts.py

@@ -183,7 +183,7 @@ def _codex_read():
             if not isinstance(result, dict): raise ValueError("Codex returned an unsupported account response.")
             return result
     try:
-        request(1, "initialize", {"clientInfo": {"name": "agent_telemetry", "title": "AgentTelemetry", "version": "2.0.0"}})
+        request(1, "initialize", {"clientInfo": {"name": "agent_telemetry", "title": "AgentTelemetry", "version": "2.1.0"}})
         process.stdin.write('{"method":"initialized","params":{}}\n'); process.stdin.flush()
         before = request(2, "account/read", {"refreshToken": False}).get("account")
         limits = request(3, "account/rateLimits/read", {}) if isinstance(before, dict) and before.get("type") == "chatgpt" else {}