dexterm-cli 0.1.2 → 0.1.4

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

@@ -0,0 +1,192 @@
+---
+id: screen-trending
+title: The trending screen
+kind: app-help
+screen: trending
+feature: trending-board
+tags:
+  - app-help
+  - screen
+  - trending
+  - the
+  - trending
+  - 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
+  - M
+  - Z
+  - R
+  - T
+  - K
+  - N
+  - f
+  - n
+  - s
+  - r
+  - 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
+  - help.toggle
+  - theme.next
+  - pause.toggle
+  - display.priceMode
+  - export.view
+  - watch.add
+  - alert.propose
+  - alert.confirm
+  - alert.dismiss
+  - screen.positions
+  - popup.feeds
+  - scan.toggle
+  - scan.resume
+  - screen.trending
+  - social.kol
+  - screen.narrative
+  - social.filter
+  - social.spam
+  - social.narrative
+  - social.sources
+  - social.summary
+  - refresh
+  - screen.plans
+  - screen.follows
+  - workspace.list
+  - workspace.next
+  - workspace.prev
+  - workspace.save
+  - workspace.morning
+  - workspace.popups
+  - workspace.default
+  - screen.rules
+tools:
+  - narrative_board
+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
+---
+
+What is trending in the space — narratives and movers aggregated from the feed.
+
+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
+  `v` — voice
+  `m` — mute voice
+  `,` — change voice
+  `</>` — slower / faster voice
+  `?` — help
+  `t` — theme
+  `p` — pause
+  `$` — price ⇄ mcap
+  `E` — export PNG + report
+  `w` — watch
+  `b` — alert
+  `y` — confirm alert
+  `P` — positions
+  `M` — feeds popup
+  `Z` — AI scan
+  `R` — resume scan
+  `T` — trending
+  `K` — KOL lists
+  `N` — narrative board
+  `f` — filter
+  `x` — hidden spam
+  `n` — narrative
+  `s` — sources
+  `a` — summary (claude)
+  `r` — refresh
+  `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
+  `c` — calm mode (effects off)
+  `?` — this help

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

@@ -0,0 +1,181 @@
+---
+id: screen-watchlist
+title: The watchlist screen
+kind: app-help
+screen: watchlist
+feature: watchlist
+tags:
+  - app-help
+  - screen
+  - watchlist
+  - the
+  - watchlist
+  - 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
+  - d
+  - b
+  - y
+  - x
+  - r
+  - 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
+  - goto.open
+  - 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
+  - watch.remove
+  - alert.propose
+  - alert.confirm
+  - alert.dismiss
+  - refresh
+  - 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
+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
+---
+
+The coins you watch, persisted in SQLite, priced live every ~10 s with a LIVE/POLL badge. Add with `w` on any coin; remove with `d`.
+
+Keys on this screen:
+  `q/^C` — quit
+  `1` — screener
+  `2` — new pairs
+  `3` — watchlist
+  `4` — analyst
+  `tab` — screens
+  `j/↓` — move
+  `k/↑` — move
+  `home` — top
+  `G/end` — bottom
+  `g` — go to coin
+  `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
+  `p` — pause
+  `$` — price ⇄ mcap
+  `E` — export PNG + report
+  `w` — watch
+  `d` — remove
+  `b` — alert
+  `y` — confirm alert
+  `x` — dismiss alert
+  `r` — refresh
+  `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
+  `c` — calm mode (effects off)
+  `?` — this help

package/dist/packages/mcp/assets/kb/app-help/set-a-filter.md

@@ -0,0 +1,36 @@
+---
+id: set-a-filter
+title: Filter the screener
+kind: app-help
+screen: screener
+feature: filter-grammar
+tags:
+  - app-help
+  - filter
+  - screen
+  - query
+  - search
+  - grammar
+  - volume
+  - liquidity
+keys:
+  - /
+actions:
+  - filter.edit
+flags:
+  - --filter
+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 open the filter editor and type the grammar, e.g. `vol24 > 250K liq > 50K age < 30d org >= 60 launchpad:pump !flag:mint`. Errors show inline with the column. One-shot: `--filter "…"`. The analyst can set a filter for you (it shows "analyst did X").
+
+Keys: `/` (screener).

package/dist/packages/mcp/assets/kb/app-help/setup-neural-voice.md

@@ -0,0 +1,36 @@
+---
+id: setup-neural-voice
+title: Set up the neural voice (make it sound better)
+kind: app-help
+screen: all
+feature: jarvis
+tags:
+  - app-help
+  - voice
+  - neural
+  - piper
+  - better
+  - quality
+  - natural
+  - realistic
+  - nicer
+  - improve
+  - install
+  - alan
+commands:
+  - voice
+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 can speak with a neural British voice (Piper, en_GB-alan-medium) that sounds markedly more natural than the built-in system voices. Run `dexterm voice setup` to install it: it asks first, builds a private local Python runtime and downloads a ~61 MB checksum-verified voice from the official source, then runs fully offline with no key. Once installed it becomes the DEFAULT speaking voice automatically (the system voice stays as the fallback); `dexterm voice uninstall` removes it. It needs Python 3.9+ — `dexterm doctor` prints the exact fix if it is missing, and shows which engine is speaking.
+
+CLI: `dexterm voice`.

package/dist/packages/mcp/assets/kb/app-help/share-packs.md

@@ -0,0 +1,34 @@
+---
+id: share-packs
+title: Share or install packs (dexterm pack)
+kind: app-help
+screen: all
+feature: packs
+tags:
+  - app-help
+  - pack
+  - packs
+  - share
+  - install
+  - export
+  - sign
+  - trust
+  - lock
+  - bundle
+commands:
+  - pack
+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 pack list|verify|add|remove|export|lock|sign|trust|signers|keymap|widget` shares themes, keymaps, rules and widgets as plain files with a sha256 lock and an optional ssh signature. A pack never runs code: widgets land disabled, unsigned rules load disabled, and a keymap merges only on the explicit command.
+
+CLI: `dexterm pack`.

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

@@ -0,0 +1,34 @@
+---
+id: sort-the-screener
+title: Sort the screener
+kind: app-help
+screen: screener
+feature: filter-grammar
+tags:
+  - app-help
+  - sort
+  - order
+  - rank
+  - column
+  - menu
+keys:
+  - s
+actions:
+  - sort.menu
+flags:
+  - --sort
+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 `s` for the sort menu: j/k pick a key, ⏎ on the current key flips the direction (ascending/descending). One-shot at launch: `--sort <key>`.
+
+Keys: `s` (screener).

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

@@ -0,0 +1,39 @@
+---
+id: spectate-an-agent
+title: Watch an agent drive dexterm (dexterm spectate)
+kind: app-help
+screen: all
+feature: spectator
+tags:
+  - app-help
+  - spectate
+  - spectator
+  - watch
+  - agent
+  - cook
+  - observe
+  - replay
+  - stream
+  - record
+  - mcp
+  - follow
+commands:
+  - spectate
+flags:
+  - --replay
+  - --spectate-mcp
+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
+---
+
+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/
+
+CLI: `dexterm spectate`.

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

@@ -0,0 +1,33 @@
+---
+id: standing-mandates
+title: Set a standing mandate (dexterm mandate)
+kind: app-help
+screen: all
+feature: order-plans
+tags:
+  - app-help
+  - mandate
+  - mandates
+  - standing
+  - rule
+  - budget
+  - auto
+  - arm
+  - cap
+commands:
+  - mandate
+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 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.
+
+CLI: `dexterm mandate`.

package/dist/packages/mcp/assets/kb/app-help/switch-theme.md

@@ -0,0 +1,42 @@
+---
+id: switch-theme
+title: Switch the theme
+kind: app-help
+screen: all
+feature: themes-keymaps
+tags:
+  - app-help
+  - theme
+  - themes
+  - colour
+  - colours
+  - color
+  - colors
+  - look
+  - cyberspace
+  - midnight
+  - ember
+  - paper
+keys:
+  - t
+actions:
+  - theme.next
+commands:
+  - theme
+flags:
+  - --theme
+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 `t` to cycle themes (cyberspace → midnight → ember → paper). `dexterm theme list|show|init|check` manages your own themes in `~/.dexterm/themes/`; a shared theme cannot hide a warning or swap buy/sell colours (a contrast + hue guard). The analyst can propose a theme change you confirm with a keypress.
+
+Keys: `t`. CLI: `dexterm theme`.

package/dist/packages/mcp/assets/kb/app-help/turn-on-alerts.md

@@ -0,0 +1,37 @@
+---
+id: turn-on-alerts
+title: Turn on alerts (Telegram / Discord / desktop)
+kind: app-help
+screen: all
+feature: push-alerts
+tags:
+  - app-help
+  - alerts
+  - alert
+  - notify
+  - notification
+  - telegram
+  - discord
+  - desktop
+  - channel
+keys:
+  - b
+actions:
+  - alert.propose
+commands:
+  - alerts
+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
+---
+
+Use `dexterm alerts` to see channels and enable them; `dexterm alerts set-telegram` / `set-discord` store the bot token / webhook in `~/.dexterm/` (mode 0600) — never in config.json, argv or a log. In-app, `b` proposes a liquidity alert on the highlighted coin and `y` arms it. The analyst can never change alert channels or see their secrets.
+
+Keys: `b` (screener). CLI: `dexterm alerts`.

package/dist/packages/mcp/assets/kb/app-help/update-dexterm.md

@@ -0,0 +1,30 @@
+---
+id: update-dexterm
+title: Update dexterm
+kind: app-help
+screen: all
+feature: update-check
+tags:
+  - app-help
+  - update
+  - upgrade
+  - version
+  - latest
+  - new
+commands:
+  - update
+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 update` updates the app; a daily notice tells you when a new version is out. The analyst can never install or update software.
+
+CLI: `dexterm update`.