dexterm-cli 0.2.0 → 0.2.1

package/dist/packages/mcp/assets/kb/docs/docs-getting-started-requirements.md

@@ -26,10 +26,10 @@ date: 2026-10-16
 | need | why | notes |
 |---|---|---|
 | Node.js 22.18 or newer | dexterm runs its TypeScript sources directly; no build step | `node -v` to check. The installer can fetch a verified Node for you. |
-| a terminal with 24-bit colour | the cyberspace look | iTerm2, WezTerm, Ghostty, Kitty, Alacritty, Windows Terminal. 256-colour and monochrome terminals still work, flattened. |
+| a terminal with 24-bit colour | the cyberspace look | iTerm2, WezTerm, Ghostty, Kitty, Alacritty. 256-colour and monochrome terminals still work, flattened. |
 | an internet connection | all data is public and keyless | nothing goes through a dexterm server; see data sources (https://dexterm.xyz/docs/data-sources). |
 | optional: Claude Code logged in | only the analyst needs it | `claude` on your PATH, logged in with your own account. Everything else works without it. |
 | optional: a free RPC key | the ranked top-20 holder list and faster chain reads | Helius, Alchemy, QuickNode or Ankr free tier; see configuration (https://dexterm.xyz/docs/configuration). |
 | optional: Rust (`cargo`) | the native docked chart window | without it the chart popup opens in your browser; see popup chart (https://dexterm.xyz/docs/popup-chart). |
 
-> note: dexterm 0.2.0 is out (2026-10-25), open source under AGPL-3.0-only at github.com/dexterm-xyz/dexterm (https://github.com/dexterm-xyz/dexterm). It is early: trading is experimental and has known bugs. The release ships checksums, a build-provenance attestation and an SBOM, and its VirusTotal result (including flags we explain) is on the trust page (https://dexterm.xyz/trust/). It is also on npm as `dexterm-cli` (https://www.npmjs.com/package/dexterm-cli); the command it installs is still `dexterm`.
+> note: dexterm 0.2.1 is out (2026-10-30), open source under AGPL-3.0-only at github.com/dexterm-xyz/dexterm (https://github.com/dexterm-xyz/dexterm). It is early: trading is experimental and has known bugs. The release ships checksums, a build-provenance attestation and an SBOM, and its VirusTotal result (including flags we explain) is on the trust page (https://dexterm.xyz/trust/). It is also on npm as `dexterm-cli` (https://www.npmjs.com/package/dexterm-cli); the command it installs is still `dexterm`.

package/dist/packages/mcp/assets/kb/docs/docs-getting-started-supported-platforms.md

@@ -24,21 +24,12 @@ sources:
 date: 2026-10-16
 ---
 
-This table says what each platform has actually been through, not what we expect to work. "Tested" means the typecheck, the full offline test suite and an install smoke (`npm pack`, `npm i -g` of that tarball into an empty prefix with a fresh home, then `dexterm --version` and `dexterm doctor`) have passed there.
+dexterm supports **macOS and Linux**. Windows is not supported. This table says what each platform has actually been through, not what we expect to work. "Tested" means the typecheck, the full offline test suite and an install smoke (`npm pack`, `npm i -g` of that tarball into an empty prefix with a fresh home, then `dexterm --version` and `dexterm doctor`) have passed there.
 
 | platform | status | what has run on it |
 |---|---|---|
 | Linux x64, Node 22 and 24 | tested | the full suite on every push in CI (Ubuntu), and the same steps in Docker (`node:22-bookworm`, `node:24-bookworm`), including the install smoke |
 | macOS on Intel | tested | the full suite on every change, the install smoke, and a Homebrew install (slow: Homebrew builds Node from source on Intel) |
 | macOS on Apple Silicon | tested in CI (0.1.4) | the full suite on an Apple Silicon runner (`macos-14`) passed on the 0.1.4 release candidate. The manual Homebrew job (tap, trust, install, `brew test`) has not run yet |
-| Windows x64 | experimental, tested in CI (0.1.4) | the `windows-latest` leg runs the full suite and it passed on the 0.1.4 release candidate (a few tests that need POSIX file permissions or Unix-only tools are skipped, and ACL-based file isolation is not verified). Known gaps are listed below |
 | WSL2 | not tested separately | it is Linux, so expect the Linux behaviour |
-
-Known gaps on Windows (none of them affect key safety: dexterm never holds a wallet key on any platform):
-
-- Files dexterm keeps private (tokens, the optional RPC key) are written with POSIX mode `0600`. Windows ignores that mode, so on Windows they are protected only by your user profile's normal permissions.
-- The analyst runs `claude` without a shell, so it can start Claude Code's native installer build (`claude.exe`) but not the `claude.cmd` script an npm install creates. Doctor counts only `claude.exe` as found, so with an npm install it reports the Claude CLI as missing.
-- Voice mode has no Windows speech engine (see voice (https://dexterm.xyz/docs/voice#linux-and-windows)).
-- Opening a token's links and the PnL card's "share to X" do not start a browser on Windows; dexterm shows the URL to open yourself.
-- `doctor` prints its fixes as POSIX shell commands (`mkdir -p`, `chmod`); in PowerShell, do the equivalent by hand.
-- `dexterm kb edit` and `dexterm skill edit` do not open `$EDITOR`; they print the file to edit instead.
+| Windows | not supported | a CI leg ran the suite on Windows for 0.1.4, but Windows is not a supported platform: private files rely on POSIX file modes, voice has no Windows engine, and browser links and `doctor`'s fixes assume macOS or Linux |

package/dist/packages/mcp/assets/kb/docs/docs-getting-started.md

@@ -22,6 +22,6 @@ date: 2026-10-16
 
 Requirements, install, first run and dexterm doctor.
 
-dexterm is a terminal screener for Solana memecoins with a local Claude analyst. It runs on your machine, reads public data with no key and never holds a wallet key. Trading in dexterm is PAPER (see paper trading (https://dexterm.xyz/docs/paper-trading)); dexterm signs nothing, and live trading happens in a Telegram trading bot of your choice (see live trading (https://dexterm.xyz/docs/live-trading)). This page gets you from nothing to the live screener.
+dexterm is a terminal screener for Solana memecoins with a local Claude analyst. It runs on your machine, reads public data with no key and never holds a wallet key. Trading in dexterm is PAPER by default (see paper trading (https://dexterm.xyz/docs/paper-trading)) and dexterm signs nothing. Real mode is experimental; signals to your own executor; dexterm never holds a key; not financial advice (see real mode (https://dexterm.xyz/docs/real-mode) and live trading (https://dexterm.xyz/docs/live-trading)). This page gets you from nothing to the live screener.
 
-> note: Never used a terminal before? Start with the complete beginner guide (https://dexterm.xyz/docs/beginners). It defines every term, shows exactly what to copy on macOS, Linux and Windows, and ends with a ten-minute read-only coin review.
+> note: Never used a terminal before? Start with the complete beginner guide (https://dexterm.xyz/docs/beginners). It defines every term, shows exactly what to copy on macOS and Linux, and ends with a ten-minute read-only coin review.

package/dist/packages/mcp/assets/kb/docs/docs-larp-measured-accuracy.md

@@ -29,7 +29,7 @@ date: 2026-10-16
 
 - **LARP check, links only.** The links-based baseline is a weak signal: MCC 0.039 before tuning, 0.054 after. Its tuned `LARP` grade caught 4 of 14 bad coins, too few to rate. `EARLY_BUT_REAL` coins still went bad 10.3 % of the time, and coins with no website 29.2 %. The skill now treats the baseline as a weak prior and never calls `LARP` from links alone.
 - **Rug check.** The verdict rules improved from MCC 0.043 to 0.159. Liquidity under $5k is the one strong signal (`SPECULATIVE` coins went bad 54.8 % of the time, `WATCH` 14.4 %). Dev percentage, organic score and top-10 share did not predict a worse 72 h outcome and now only lower confidence.
-- **LARP score, link-shape part** (`dexterm backtest --subject larp-score`, task-1471). Points fitted on the train split only. On the 328 held-out coins its AUROC is 0.69 (0.73 on train): a modest ranking signal. 27 of 218 low-band coins went bad (12.4 %), 34 of 110 medium-band coins (30.9 %), against 18.6 % overall; no coin reaches the high band from link shape alone. The page, domain, GitHub and X points are not measured: that evidence was not recorded at the time, and looking it up now would leak the outcome (dead coins' sites and accounts disappear).
+- **LARP score, link-shape part** (`dexterm backtest --subject larp-score`). Points fitted on the train split only. On the 328 held-out coins its AUROC is 0.69 (0.73 on train): a modest ranking signal. 27 of 218 low-band coins went bad (12.4 %), 34 of 110 medium-band coins (30.9 %), against 18.6 % overall; no coin reaches the high band from link shape alone. The page, domain, GitHub and X points are not measured: that evidence was not recorded at the time, and looking it up now would leak the outcome (dead coins' sites and accounts disappear).
 - **Not measured.** The model stage (fetched pages, RDAP, GitHub) cannot be replayed: a past page cannot be fetched as it was. It is measured going forward with `dexterm backtest --subject larp`, below.
 
 The method, every number and the limits are in the repository at `packages/packs/eval/README.md`. A grade is a risk flag, not a certificate.
@@ -38,7 +38,7 @@ Measured 2026-10-12 with `dexterm backtest --subject larp` over this project's l
 
 | history | outcome labels at 1 h (observed) | LARP verdicts recorded | matched |
 |---|---|---|---|
-| research recorder (task-1287 prototype DB) | 149 (137 flat · 9 fade · 2 runner · 1 dead; 29 unobserved) | 0 | 0 |
+| research recorder (prototype DB) | 149 (137 flat · 9 fade · 2 runner · 1 dead; 29 unobserved) | 0 | 0 |
 | the app's recorder on the development machine | 0 | 0 | 0 |
 | the same, re-measured later that day after the recorder fix | 401 (361 flat · 18 dead · 13 runner · 5 fade · 4 rug; 1,206 unobserved) | 0 | 0 |
 

package/dist/packages/mcp/assets/kb/docs/docs-larp-paste-a-coin-on-the-web.md

@@ -26,7 +26,7 @@ date: 2026-10-16
 
 A no-install version is in preview at the preview checker (https://dexterm-larp-preview.dexterm-site.workers.dev/check/), not deployed to dexterm.xyz. Paste a Solana mint or a DexScreener / pump.fun / Solscan link and get the grade in your browser, read-only, no wallet. It runs on a Cloudflare Worker and reuses the app's tuned link-shape grade (`larp-links-v1`) and the same prompt firewall, so a hostile coin name or symbol is stripped and shown as inert text, never obeyed.
 
-What the web checker shows, each datum with its source and the age of the reading: the **LARP grade** from the coin's advertised link shape (`LARP` / `REAL?` / `UNKNOWN`), **top-10 holder concentration** and **holder count** (Jupiter), and **liquidity** in USD (DexScreener). It never shows a price, a market cap or a buy/sell call. A **shareable PNG card** carries the grade, those facts, the heuristic label and a dexterm.xyz link.
+What the web checker shows, each datum with its source and the age of the reading: the **LARP grade** from the coin's advertised link shape (`LARP` / `REAL?` / `UNKNOWN`), the **LARP score** from the same link shape with its top three reasons, **top-10 holder concentration** and **holder count** (Jupiter), and **liquidity** in USD (DexScreener). The web checker does not fetch the website, the domain, GitHub or the X account, so those count as not checked: the score shows how far they could still raise it ("12, could be up to 100") rather than treating them as clean. It never shows a price, a market cap or a buy/sell call. A **shareable PNG card** carries the grade, the score with its top three reasons, those facts, the heuristic label and a dexterm.xyz link.
 
 The preview defaults to the **keyless** tier. The full in-app LARP check above — fetching the website (SSRF-safe), the RDAP domain lookup and the GitHub read, graded by the analyst — is not part of the web checker. The bundle / sniper checkbox runs the app's wallet-intel rules and Helius history adapter as an optional second step, only when a dedicated site key and real Turnstile configuration are present. The visible preview test mode disables paid deep scans. Missing credentials refuse scans or disable the deep step; there is no silent test-secret fallback.
 

package/dist/packages/mcp/assets/kb/docs/docs-larp-the-larp-score.md

@@ -55,6 +55,6 @@ date: 2026-10-16
 
 **Missing data never lowers the score.** A page that could not be read, an RDAP or X lookup that failed, goes to a `missing` list with the points it could have added, and the result shows the range: "37, could be up to 58". Nothing unread is scored as clean.
 
-Where it shows: the `larp_check` MCP result (`score`, `band`, and `larp_score` with every flag, its points, its weight and its evidence, the range and the `missing` list; the existing fields are unchanged), the analyst panel after a LARP check (a gauge with the three biggest reasons, drawn from the tool's own result, never from the model's text).
+Where it shows: the `larp_check` MCP result (`score`, `band`, and `larp_score` with every flag, its points, its weight and its evidence, the range and the `missing` list; the existing fields are unchanged), the analyst panel after a LARP check (a gauge with the three biggest reasons, drawn from the tool's own result, never from the model's text), and the web checker's result and share card.
 
 > warn: a LARP verdict is a risk flag, not a certificate. Public HTML cannot prove a working product, a team's identity or who owns an account; domain age, a clean script scan and a GitHub with commits are evidence, not proof, and a real product can still go to zero.

package/dist/packages/mcp/assets/kb/docs/docs-narratives-how-coins-are-grouped.md

@@ -0,0 +1,39 @@
+---
+id: docs-narratives-how-coins-are-grouped
+title: Memes and narratives (experimental) › How coins are grouped
+kind: docs
+page: narratives
+page_title: Memes and narratives (experimental)
+heading: How coins are grouped
+anchor: how-coins-are-grouped
+url: https://dexterm.xyz/docs/narratives#how-coins-are-grouped
+tags:
+  - docs
+  - narratives
+  - coins
+  - are
+  - grouped
+  - memes
+  - experimental
+confidence: high
+owner: maintainers
+origin: docs-generated
+reviewed_by: generated@2026-10-16
+generated_from: dexterm/site content/docs (task-1420)
+sources:
+  - site/content/docs/narratives.md
+date: 2026-10-16
+---
+
+1. **Normalise** the name and ticker (and the description or social handles when the data layer has them): leetspeak
+   (`Z0RP`), repeated letters (`ZOOOORP`), camelCase (`ZorpWifHat`), emoji (🐸 → frog), glued tickers split against a
+   vocabulary learned from other names (`BABYZORP` → baby + zorp), and copy-cat affixes (`BABY`, `MINI`, `2.0`, `INU`,
+   `AI`) kept as weak words so "Baby X" lands next to X.
+2. **Embed** each coin with a local model. The default is built in: a hashed vector of the meme words, their letter
+   trigrams and the lexicon themes (dogs, politics, ai-agents, holiday-seasonal, …). An optional small open model,
+   all-MiniLM-L6-v2 on CPU through transformers.js, or any local Ollama embedding model, adds meaning links such as
+   kitty to cat (`DEXTERM_NARRATIVE_EMBEDDER=minilm` or `ollama`).
+3. **Cluster** incrementally in first-seen order. A coin joins the closest narrative it shares a meme word with (or, with
+   a semantic model, a currently hot one) if it is close enough to that narrative's centre and to the coin that started
+   it. Otherwise it starts a new narrative. Ids are stable (`nar_…`) and narratives never merge or split afterwards.
+   The label is the most common word or two-word phrase.

package/dist/packages/mcp/assets/kb/docs/docs-narratives-limits.md

@@ -0,0 +1,29 @@
+---
+id: docs-narratives-limits
+title: Memes and narratives (experimental) › Limits
+kind: docs
+page: narratives
+page_title: Memes and narratives (experimental)
+heading: Limits
+anchor: limits
+url: https://dexterm.xyz/docs/narratives#limits
+tags:
+  - docs
+  - narratives
+  - limits
+  - memes
+  - experimental
+confidence: high
+owner: maintainers
+origin: docs-generated
+reviewed_by: generated@2026-10-16
+generated_from: dexterm/site content/docs (task-1420)
+sources:
+  - site/content/docs/narratives.md
+date: 2026-10-16
+---
+
+- Name-based: themes that live only on X or Telegram are missed until a coin's name carries them.
+- Volume is each source's rolling window at the coin's newest sample; a coin not sampled for 6 h counts as zero.
+- Two themes that converge later stay two rows (ids never change).
+- The first build of the table reads the last 26 h of recorded history: tens of seconds on a large database (the screen stays live meanwhile).

package/dist/packages/mcp/assets/kb/docs/docs-narratives-what-is-measured.md

@@ -0,0 +1,44 @@
+---
+id: docs-narratives-what-is-measured
+title: Memes and narratives (experimental) › What is measured
+kind: docs
+page: narratives
+page_title: Memes and narratives (experimental)
+heading: What is measured
+anchor: what-is-measured
+url: https://dexterm.xyz/docs/narratives#what-is-measured
+tags:
+  - docs
+  - narratives
+  - measured
+  - memes
+  - experimental
+confidence: high
+owner: maintainers
+origin: docs-generated
+reviewed_by: generated@2026-10-16
+generated_from: dexterm/site content/docs (task-1420)
+sources:
+  - site/content/docs/narratives.md
+date: 2026-10-16
+---
+
+Per narrative and window (5 m, 1 h, 6 h, 24 h): coins seen, new coins and the new-coin rate, the narrative's share of all
+tracked volume, unique traders (1 h, Jupiter) and their growth, the top runner (sellable pool of at least 10k USD) and its drawdown
+from its peak, how often the same meme word was relaunched in the last hour, and a 0-100 **traction score** (1 h volume
+growth, spawn rate, repeated-name velocity, share of new-coin volume, breadth). Rank 1 is the highest score.
+**Cross-coin holder overlap is not recorded, so it is not part of the score** (it shows as null, never estimated).
+
+**Lifecycle**, first rule that matches:
+
+| state | rule |
+|---|---|
+| dead | no member sampled in 6 h, or 1 h volume under 1k USD with no new coin in 6 h |
+| spark | the first coin is under 1 h old |
+| ignition | 1 h volume ≥ 5k USD and ≥ 2× the 1 h volume an hour ago, with a new coin in the hour or unique traders +50% |
+| fading | 1 h volume ≤ 40% of its 24 h high, or ≤ 60% of an hour ago |
+| peak | otherwise: hot, near its 24 h high, growing under 2× |
+
+**Copy-cat saturation** (`*` in the table): at least 5 coins, at least 3 of them new in 6 h, and the coins after the 3
+oldest together hold under 25% of the narrative's 1 h volume. The copies are launching, but they are not getting the
+volume.

package/dist/packages/mcp/assets/kb/docs/docs-narratives-what-testing-showed.md

@@ -0,0 +1,43 @@
+---
+id: docs-narratives-what-testing-showed
+title: Memes and narratives (experimental) › What testing showed
+kind: docs
+page: narratives
+page_title: Memes and narratives (experimental)
+heading: What testing showed
+anchor: what-testing-showed
+url: https://dexterm.xyz/docs/narratives#what-testing-showed
+tags:
+  - docs
+  - narratives
+  - testing
+  - showed
+  - memes
+  - experimental
+confidence: high
+owner: maintainers
+origin: docs-generated
+reviewed_by: generated@2026-10-16
+generated_from: dexterm/site content/docs (task-1420)
+sources:
+  - site/content/docs/narratives.md
+date: 2026-10-16
+---
+
+We replayed 11 days of dexterm's recorded history (219,730 coins) through the tracker in time order, reading each
+coin's narrative at the first moment a scanner could act on it (point in time: nothing recorded after that moment),
+and tested it on days that were held back until the end, the same way as dexterm's other entry research.
+
+- **It is a useful map of what is running, not an edge.** On the held-back days, adding the narrative to a coin's own
+  numbers did not help tell apart the coins that later tripled (ranking quality fell slightly, by 0.022 (95% interval -0.059 to +0.008)) or the ones that drained
+  (fell by 0.033 (-0.052 to -0.015)).
+- **None of the narrative gates we fixed in advance improved paper results** when added to the existing entry rules:
+  joining an igniting narrative early, skipping the 5th or later copy of a saturated narrative, and skipping fading or
+  dead narratives. In the 22 combinations of these gates and rules with at least 20 paper entries, none raised the average result per entry and three lowered it. (One more gate, added after looking at the earlier days, is reported apart; its 5 combinations moved nothing either way.) Every gate also skipped some of the coins that went on to run.
+- **What it does describe:** a coin that is part of a narrative (two or more coins) drained within 6 hours about twice as often as a coin on its own (about 50% against 27% on the held-back days), and also tripled a little more often. Copy-cat waves are where both the runs and the drains happen. The lifecycle states themselves did not sort the outcomes: the share that later tripled was 4% to 6% in every state.
+- In a hand-graded sample of 100 narratives, 70 were coherent (one meme and its copies, or one theme) and the
+  label named the theme in 87. The usual mistakes: the same ticker reused for an unrelated coin, and a shared
+  generic word.
+
+Every number above comes with its sample size and a 95% interval in the study; the narratives table is a way to see
+what is running, and the numbers say it should not be read as a reason to trade.

package/dist/packages/mcp/assets/kb/docs/docs-narratives-where-to-find-it.md

@@ -0,0 +1,37 @@
+---
+id: docs-narratives-where-to-find-it
+title: Memes and narratives (experimental) › Where to find it
+kind: docs
+page: narratives
+page_title: Memes and narratives (experimental)
+heading: Where to find it
+anchor: where-to-find-it
+url: https://dexterm.xyz/docs/narratives#where-to-find-it
+tags:
+  - docs
+  - narratives
+  - where
+  - find
+  - memes
+  - experimental
+confidence: high
+owner: maintainers
+origin: docs-generated
+reviewed_by: generated@2026-10-16
+generated_from: dexterm/site content/docs (task-1420)
+sources:
+  - site/content/docs/narratives.md
+date: 2026-10-16
+---
+
+- The `N` screen opens the narrative board. Press `n` to switch between the theme board and the **NARRATIVES**
+  heat table. `enter` drills into a narrative's member coins; `esc` goes back to the table.
+- The token screen shows a **Narrative** row once the tracker has been built (open `N` then `n` first), for example
+  `ZORP · lifecycle: ignition · rank 3 · #2 of 9`.
+- `dexterm narratives` prints the heat table. `dexterm narratives detail ID` shows one narrative, `dexterm narratives of
+  MINT` shows the narrative of one coin, and `dexterm narratives export --out FILE` writes the JSON
+  (`dexterm-narratives/1`) that a strategy tracker page reads. `--at ISO` replays up to a past time.
+- MCP tools for your analyst or your own agent: `narratives_top`, `narrative_detail`, `narrative_of` (observe tier,
+  read-only). Coin names come back wrapped as untrusted data.
+- Watch rules: the field `narrative_rank` and the tags `narrative:ignition` / `narrative:saturated`, so a rule can fire
+  "when the coin's narrative ignites".

package/dist/packages/mcp/assets/kb/docs/docs-narratives.md

@@ -0,0 +1,29 @@
+---
+id: docs-narratives
+title: Memes and narratives (experimental)
+kind: docs
+page: narratives
+page_title: Memes and narratives (experimental)
+url: https://dexterm.xyz/docs/narratives
+tags:
+  - docs
+  - narratives
+  - memes
+  - experimental
+confidence: high
+owner: maintainers
+origin: docs-generated
+reviewed_by: generated@2026-10-16
+generated_from: dexterm/site content/docs (task-1420)
+sources:
+  - site/content/docs/narratives.md
+date: 2026-10-16
+---
+
+Groups coins by the theme their name and ticker carry, and measures each theme's heat per window. Measured heat, not advice.
+
+A memecoin does not need a real project to run. It moves on a theme: a ticker pun, an animal, a celebrity, an AI-agent
+craze, a holiday, or simply being a copy of a coin that just ran. The narratives tracker groups coins by that theme and
+measures how hot each one is right now. It is **experimental**, **keyless** and **local**. It adds no network requests,
+because it reads the history recorder, and it never calls a model. Everything it shows is **measured heat from recorded
+market data, not advice and not a prediction**.

package/dist/packages/mcp/assets/kb/docs/docs-overlay-before-you-start.md

@@ -0,0 +1,33 @@
+---
+id: docs-overlay-before-you-start
+title: Streamer overlay (OBS) › Before you start
+kind: docs
+page: overlay
+page_title: Streamer overlay (OBS)
+heading: Before you start
+anchor: before-you-start
+url: https://dexterm.xyz/docs/overlay#before-you-start
+tags:
+  - docs
+  - overlay
+  - before
+  - start
+  - streamer
+  - obs
+confidence: high
+owner: maintainers
+origin: docs-generated
+reviewed_by: generated@2026-10-16
+generated_from: dexterm/site content/docs (task-1420)
+sources:
+  - site/content/docs/overlay.md
+date: 2026-10-16
+---
+
+You need an agent session to watch. Pick one:
+
+- **An agent connected over MCP** (Claude Code, Cursor, Codex, …): run the app with `dexterm --spectate-mcp`. Your terminal follows the agent and opens the read-only spectator stream. See follow over MCP (https://dexterm.xyz/docs/spectator#follow-over-mcp-in-the-running-terminal).
+- **An agent on the loopback bus**: `dexterm agent serve --spectate`. See bring your own agent (https://dexterm.xyz/docs/agents).
+- **No agent, a dry run or a rehearsal**: a saved session with `--replay FILE` (record one with `dexterm agent serve --record FILE`). Every scene then carries a yellow **SAMPLE DATA · REPLAY** tag.
+
+The overlay finds the live stream on its own (the same `spectator.json` that `dexterm spectate --info` reads), waits for it if it is not up yet, and reconnects when it restarts.

package/dist/packages/mcp/assets/kb/docs/docs-overlay-limits.md

@@ -0,0 +1,30 @@
+---
+id: docs-overlay-limits
+title: Streamer overlay (OBS) › Limits
+kind: docs
+page: overlay
+page_title: Streamer overlay (OBS)
+heading: Limits
+anchor: limits
+url: https://dexterm.xyz/docs/overlay#limits
+tags:
+  - docs
+  - overlay
+  - limits
+  - streamer
+  - obs
+confidence: high
+owner: maintainers
+origin: docs-generated
+reviewed_by: generated@2026-10-16
+generated_from: dexterm/site content/docs (task-1420)
+sources:
+  - site/content/docs/overlay.md
+date: 2026-10-16
+---
+
+- **The scenes show what the agent did.** If the agent never reads holders, the holder bar stays "not read yet"; if it never runs a LARP check, there is no LARP line. Live signals appear only while your terminal follows the agent (`--spectate-mcp`) and has that coin's data.
+- **One coin at a time.** The coin card follows the coin the agent touched last; the PnL card follows the agent's newest paper fill.
+- **A reload needs a fresh URL** (see the OBS steps). This is the single-use ticket working as designed.
+- **The stream starts with the last 200 events** when the overlay connects, then follows live.
+- **Not financial advice.** The verdict, LARP evidence and signals are risk information, never a recommendation; paper results are simulated.

package/dist/packages/mcp/assets/kb/docs/docs-overlay-options.md

@@ -0,0 +1,36 @@
+---
+id: docs-overlay-options
+title: Streamer overlay (OBS) › Options
+kind: docs
+page: overlay
+page_title: Streamer overlay (OBS)
+heading: Options
+anchor: options
+url: https://dexterm.xyz/docs/overlay#options
+tags:
+  - docs
+  - overlay
+  - options
+  - streamer
+  - obs
+confidence: high
+owner: maintainers
+origin: docs-generated
+reviewed_by: generated@2026-10-16
+generated_from: dexterm/site content/docs (task-1420)
+sources:
+  - site/content/docs/overlay.md
+date: 2026-10-16
+---
+
+| Option | What it does |
+|---|---|
+| `--scene NAME` | `activity`, `coin`, `pnl` or `all`; repeat it for several. Default: the three scenes |
+| `--theme NAME` | `cyberspace` (phosphor green, the app's default look), `ice` (electric cyan) or `neon` (magenta). Default `cyberspace` |
+| `--replay FILE` | Play a saved spectator session instead of the live stream. Every scene says SAMPLE DATA |
+| `--speed N` | Replay speed (default 1); gaps between calls are capped at 5 s |
+| `--loop` | Replay again from the start; the final scenes hold for 10 s first |
+| `--ledger TRADE_ID` | The PnL scene shows one round trip from your own trade ledger (https://dexterm.xyz/docs/paper-trading#the-trade-ledger) (`dexterm ledger trades` lists the ids) instead of the agent's paper fills. `--sol-usd N` for a USD-booked trade |
+| `--port N` | A fixed loopback port (1024 to 65535) instead of a random one |
+| `--ticket-ttl MIN` | Minutes an unused URL stays valid (default 10) |
+| `--json` | Print the scene URLs as JSON |

package/dist/packages/mcp/assets/kb/docs/docs-overlay-security-model.md

@@ -0,0 +1,36 @@
+---
+id: docs-overlay-security-model
+title: Streamer overlay (OBS) › Security model
+kind: docs
+page: overlay
+page_title: Streamer overlay (OBS)
+heading: Security model
+anchor: security-model
+url: https://dexterm.xyz/docs/overlay#security-model
+tags:
+  - docs
+  - overlay
+  - security
+  - model
+  - streamer
+  - obs
+confidence: high
+owner: maintainers
+origin: docs-generated
+reviewed_by: generated@2026-10-16
+generated_from: dexterm/site content/docs (task-1420)
+sources:
+  - site/content/docs/overlay.md
+date: 2026-10-16
+---
+
+The overlay uses the same model as the popup windows (https://dexterm.xyz/docs/popup-chart):
+
+- **Loopback only.** The page server listens on `127.0.0.1` (a random port unless `--port`) and refuses any connection that is not from this machine.
+- **Single-use ticket, then a one-time token.** A URL carries a random 32-byte ticket that buys exactly one page load. That page holds a second, one-time token (valid 30 seconds) for its WebSocket. A spent or expired ticket, a ticket for another scene, or a forged token gets an empty 404.
+- **Host and Origin checks.** Every request must say `Host: 127.0.0.1:<port>` (so a DNS-rebinding page cannot reach it), and the WebSocket must come from the overlay's own origin. No CORS header is ever sent. Refused probes are printed in the overlay's terminal, without the ticket.
+- **No inbound control.** The socket only pushes scene data. Whatever a page sends is counted and dropped, never parsed or acted on; the overlay has nothing it could control.
+- **A locked-down page.** Its script and styles are inline under a per-page nonce; the content security policy allows no remote content, no fonts, no frames and no other connections. The page builds its text with `textContent` only (agent and coin text are untrusted), and the only image is the PnL card, sent over the socket.
+- **No new network.** The overlay talks to the spectator stream on loopback and reads your ledger file. It fetches nothing from the internet.
+
+The URL is printed in your own terminal so you can paste it; treat it like the popup URLs: it is loopback-only and single-use, but don't post a screenshot of a fresh one.

package/dist/packages/mcp/assets/kb/docs/docs-overlay-set-it-up-in-obs-step-by-step.md

@@ -0,0 +1,49 @@
+---
+id: docs-overlay-set-it-up-in-obs-step-by-step
+title: Streamer overlay (OBS) › Set it up in OBS, step by step
+kind: docs
+page: overlay
+page_title: Streamer overlay (OBS)
+heading: Set it up in OBS, step by step
+anchor: set-it-up-in-obs-step-by-step
+url: https://dexterm.xyz/docs/overlay#set-it-up-in-obs-step-by-step
+tags:
+  - docs
+  - overlay
+  - set
+  - obs
+  - step
+  - streamer
+confidence: high
+owner: maintainers
+origin: docs-generated
+reviewed_by: generated@2026-10-16
+generated_from: dexterm/site content/docs (task-1420)
+sources:
+  - site/content/docs/overlay.md
+date: 2026-10-16
+---
+
+1. Start the session you want to show (see above).
+2. In a second terminal, run:
+
+   ```sh
+   $ dexterm overlay --theme cyberspace
+   dexterm overlay · theme cyberspace · each URL works once, for 10 min
+     activity  http://127.0.0.1:53133/overlay/activity?p=…
+     coin      http://127.0.0.1:53133/overlay/coin?p=…
+     pnl       http://127.0.0.1:53133/overlay/pnl?p=…
+   ```
+
+   Leave it running for as long as you stream. `q` (or ctrl+c) stops it.
+3. In OBS, in your scene's **Sources** panel, click **+** and choose **Browser**. Name it (for example "dexterm coin") and click **OK**.
+4. In the properties window:
+   - **URL**: paste one of the printed URLs (the whole line after the scene name).
+   - **Width / Height**: `1240` × `420` for `coin` or `activity`, `1240` × `760` for `pnl`, `1600` × `1300` for `all`. Resize the source on the canvas afterwards; the scenes scale.
+   - Leave **Use custom frame rate** off.
+   - Leave **Custom CSS** as OBS fills it in (it keeps the background transparent) or empty.
+   - Untick **Shutdown source when not visible** and **Refresh browser when scene becomes active**: either one reloads the page, and a reload needs a fresh URL (see below).
+5. Click **OK**. The panel appears over your stream with a transparent background. Repeat steps 3 to 5 for the other scenes.
+6. To check the setup without a live agent, run `dexterm overlay --replay session.jsonl --loop` and watch the scenes fill in with the SAMPLE DATA tag on.
+
+**Each URL works once.** It is a single-use ticket: OBS's first load spends it, and the page then holds its own one-time connection. If OBS reloads the page, or you paste the URL into a second source, the page stays empty. Press **n** in the overlay's terminal for a fresh set of URLs and paste the new one into the source. URLs that are never loaded expire after 10 minutes (`--ticket-ttl MIN` changes that, 1 to 240). When you restart `dexterm overlay`, its port changes too, so paste fresh URLs then; `--port N` keeps the port fixed (the tickets still change).

package/dist/packages/mcp/assets/kb/docs/docs-overlay-the-pnl-scene-paper-and-live.md

@@ -0,0 +1,34 @@
+---
+id: docs-overlay-the-pnl-scene-paper-and-live
+title: Streamer overlay (OBS) › The PnL scene: PAPER and LIVE
+kind: docs
+page: overlay
+page_title: Streamer overlay (OBS)
+heading: The PnL scene: PAPER and LIVE
+anchor: the-pnl-scene-paper-and-live
+url: https://dexterm.xyz/docs/overlay#the-pnl-scene-paper-and-live
+tags:
+  - docs
+  - overlay
+  - pnl
+  - scene
+  - paper
+  - live
+  - streamer
+  - obs
+confidence: high
+owner: maintainers
+origin: docs-generated
+reviewed_by: generated@2026-10-16
+generated_from: dexterm/site content/docs (task-1420)
+sources:
+  - site/content/docs/overlay.md
+date: 2026-10-16
+---
+
+The card is the PnL card (https://dexterm.xyz/docs/paper-trading#pnl-cards) renderer itself, so its stamp, frame colour, stamp strip, provenance block, data ages and "not financial advice" footer are drawn exactly as on a saved card and cannot be turned off.
+
+- **The agent's trades are PAPER.** An agent can only paper-trade in dexterm, so a card built from the stream is always stamped **PAPER · SIMULATED TRADE · NO REAL FUNDS**, and the scene header says PAPER · SIMULATED. An open position is marked at the newest price the stream carried (converted to SOL at the rate the agent's own fill implies) or, without a later price, at the last fill; the card prints which, and how old the mark is.
+- **Your own ledger trades are PAPER or LIVE by wallet mode.** With `--ledger TRADE_ID` the stamp follows the trade's wallet mode: paper is PAPER, devnet is **LIVE · DEVNET** (test funds, not real money) and live is **LIVE · WALLET-SIGNED**, on the card and in the scene header alike. The LIVE note counts the trade's wallet-signed transactions. A real-mode row gets no card (dexterm only modelled that fill; your executor's receipt is the record). The ledger is a local file, read again every 30 seconds.
+- **Size is a band and the wallet never shows.** The mint is shortened and transaction signatures are left off the overlay card.
+- **A replay is SAMPLE DATA.** With `--replay`, a yellow SAMPLE DATA band sits across the top of the card, above the card's own stamp.

package/dist/packages/mcp/assets/kb/docs/docs-overlay-the-three-scenes.md

@@ -0,0 +1,35 @@
+---
+id: docs-overlay-the-three-scenes
+title: Streamer overlay (OBS) › The three scenes
+kind: docs
+page: overlay
+page_title: Streamer overlay (OBS)
+heading: The three scenes
+anchor: the-three-scenes
+url: https://dexterm.xyz/docs/overlay#the-three-scenes
+tags:
+  - docs
+  - overlay
+  - three
+  - scenes
+  - streamer
+  - obs
+confidence: high
+owner: maintainers
+origin: docs-generated
+reviewed_by: generated@2026-10-16
+generated_from: dexterm/site content/docs (task-1420)
+sources:
+  - site/content/docs/overlay.md
+date: 2026-10-16
+---
+
+| Scene | What it shows | Where the data comes from |
+|---|---|---|
+| `activity` | The agent's last calls: when, the agent, the tool, a one-line summary, and how old that call's data was | Every call the spectator stream carries |
+| `coin` | The coin the agent is on: ticker and shortened mint, price, the deterministic verdict with the rug heuristic, the LARP evidence flags, a top-10 holder bar with the holder count, and the live holder/rug signals, each with its age | The results of the agent's own `get_token`, `get_holders`, `get_dossier`, `analyze_token` and `larp_check` calls, plus the signals your terminal fires for that coin while it follows the agent |
+| `pnl` | The PnL card, drawn by the same renderer as the `H` key (PnL cards (https://dexterm.xyz/docs/paper-trading#pnl-cards)) | The agent's PAPER fills on the coin, or one trade from your own ledger with `--ledger` |
+
+`--scene all` puts the three scenes in one Browser source (two columns, the PnL card underneath) if you would rather crop one source than place three.
+
+Every scene shows how old its data is (`data age 12s`, and `… old` next to each figure). The scene's age chip turns yellow once its newest figure is over two minutes old. The LARP line says "evidence, not a verdict", and every page ends with "read-only · addresses redacted · not financial advice".

package/dist/packages/mcp/assets/kb/docs/docs-overlay-what-is-redacted.md

@@ -0,0 +1,31 @@
+---
+id: docs-overlay-what-is-redacted
+title: Streamer overlay (OBS) › What is redacted
+kind: docs
+page: overlay
+page_title: Streamer overlay (OBS)
+heading: What is redacted
+anchor: what-is-redacted
+url: https://dexterm.xyz/docs/overlay#what-is-redacted
+tags:
+  - docs
+  - overlay
+  - redacted
+  - streamer
+  - obs
+confidence: high
+owner: maintainers
+origin: docs-generated
+reviewed_by: generated@2026-10-16
+generated_from: dexterm/site content/docs (task-1420)
+sources:
+  - site/content/docs/overlay.md
+date: 2026-10-16
+---
+
+Redaction is always on, and the overlay applies it itself, whatever its source already did:
+
+- Every wallet or mint address becomes its first and last four characters (`Fixt…AAAA`), in every field: tool names, summaries, agent names, LARP evidence, signal text.
+- Key material (long base58 or hex runs) becomes `[key]`.
+- Anything the spectator stream marks sensitive is shown as `[sensitive]`, and sensitive-named fields are dropped before they reach a scene.
+- A coin, fill or ticket whose mint is not in the shortened shape is dropped, not shown.