dexterm-cli 0.1.5 → 0.1.7

package/dist/packages/mcp/assets/kb/app-help/screen-autotrade.md

@@ -0,0 +1,217 @@
+---
+id: screen-autotrade
+title: The autotrade (paper) screen
+kind: app-help
+screen: autotrade
+feature: autotrade-strategies
+tags:
+  - app-help
+  - screen
+  - autotrade
+  - the
+  - autotrade
+  - (paper)
+  - screen
+keys:
+  - q
+  - ctrl+c
+  - 1
+  - 2
+  - 3
+  - 4
+  - tab
+  - j
+  - down
+  - k
+  - up
+  - g
+  - home
+  - G
+  - end
+  - pagedown
+  - ctrl+f
+  - pageup
+  - ctrl+b
+  - enter
+  - esc
+  - backspace
+  - a
+  - v
+  - m
+  - ,
+  - <
+  - >
+  - ?
+  - t
+  - p
+  - $
+  - E
+  - w
+  - b
+  - y
+  - x
+  - P
+  - Z
+  - R
+  - T
+  - K
+  - N
+  - O
+  - U
+  - ctrl+w w
+  - ctrl+w n
+  - ctrl+w tab
+  - ctrl+w N
+  - ctrl+w s
+  - ctrl+w m
+  - ctrl+w o
+  - ctrl+w d
+  - ctrl+r
+  - Q
+  - n
+  - d
+  - e
+  - c
+  - i
+  - r
+  - s
+  - u
+  - !
+  - f
+  - o
+actions:
+  - quit
+  - screen.screener
+  - screen.newpairs
+  - screen.watchlist
+  - screen.analyst
+  - screen.next
+  - move.down
+  - move.up
+  - move.top
+  - move.bottom
+  - move.pagedown
+  - move.pageup
+  - open
+  - back
+  - analyst.toggle
+  - voice.talk
+  - voice.mute
+  - voice.cycle
+  - voice.rate
+  - help.toggle
+  - theme.next
+  - pause.toggle
+  - display.priceMode
+  - export.view
+  - watch.add
+  - alert.propose
+  - alert.confirm
+  - alert.dismiss
+  - screen.positions
+  - scan.toggle
+  - scan.resume
+  - screen.trending
+  - social.kol
+  - screen.narrative
+  - screen.plans
+  - screen.follows
+  - workspace.list
+  - workspace.next
+  - workspace.prev
+  - workspace.save
+  - workspace.morning
+  - workspace.popups
+  - workspace.default
+  - screen.rules
+  - screen.autotrade
+  - autotrade.view
+  - autotrade.new
+  - autotrade.dup
+  - autotrade.edit
+  - autotrade.compare
+  - autotrade.backtest
+  - autotrade.sweep
+  - autotrade.export
+  - autotrade.import
+  - autotrade.run
+  - autotrade.save
+  - autotrade.undo
+  - autotrade.kill
+  - autotrade.pause
+  - autotrade.flatten
+  - autotrade.proposal
+tools:
+  - strategy_list
+  - autotrade_status
+confidence: high
+owner: maintainers
+origin: app-help-generated
+reviewed_by: generated@2026-10-16
+generated_from: dexterm/app keymap + overlay + mcp tools (task-1413)
+sources:
+  - packages/tui/src/keymap.ts
+  - packages/cli/src/screens/overlay.ts
+date: 2026-10-16
+---
+
+Press `Q` anywhere for AUTOTRADE, paper only. tab cycles five views: STRATEGIES (the presets and your own files with mode, version, hash and the last backtest), EDITOR (one form in six sections: entry, exits, risk, sizing, agent, execution; every change re-validates, errors show inline with their path, the screen filter is checked by the screener's own parser and its error column is marked; `s` saves only a valid draft as a new version, `u` undoes), COMPARE (two marked strategies side by side, changed fields first, both backtested on the same tape), BACKTEST (the report with attribution, an equity sparkline, clamps, refusals and the limits box; `w` runs a sweep whose verdict comes from coins it never tuned on) and RUNNER (the paper runner's heartbeat, halt reason, candidates, sessions, positions and ledger tail). Presets are read-only: `d` makes your own copy. Nothing on this screen switches a strategy to live, arms a mandate or touches a wallet. A strategy edit the analyst proposed in chat shows as a card: `o` opens its diff, `y` applies it, and a LOOSER edit (any risk number less safe) needs a second `y` on the less-safe popup.
+
+Keys on this screen:
+  `q/^C` — quit
+  `1` — screener
+  `2` — new pairs
+  `3` — watchlist
+  `4` — analyst
+  `j/↓` — move
+  `k/↑` — move
+  `g/home` — top
+  `G/end` — bottom
+  `PgDn/^F` — page
+  `PgUp/^B` — page
+  `⏎` — open
+  `esc/⌫` — back
+  `a` — ask claude
+  `v` — voice
+  `m` — mute voice
+  `,` — change voice
+  `</>` — slower / faster voice
+  `?` — help
+  `t` — theme
+  `$` — price ⇄ mcap
+  `E` — export PNG + report
+  `y` — confirm alert
+  `P` — positions
+  `Z` — AI scan
+  `R` — resume scan
+  `T` — trending
+  `K` — KOL lists
+  `N` — narrative board
+  `O` — order plans
+  `U` — followed wallets
+  `^W w` — workspaces
+  `^W n/^W tab` — next workspace
+  `^W N` — previous workspace
+  `^W s` — save workspace
+  `^W m` — morning HUD
+  `^W o` — open workspace popups
+  `^W d` — default workspace
+  `^R` — rules
+  `Q` — autotrade (paper)
+  `tab` — next view
+  `n` — new from preset
+  `d` — duplicate
+  `e` — edit
+  `c` — mark to compare
+  `b` — backtest
+  `w` — sweep (held-out)
+  `x` — export file
+  `i` — import file
+  `r` — runner
+  `s` — save (new version)
+  `u` — undo
+  `!` — kill (soft stop)
+  `p` — pause new entries
+  `f` — flatten (confirm)
+  `o` — review chat proposal
+  `?` — this help

package/dist/packages/mcp/assets/kb/app-help/screen-kol.md

@@ -72,6 +72,7 @@ keys:
   - ctrl+w o
   - ctrl+w d
   - ctrl+r
+  - Q
 actions:
   - quit
   - screen.screener
@@ -123,6 +124,7 @@ actions:
   - workspace.popups
   - workspace.default
   - screen.rules
+  - screen.autotrade
 confidence: high
 owner: maintainers
 origin: app-help-generated
@@ -186,5 +188,6 @@ Keys on this screen:
   `^W o` — open workspace popups
   `^W d` — default workspace
   `^R` — rules
+  `Q` — autotrade (paper)
   `c` — calm mode (effects off)
   `?` — this help

package/dist/packages/mcp/assets/kb/app-help/screen-newpairs.md

@@ -68,6 +68,7 @@ keys:
   - ctrl+w o
   - ctrl+w d
   - ctrl+r
+  - Q
 actions:
   - quit
   - screen.screener
@@ -115,6 +116,7 @@ actions:
   - workspace.popups
   - workspace.default
   - screen.rules
+  - screen.autotrade
 tools:
   - screener_query
 confidence: high
@@ -177,5 +179,6 @@ Keys on this screen:
   `^W o` — open workspace popups
   `^W d` — default workspace
   `^R` — rules
+  `Q` — autotrade (paper)
   `c` — calm mode (effects off)
   `?` — this help

package/dist/packages/mcp/assets/kb/app-help/screen-positions.md

@@ -69,6 +69,7 @@ keys:
   - ctrl+w o
   - ctrl+w d
   - ctrl+r
+  - Q
 actions:
   - quit
   - screen.screener
@@ -116,6 +117,7 @@ actions:
   - workspace.popups
   - workspace.default
   - screen.rules
+  - screen.autotrade
 tools:
   - paper_positions
   - paper_pnl
@@ -179,5 +181,6 @@ Keys on this screen:
   `^W o` — open workspace popups
   `^W d` — default workspace
   `^R` — rules
+  `Q` — autotrade (paper)
   `c` — calm mode (effects off)
   `?` — this help

package/dist/packages/mcp/assets/kb/app-help/screen-screener.md

@@ -76,6 +76,7 @@ keys:
   - ctrl+w o
   - ctrl+w d
   - ctrl+r
+  - Q
 actions:
   - quit
   - screen.screener
@@ -128,6 +129,7 @@ actions:
   - workspace.popups
   - workspace.default
   - screen.rules
+  - screen.autotrade
 tools:
   - screener_query
 confidence: high
@@ -195,5 +197,6 @@ Keys on this screen:
   `^W o` — open workspace popups
   `^W d` — default workspace
   `^R` — rules
+  `Q` — autotrade (paper)
   `c` — calm mode (effects off)
   `?` — this help

package/dist/packages/mcp/assets/kb/app-help/screen-token.md

@@ -63,6 +63,7 @@ keys:
   - T
   - L
   - C
+  - A
   - I
   - F
   - Z
@@ -83,6 +84,7 @@ keys:
   - ctrl+w o
   - ctrl+w d
   - ctrl+r
+  - Q
 actions:
   - quit
   - screen.screener
@@ -132,6 +134,7 @@ actions:
   - open.tg
   - open.links
   - popup.chart
+  - display.chartAxis
   - popup.token
   - tape.toggle
   - scan.toggle
@@ -152,6 +155,7 @@ actions:
   - workspace.popups
   - workspace.default
   - screen.rules
+  - screen.autotrade
 tools:
   - get_dossier
   - get_token
@@ -218,6 +222,7 @@ Keys on this screen:
   `T` — open TG
   `L` — links
   `C` — chart popup
+  `A` — chart axis mcap ⇄ price
   `I` — token popup
   `F` — flow ⇄ tape
   `Z` — AI scan
@@ -237,5 +242,6 @@ Keys on this screen:
   `^W o` — open workspace popups
   `^W d` — default workspace
   `^R` — rules
+  `Q` — autotrade (paper)
   `c` — calm mode (effects off)
   `?` — this help

package/dist/packages/mcp/assets/kb/app-help/screen-trending.md

@@ -71,6 +71,7 @@ keys:
   - ctrl+w o
   - ctrl+w d
   - ctrl+r
+  - Q
 actions:
   - quit
   - screen.screener
@@ -123,6 +124,7 @@ actions:
   - workspace.popups
   - workspace.default
   - screen.rules
+  - screen.autotrade
 tools:
   - narrative_board
 confidence: high
@@ -188,5 +190,6 @@ Keys on this screen:
   `^W o` — open workspace popups
   `^W d` — default workspace
   `^R` — rules
+  `Q` — autotrade (paper)
   `c` — calm mode (effects off)
   `?` — this help

package/dist/packages/mcp/assets/kb/app-help/screen-watchlist.md

@@ -68,6 +68,7 @@ keys:
   - ctrl+w o
   - ctrl+w d
   - ctrl+r
+  - Q
 actions:
   - quit
   - screen.screener
@@ -116,6 +117,7 @@ actions:
   - workspace.popups
   - workspace.default
   - screen.rules
+  - screen.autotrade
 confidence: high
 owner: maintainers
 origin: app-help-generated
@@ -177,5 +179,6 @@ Keys on this screen:
   `^W o` — open workspace popups
   `^W d` — default workspace
   `^R` — rules
+  `Q` — autotrade (paper)
   `c` — calm mode (effects off)
   `?` — this help

package/dist/packages/mcp/assets/kb/app-help/spectate-an-agent.md

@@ -22,6 +22,7 @@ commands:
 flags:
   - --replay
   - --spectate-mcp
+  - --spectate-thoughts
 confidence: high
 owner: maintainers
 origin: app-help-generated
@@ -34,6 +35,6 @@ sources:
 date: 2026-10-16
 ---
 
-Watch an agent work. For an agent on the loopback bus, `dexterm agent serve --spectator-popup` opens the AGENT ACTIVITY window, `--spectate` starts the read-only, token-gated, loopback stream, and `--record FILE` saves a redacted session. For an agent connected over MCP (`dexterm mcp install`), run the app with `dexterm --spectate-mcp`: the running terminal then follows the agent — a navigation call moves the screen, a status line shows `agent <name>: opened <coin>`, ctrl+p pauses, ctrl+k stops and any key you press takes control. `dexterm spectate --replay FILE` replays a saved session step by step and `dexterm spectate --info` shows the live stream endpoint. Every shared copy is redacted — a tool name, refusal, agent line or navigation can never leak a wallet or key — and a spectator can only watch, never act. Full docs: https://dexterm.xyz/docs/spectator/
+Watch an agent work. For an agent on the loopback bus, `dexterm agent serve --spectator-popup` opens the AGENT ACTIVITY window, `--spectate` starts the read-only, token-gated, loopback stream, and `--record FILE` saves a redacted session. For an agent connected over MCP (`dexterm mcp install`), run the app with `dexterm --spectate-mcp`: the running terminal follows the agent and an agent dock appears under the screen — a phase rail (SCANNING > VETTING > SIZING > EXECUTING > HOLDING > EXITING) with a heartbeat, the call timeline with result chips, the rows it scans glow and a cursor marks the coin it opens, a vetting card fills its checks and LARP evidence, and a PAPER trade shows its ticket, the fill, a live position with the mark PnL and a result card. `--spectate-thoughts FILE` streams the agent's own words into a thought ribbon from a JSONL file it writes (for example `claude -p --output-format stream-json`); display only. PAPER is always on screen; ctrl+p pauses, ctrl+k kills (a hard stop) and any key you press takes control; calm mode drops the motion. While the agent is active, the token screen's analyst panel is its BRAIN VIEW: the reasoning stream with phase tags (or dexterm's narration when there is no thoughts feed), the vetting checklist with the app's numbers and pass/warn/fail/pending, a data strip, the PAPER plan and position, and the session's decision log with a simulated scoreboard. While it holds a PAPER position, a PnL chip shows coin, PnL, entry to mark, peak, drawdown, time held and the take-profit it said, on every terminal screen (in the dock, or on the band under the header on terminals under 24 rows) and on the chart popup; display only. `dexterm spectate --replay FILE` replays a saved session step by step and `dexterm spectate --info` shows the live stream endpoint. Every shared copy is redacted — a tool name, refusal, agent line or navigation can never leak a wallet or key — and a spectator can only watch, never act. Full docs: https://dexterm.xyz/docs/spectator/
 
 CLI: `dexterm spectate`.

package/dist/packages/mcp/assets/kb/app-help/standing-mandates.md

@@ -28,6 +28,6 @@ sources:
 date: 2026-10-16
 ---
 
-`dexterm mandate list|add|remove|arm|disarm` sets a standing mandate — a longer-lived conditional rule bounded by a budget. As with plans, a model may only PROPOSE; arming needs your physical keypress and the signer-side caps bound it. The analyst can never arm a mandate or change its caps.
+`dexterm mandate list|add|remove|arm|disarm` sets a standing mandate — a longer-lived conditional rule bounded by a budget. As with plans, a model may only PROPOSE; arming needs your physical keypress and its caps bound it; fills are PAPER. The analyst can never arm a mandate or change its caps.
 
 CLI: `dexterm mandate`.

package/dist/packages/mcp/assets/kb/app-help/trade-ledger.md

@@ -0,0 +1,54 @@
+---
+id: trade-ledger
+title: See every trade in one ledger: win rate, profiles, exit reasons, strategy versions (dexterm ledger)
+kind: app-help
+screen: all
+feature: trade-ledger
+tags:
+  - app-help
+  - ledger
+  - journal
+  - trades
+  - history
+  - results
+  - stats
+  - win
+  - rate
+  - drawdown
+  - profile
+  - exit
+  - reason
+  - compare
+  - export
+  - csv
+  - equity
+  - mfe
+  - mae
+commands:
+  - ledger
+tools:
+  - ledger_trades
+  - ledger_positions
+  - ledger_summary
+  - ledger_equity
+  - ledger_compare
+  - candidate_dossier
+  - outcomes_lookup
+  - trading_status
+  - telegram_status
+  - backtest_requests
+confidence: high
+owner: maintainers
+origin: app-help-generated
+reviewed_by: generated@2026-10-16
+generated_from: dexterm/app keymap + overlay + mcp tools + cli (task-1413)
+sources:
+  - packages/tui/src/keymap.ts
+  - packages/cli/src/main.ts
+  - packages/mcp/src/server.ts
+date: 2026-10-16
+---
+
+`dexterm ledger trades` lists every round trip dexterm booked, from the paper ticket, the agent paper desk and autotrade runs, newest first: strategy version, the exit profile and entry reason it was opened with (marked * when not declared with the fill), the exit reason, size and % of book, entry and exit market cap, P/L, hold and MFE/MAE. `positions` shows the open ones. `summary` gives the win rate with its 95% interval, P/L, profit factor, drawdown and rug rate by profile, exit reason, strategy, source and mode; `equity` the realized equity curve; `compare` strategy versions side by side (for strategies run in parallel); `export csv|json|parquet-lite [--out FILE]`; `card <tradeId>` a PnL card from a row. Filters: --source, --mode paper|devnet|live, --strategy id[@version], --profile, --exit, --mint, --run, --days, --status. Reads never write; `dexterm ledger sync` appends to ~/.dexterm/ledger/trades.jsonl (sha256-chained) and `dexterm ledger verify` names the first edited line. Agents read the same rows with the read-only ledger_* tools; `trading_status` and `telegram_status` show settings and state, never a key, address, exact balance, bot token or chat id. A backtest an agent asks for (backtest_request) only runs when you run it: `dexterm autotrade requests`. PAPER rows are simulated; filter by --mode before comparing. Not financial advice. Full docs: https://dexterm.xyz/docs/paper-trading/#the-trade-ledger
+
+CLI: `dexterm ledger`.

package/dist/packages/mcp/assets/kb/app-help/use-local-model.md

@@ -0,0 +1,38 @@
+---
+id: use-local-model
+title: Run dexterm's AI on a free local model (Ollama)
+kind: app-help
+screen: all
+feature: analyst
+tags:
+  - app-help
+  - ollama
+  - local
+  - model
+  - free
+  - offline
+  - engine
+  - llama
+  - qwen
+  - restrictions
+  - privacy
+commands:
+  - ai
+  - ask
+flags:
+  - --analyst-engine
+confidence: high
+owner: maintainers
+origin: app-help-generated
+reviewed_by: generated@2026-10-16
+generated_from: dexterm/app keymap + overlay + mcp tools + cli (task-1413)
+sources:
+  - packages/tui/src/keymap.ts
+  - packages/cli/src/main.ts
+  - packages/mcp/src/server.ts
+date: 2026-10-16
+---
+
+dexterm's AI can run on a free model on your own machine through Ollama: no login, no key, $0 per answer, and it talks only to http://127.0.0.1:11434 by default. Set it up in two minutes: install Ollama (https://ollama.com/download), `ollama pull qwen3:8b`, `dexterm ai engine ollama`, `dexterm ai model qwen3:8b`, then `dexterm doctor` (the Ollama line should pass). In the chat box `/engine ollama` switches new conversations, `/engine claude` switches back; `--analyst-engine ollama` and `DEXTERM_ANALYST_ENGINE=ollama` work too, and `dexterm ai engine ollama --surface autotrade` picks one surface. The local engine uses the same dexterm tools and the same firewalled context as Claude. What it may do is your restriction profile: `observe` (analyse only), `propose` (the default for a new setup: UI actions, a PAPER ticket you confirm, strategy proposals you apply), `paper` (adds paper autotrade sessions and agent paper trading in a mandate you armed: `dexterm ai restrictions paper`), `full` (only after `dexterm ai engine ollama --full` and typing ENABLE FULL, for one model). Caps, the kill switch, mandate tiers, live gating and Telegram buttons are enforced outside the model for every engine. `dexterm ai probe --json` checks tool calling, context and decision formatting; a model without tools answers from the dossier dexterm fetches and says so. Paper autotrade on it: `dexterm autotrade run <strategy> --paper --engine ollama`. Headless: `dexterm ask "question"`, `dexterm ai agent "goal"`. Docs: https://dexterm.xyz/docs/ollama/
+
+CLI: `dexterm ai`, `dexterm ask`.

package/dist/packages/mcp/assets/kb/docs/docs-agents-agent-paper-trading.md

@@ -29,21 +29,25 @@ date: 2026-10-16
 
 Two steps, both yours:
 
-1. Draft and arm a mandate (`dexterm mandate draft` / `arm`, or the plans screen). Its caps are per-trade, per-coin and total size, a loss limit, open positions, price impact, allowed sides and an optional mint allow-list, and arming needs a physical keypress.
+1. Draft and arm a mandate (`dexterm mandate draft` / `arm`, or the plans screen). Its caps are per-trade, per-coin and total size, a loss limit, open positions, price impact, allowed sides and an optional mint allow-list, and arming needs a physical keypress. For bigger simulated sizes, draft a **paper-only** mandate with `dexterm mandate draft --paper` (see paper-only mandates (https://dexterm.xyz/docs/paper-trading#paper-only-mandates)): only the agent paper desk can use it.
 2. Start the terminal with the agent activity view and name that mandate: `dexterm --spectate-mcp --agent-paper <mandate-id>`. Quitting turns it off again.
 
-While it is on, the agent can use six tools:
+While it is on, the agent can use seven tools:
 
 - `paper_open_ticket` opens a simulated ticket for a mint and side. It stays inert until confirmed.
 - `paper_size_ticket` sets the simulated size. A buy over any cap is **refused**, never clamped up.
 - `paper_confirm` re-checks the caps and your controls, fetches a fresh keyless quote and books the simulated fill.
-- `paper_close` closes a fraction of a held simulated position.
+- `paper_close` closes a fraction of a held simulated position. If the keyless quote for that close is rate-limited, the desk waits briefly and asks for a fresh quote by itself (up to 4 tries in about 25 seconds, each retry shown in the agent activity) and books the fill on that later quote, never on an old one.
 - `paper_positions` and `paper_pnl` read the simulated positions and PnL. They are read-only.
+- `paper_tag` records a declaration apart from a fill: a REPROFILE while it holds a coin, or a PROFILE / EXIT it did not pass with the fill (marked as declared late). It books nothing.
+
+`paper_confirm` takes the exit profile and the entry reason (`profile`, `reason`) and `paper_close` the exit reason (`exit_reason`, `reason`) as typed fields, or the verbatim PROFILE / EXIT line in `tag_line`. They go to the trade ledger (https://dexterm.xyz/docs/paper-trading#the-trade-ledger) with the fill, so your results can be read by profile and by exit reason.
 
 The guarantees, each covered by tests:
 
 - **It can never sign or send.** No MCP tool can build, sign or send a real transaction, touch a wallet or key, or change a cap. The paper tools book the simulated ledger only. A registry test enumerates every MCP tool, fails on any tool not on its reviewed allow-list, and checks that the paper path imports nothing that signs, sends or arms.
 - **Caps come from your mandate.** The agent's tools never carry caps: on every call the server re-reads the mandate from the hash-chained plans journal you armed it in, and a journal that fails its hash check is refused. That protects the mandate from the agent's tools; it is not tamper-proofing against other software running as your own user. The agent runs at the most restricted confirmation tier, so its per-trade cap is a quarter of the mandate's. Revoking the mandate, letting it expire or pressing the panic key stops the agent on its next call.
+- **The terminal shows what the agent looks at.** While you follow it, `open_token` from the agent moves your screen to coins it was shown by its own reads (the screen, `screener_query`, `narrative_board`) or holds a paper position in, view-only.
 - **You stay in control, and you see everything.** Every call and every refusal shows in this terminal's agent activity, labelled PAPER, and is appended to its own hash-chained audit journal. Ctrl+P pauses and resumes, Ctrl+K stops it for the rest of the run, and any key while the agent is driving takes over; all of them halt its paper calls. Trading calls are refused while nothing is watching.
 - **Only the agent you connected.** The in-app analyst and the scan never get the paper tools. The loopback agent bus does not offer them either.
 

package/dist/packages/mcp/assets/kb/docs/docs-agents-reading-your-trade-ledger.md

@@ -0,0 +1,31 @@
+---
+id: docs-agents-reading-your-trade-ledger
+title: Bring your own agent › Reading your trade ledger
+kind: docs
+page: agents
+page_title: Bring your own agent
+heading: Reading your trade ledger
+anchor: reading-your-trade-ledger
+url: https://dexterm.xyz/docs/agents#reading-your-trade-ledger
+tags:
+  - docs
+  - agents
+  - reading
+  - trade
+  - ledger
+  - bring
+  - own
+  - agent
+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/agents.md
+date: 2026-10-16
+---
+
+Any connected agent can read the trade ledger (https://dexterm.xyz/docs/paper-trading#the-trade-ledger) with the same read-only tools as the rest of the data: `ledger_trades`, `ledger_positions`, `ledger_summary`, `ledger_equity` and `ledger_compare`, plus `candidate_dossier` (what an autotrade run saw and decided about one coin) and `outcomes_lookup` (what a coin, or every candidate of a run, turned into). `trading_status` and `telegram_status` describe your live signer and your Telegram bot: settings and state only, never a key, a seed, an address, an exact balance, a bot token or a chat id.
+
+`backtest_request` lets an agent ask for a longer backtest than `strategy_backtest` runs. It only files the request: you see it with `dexterm autotrade requests` and run or dismiss it yourself, and the agent reads the one-line result with `backtest_requests`.

package/dist/packages/mcp/assets/kb/docs/docs-agents-untrusted-by-default.md

@@ -31,6 +31,6 @@ Every agent is treated as potentially compromised or buggy:
 - **The gate.** One function every call passes on every transport: session open, name not on the never-list, tier sufficient, inside any mandate, arguments valid against a **closed** schema and within a size cap, rate limits and quotas with room, and an idempotency key on every proposal.
 - **Rate, quota and flood control.** Reads/min, navigation/10s and proposals/hour are per agent; sustained refusals trip a breaker that auto-pauses the agent.
 - **Prompt firewall.** Every untrusted string an agent receives (token names, bios, tweets, fetched page text) is wrapped and sanitised; terminal-escape, bidi-override and zero-width characters are stripped from every result, event and audit line.
-- **Proposals, never actions.** An order-plan proposal is a draft with `armed: false`, full stop; only your physical keypress arms it, and the signer-side caps still apply.
+- **Proposals, never actions.** An order-plan proposal is a draft with `armed: false`, full stop; only your physical keypress arms it, and it fills on paper.
 - **Roster + audit.** The roster popup lists every connected agent (name, tier, last activity, reads/proposals, rate usage) with per-agent **pause** and **kick**, and the full audit log records every connect, call, refusal, proposal and disconnect.
 - **Watching adds no power.** The spectator view (https://dexterm.xyz/docs/spectator) only observes calls the gate already allowed or refused; its stream has no inbound command path and its window can send only pause, resume, take over and kill.

package/dist/packages/mcp/assets/kb/docs/docs-analyst-if-claude-is-missing.md

@@ -22,4 +22,4 @@ sources:
 date: 2026-10-16
 ---
 
-The panel shows a one-line fix (`npm i -g @anthropic-ai/claude-code && claude login`) and the rest of dexterm keeps working. `dexterm doctor` reports the Claude CLI line as a warning, not a failure. With Codex installed, `auto` runs the analyst on Codex instead.
+The panel says to set up an AI backend, with both ways in one line (`npm i -g @anthropic-ai/claude-code && claude login`, or a free local model with Ollama), and the rest of dexterm keeps working. `dexterm doctor` reports the Claude CLI line as a warning, not a failure. With Codex installed, `auto` runs the analyst on Codex instead; with neither but a local model (https://dexterm.xyz/docs/ollama) set up, on the local model.

package/dist/packages/mcp/assets/kb/docs/docs-analyst-starting-a-run.md

@@ -30,4 +30,6 @@ Nothing runs behind your back. Opening a token with `⏎` is free. A paid run st
 - type a question (`i` or `⏎` to focus, `⏎` to send). A question is a chat turn on the warm session, or a new session with that question as its first turn, never a structured skill run;
 - let AI scan mode (https://dexterm.xyz/docs/scan) lock a coin.
 
+In an auto mode (following an agent with `--spectate-mcp`, or AI scan mode (https://dexterm.xyz/docs/scan#the-read)), the token screen's analyst panel shows the brain view (https://dexterm.xyz/docs/spectator#the-brain-view-and-the-pnl-chip) until you type into it.
+
 Each token keeps its own conversation for the run; the analyst tab has its own. `esc` interrupts a running answer from any screen. The caption under an answer shows cost, latency, tool calls and the model.

package/dist/packages/mcp/assets/kb/docs/docs-analyst-use-a-local-model-instead.md

@@ -0,0 +1,27 @@
+---
+id: docs-analyst-use-a-local-model-instead
+title: The analyst › Use a local model instead
+kind: docs
+page: analyst
+page_title: The analyst
+heading: Use a local model instead
+anchor: use-a-local-model-instead
+url: https://dexterm.xyz/docs/analyst#use-a-local-model-instead
+tags:
+  - docs
+  - analyst
+  - use
+  - local
+  - model
+  - instead
+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/analyst.md
+date: 2026-10-16
+---
+
+The analyst can also run on **a free model on your own machine** through Ollama: no login, no key, $0 per answer, and with the default host (`127.0.0.1`) nothing leaves the machine. `dexterm ai engine ollama`, `--analyst-engine ollama` or `/engine ollama` in the chat box. Same tools, same firewalled context, same skills; what the local engine may do is set by a restriction profile you choose. See Use a local model with Ollama (https://dexterm.xyz/docs/ollama).

package/dist/packages/mcp/assets/kb/docs/docs-analyst-what-it-sees.md

@@ -23,4 +23,6 @@ date: 2026-10-16
 
 Every turn carries a firewalled **CONTEXT** block: the screen you are on, the filter and sort, the selected or hovered coin, the visible rows (price, change, liquidity, volume), your watchlist, and any open PAPER ticket or position. So "this coin", "it" and "the highlighted one" resolve without asking. Token names, descriptions, socials, RugCheck text and fetched page text are wrapped as `<untrusted>` data before the model sees them; instruction-like text inside such a block is itself reported as a red flag (`injection_detected`) and never followed.
 
+**It talks in market cap.** By default the analyst speaks the way traders do: the cap at entry and the cap now, targets and stops as market-cap levels, moves as x-multiples ("in at $69.7K, now $264.9K, 3.8x"); its live snapshot leads with the market cap and reads the price history as caps at the current supply. With the price display mode (https://dexterm.xyz/docs/configuration#price-display-mode) set to price (`$` or `/display price`) it switches to USD price on the next turn. A coin without a known supply is discussed in price, and it says so.
+
 Facts come only from tools. The system prompt forbids token facts from model memory: every number, address, flag and level must come from a tool result in the session, each carrying its source and age. The knowledge base explains mechanics and patterns; it never holds a fact about a live token.