dexterm-cli 0.1.1 → 0.1.3

package/dist/packages/mcp/assets/kb/app-help/narrative-board.md

@@ -0,0 +1,32 @@
+---
+id: narrative-board
+title: See the narrative board (dexterm narrative)
+kind: app-help
+screen: trending
+feature: trending-board
+tags:
+  - app-help
+  - narrative
+  - narratives
+  - board
+  - trending
+  - movers
+  - window
+  - summary
+commands:
+  - narrative
+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 narrative [--window 1h|24h] [--summary]` prints the narrative board — what is trending across the recorded feed — with no network and no model. In-app it is the trending screen.
+
+CLI: `dexterm narrative`.

package/dist/packages/mcp/assets/kb/app-help/open-a-coin.md

@@ -0,0 +1,43 @@
+---
+id: open-a-coin
+title: Open / paste a coin (contract address or link)
+kind: app-help
+screen: all
+feature: go-to-coin
+tags:
+  - app-help
+  - paste
+  - open
+  - coin
+  - contract
+  - address
+  - ca
+  - link
+  - pump
+  - dexscreener
+  - solscan
+  - go
+  - goto
+keys:
+  - g
+actions:
+  - goto.open
+flags:
+  - --mint
+tools:
+  - open_token
+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
+---
+
+Press `g` to open the go-to prompt and paste a contract address — or a dexscreener / pump.fun / solscan / birdeye link — then ⏎ to open that coin's live token screen, read-only. A CA or link also works in the analyst chat and the screener `/` line. One-shot: `--mint <CA|link>`. Nothing here trades.
+
+Keys: `g` (screener).

package/dist/packages/mcp/assets/kb/app-help/open-chart-popup.md

@@ -0,0 +1,33 @@
+---
+id: open-chart-popup
+title: Open the chart popup
+kind: app-help
+screen: token
+feature: popup-chart
+tags:
+  - app-help
+  - chart
+  - popup
+  - candles
+  - window
+  - dock
+  - graph
+keys:
+  - C
+actions:
+  - popup.chart
+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
+---
+
+Press `C` on the token screen to open the docked chart popup (a native window, or your browser as fallback). It is fed only by the terminal's caches over one loopback WebSocket and never sees your keys. The analyst can open or close it for you.
+
+Keys: `C` (token).

package/dist/packages/mcp/assets/kb/app-help/order-plans.md

@@ -0,0 +1,33 @@
+---
+id: order-plans
+title: Set conditional order plans (dexterm plan)
+kind: app-help
+screen: all
+feature: order-plans
+tags:
+  - app-help
+  - plan
+  - plans
+  - order
+  - conditional
+  - take-profit
+  - stop
+  - trigger
+  - arm
+commands:
+  - plan
+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 plan list|add|remove|arm|disarm` sets conditional order plans (e.g. take-profit / stop levels). Voice and agents can only PROPOSE a plan; ARMING one needs your physical keypress, and the caps and panic-stop stay signer-side. Nothing here lets a model sign or raise a cap.
+
+CLI: `dexterm plan`.

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

@@ -0,0 +1,36 @@
+---
+id: paper-trade
+title: Paper trade a coin
+kind: app-help
+screen: token
+feature: paper-ticket
+tags:
+  - app-help
+  - paper
+  - trade
+  - buy
+  - sell
+  - ticket
+  - simulate
+  - practice
+keys:
+  - B
+  - S
+actions:
+  - trade.buy
+  - trade.sell
+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
+---
+
+Press `B` / `S` on the token screen to open a PAPER buy/sell ticket in its editing phase. dexterm holds no keys and signs nothing — paper trading is a simulation. Confirming a ticket needs your explicit keypress (the gate); a stray key never confirms. The analyst can open a PAPER ticket but can never size, confirm or send it.
+
+Keys: `B` (token), `S` (token).

package/dist/packages/mcp/assets/kb/app-help/price-or-marketcap.md

@@ -0,0 +1,38 @@
+---
+id: price-or-marketcap
+title: Show price or market cap
+kind: app-help
+screen: all
+feature: price-display-mode
+tags:
+  - app-help
+  - price
+  - mcap
+  - marketcap
+  - market
+  - display
+  - usd
+  - cap
+keys:
+  - $
+actions:
+  - display.priceMode
+commands:
+  - display
+flags:
+  - --price-mode
+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
+---
+
+Press `$` to flip every price between USD price and MARKET CAP (screener, watchlist, new pairs, token, both charts, order-plan levels). Saved as `display.priceMode`; also `dexterm display price|mcap` or `--price-mode`. A coin with no known supply stays on price and says so. The analyst can set this for you.
+
+Keys: `$`. CLI: `dexterm display`.

package/dist/packages/mcp/assets/kb/app-help/record-headless.md

@@ -0,0 +1,34 @@
+---
+id: record-headless
+title: Keep the recorder running with the app closed (dexterm record)
+kind: app-help
+screen: all
+feature: recorder
+tags:
+  - app-help
+  - collector
+  - collect
+  - background
+  - headless
+  - launchd
+  - daemon
+  - keep
+  - closed
+  - backtest
+commands:
+  - record
+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 record` runs the history recorder with no terminal UI, so the data the backtests learn from keeps growing while dexterm is closed. `dexterm record status` shows what it has collected; `dexterm record install --dry-run` prints the user-level LaunchAgent it would create (macOS, no sudo) and `dexterm record uninstall` removes it. It uses the same free-tier request limits as the app, never trades, and a disk cap pauses new observations when the database gets large.
+
+CLI: `dexterm record`.

package/dist/packages/mcp/assets/kb/app-help/recorder-history.md

@@ -0,0 +1,39 @@
+---
+id: recorder-history
+title: Work with the history recorder (dexterm recorder)
+kind: app-help
+screen: all
+feature: recorder
+tags:
+  - app-help
+  - recorder
+  - record
+  - history
+  - stats
+  - label
+  - prune
+  - outcomes
+  - database
+  - session
+  - capture
+  - data
+commands:
+  - recorder
+flags:
+  - --record
+  - --no-recorder
+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 recorder stats|label|prune|export` works with the local history recorder's tables (the outcome-labelled data the rug model and backtests learn from). No network. Recording is on by default; `--no-recorder` disables it for a run and `--record FILE` captures a data session to a file for replay.
+
+CLI: `dexterm recorder`.

package/dist/packages/mcp/assets/kb/app-help/rug-check.md

@@ -0,0 +1,39 @@
+---
+id: rug-check
+title: Check if a coin is a rug
+kind: app-help
+screen: token
+feature: analyst
+tags:
+  - app-help
+  - rug
+  - safe
+  - honeypot
+  - scam
+  - risk
+  - check
+  - authority
+  - mint
+keys:
+  - a
+actions:
+  - analyst.toggle
+tools:
+  - analyze_token
+  - get_dossier
+  - rugcheck
+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
+---
+
+Press `a` to run a rug-check on the selected coin: authorities, token program, LP, holder concentration, creator history and tape, with a p(rug) from the H1 heuristic (a ranking, not a calibrated probability). The verdict is WATCH / SPECULATIVE / AVOID. Facts come only from tools; it is not financial advice.
+
+Keys: `a`.

package/dist/packages/mcp/assets/kb/app-help/run-doctor.md

@@ -0,0 +1,32 @@
+---
+id: run-doctor
+title: Diagnose problems with doctor
+kind: app-help
+screen: all
+feature: doctor
+tags:
+  - app-help
+  - doctor
+  - diagnose
+  - check
+  - troubleshoot
+  - broken
+  - fix
+  - problem
+commands:
+  - doctor
+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 doctor` is the first stop for any problem: non-interactive, never touches your keys, exits 0 when dexterm will run and 1 when something must be fixed. Every non-pass line prints the exact fix. `dexterm doctor --offline` skips the network probes.
+
+CLI: `dexterm doctor`.

package/dist/packages/mcp/assets/kb/app-help/scan-mode.md

@@ -0,0 +1,37 @@
+---
+id: scan-mode
+title: Use AI scan mode
+kind: app-help
+screen: all
+feature: scan
+tags:
+  - app-help
+  - scan
+  - watcher
+  - observe
+  - auto
+  - ai
+  - monitor
+keys:
+  - Z
+  - R
+actions:
+  - scan.toggle
+  - scan.resume
+flags:
+  - --scan
+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
+---
+
+Scan mode is an observe-only AI watcher (off by default, zero extra requests). Toggle it with `Z` (or `/scan on|off` on the screener line, or `--scan` at launch); `R` resumes a paused scan. It can only surface findings, never take a UI action or trade (structurally observe-only). The analyst can turn it on or off for you.
+
+Keys: `Z`, `R`.

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

@@ -0,0 +1,181 @@
+---
+id: screen-analyst
+title: The analyst screen
+kind: app-help
+screen: analyst
+feature: analyst
+tags:
+  - app-help
+  - screen
+  - analyst
+  - the
+  - analyst
+  - 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
+  - ,
+  - <
+  - >
+  - i
+  - ?
+  - 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
+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
+  - input.focus
+  - 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
+tools:
+  - get_dossier
+  - kb_search
+  - app_help
+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
+---
+
+Your own `claude` CLI as the dexterm analyst: it reads the read-only dexterm MCP tools, grounds every fact in a tool result, and answers in a few terse lines. ⏎ on a coin runs a full dossier; `a` runs a rug-check. Facts never come from model memory; token text passes the prompt firewall.
+
+Keys on this screen:
+  `q/^C` — quit
+  `1` — screener
+  `2` — new pairs
+  `3` — watchlist
+  `4` — analyst
+  `tab` — screens
+  `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
+  `i` — ask
+  `?` — help
+  `t` — theme
+  `p` — pause
+  `$` — price ⇄ mcap
+  `E` — export PNG + report
+  `w` — watch
+  `b` — alert
+  `y` — confirm alert
+  `x` — dismiss 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
+  `type` — ask a follow-up · ⏎ send · esc clear/back
+  `c` — calm mode (effects off)
+  `?` — this help