dexterm-cli 0.1.1 → 0.1.3

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,36 @@
+---
+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
+commands:
+  - spectate
+flags:
+  - --replay
+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 spectate --replay FILE` replays a saved agent session so you can watch what an agent did step by step; `dexterm spectate --info` shows the live read-only, token-gated, loopback spectator stream. The stream 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.
+
+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`.

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

@@ -0,0 +1,42 @@
+---
+id: use-presets
+title: Use screener presets
+kind: app-help
+screen: screener
+feature: presets
+tags:
+  - app-help
+  - preset
+  - presets
+  - trending
+  - runners
+  - organic
+  - graduating
+  - smart
+keys:
+  - ]
+  - right
+  - l
+  - [
+  - left
+  - h
+actions:
+  - preset.next
+  - preset.prev
+flags:
+  - --preset
+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 step through presets (Trending, Runners, Organic; Graduating ships keyless as an `approx` mcap-band proxy; Smart money needs a key and says so). The analyst can switch the feed too. One-shot at launch: `--preset <name>`.
+
+Keys: `] / → / l` (screener), `[ / ← / h` (screener).

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

@@ -0,0 +1,36 @@
+---
+id: use-voice-mode
+title: Use voice mode (Jarvis, push-to-talk)
+kind: app-help
+screen: all
+feature: jarvis
+tags:
+  - app-help
+  - voice
+  - jarvis
+  - talk
+  - mic
+  - microphone
+  - push
+  - listen
+keys:
+  - v
+actions:
+  - voice.talk
+flags:
+  - --sound
+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 `v` to start push-to-talk: speak, press `v` again to send (a red ● LISTENING badge shows while the mic is live; it also auto-closes after 15 s). Instant commands ("show the runners", "open bonk", "filter liquidity over 50k") run locally; questions go to `claude`. Voice only PROPOSES trades — it can never confirm, sign, arm or raise a cap. macOS only; every voice action also has a key. `--sound on|off` sets the sound/voice output at launch.
+
+Keys: `v`.

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

@@ -0,0 +1,34 @@
+---
+id: watch-a-coin
+title: Watch (or unwatch) a coin
+kind: app-help
+screen: all
+feature: watchlist
+tags:
+  - app-help
+  - watch
+  - watchlist
+  - follow
+  - track
+  - token
+  - tokens
+  - coins
+keys:
+  - w
+actions:
+  - watch.add
+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 `w` to watch/unwatch the highlighted coin (screener, new pairs, token screen). The watchlist is persisted and priced live. On the watchlist screen `d` removes a row.
+
+Keys: `w` (screener).

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

@@ -0,0 +1,35 @@
+---
+id: watch-headless
+title: Run alerts in the background (dexterm watch)
+kind: app-help
+screen: all
+feature: push-alerts
+tags:
+  - app-help
+  - watch
+  - background
+  - headless
+  - push
+  - alerts
+  - notify
+  - daemon
+  - interval
+commands:
+  - watch
+flags:
+  - --interval
+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 watch [--interval S] [--once|--ticks N] [--replay FILE]` runs the rules engine headless and PUSHES alerts to your enabled channels, so they reach you when the terminal is closed. It has no signer and can never trade. Set channels up first with `dexterm alerts`.
+
+CLI: `dexterm watch`.

package/dist/packages/mcp/assets/kb/app-help/what-dexterm-shows-agents.md

@@ -0,0 +1,31 @@
+---
+id: what-dexterm-shows-agents
+title: See what the user currently sees (app_state)
+kind: app-help
+screen: all
+feature: mcp
+tags:
+  - app-help
+  - state
+  - current
+  - screen
+  - context
+  - selected
+  - agent
+  - see
+tools:
+  - app_state
+  - screen_state
+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
+---
+
+An agent can call the read-only `app_state` MCP tool to fit an answer to what the user sees: the current screen, the selected coin, the theme, price mode, voice name/rate, whether scan and calm are on, and which alert channels are configured (YES/NO only — never a token, webhook or key). `screen_state` adds the visible rows and the action allow-list.