dexterm-cli 0.1.2 → 0.1.4

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

@@ -0,0 +1,39 @@
+---
+id: connect-an-agent
+title: Connect your own agent (MCP)
+kind: app-help
+screen: all
+feature: mcp
+tags:
+  - app-help
+  - mcp
+  - agent
+  - agents
+  - connect
+  - claude
+  - tool
+  - server
+  - bot
+commands:
+  - mcp
+tools:
+  - screen_state
+  - get_dossier
+  - kb_search
+  - app_help
+  - app_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
+---
+
+`dexterm mcp` is a plain stdio MCP server exposing the same read-only tools the analyst uses. Add it to any Claude Code with `claude mcp add dexterm -- node packages/mcp/bin/dexterm-mcp.mjs`. Agents are untrusted: every tool is read-only and an agent can never sign, arm, raise a cap or touch keys. Use `app_help` for "how do I" questions and `app_state` to see what the user sees.
+
+CLI: `dexterm mcp`.

package/dist/packages/mcp/assets/kb/app-help/custom-keymap.md

@@ -0,0 +1,32 @@
+---
+id: custom-keymap
+title: Customize the keymap
+kind: app-help
+screen: all
+feature: themes-keymaps
+tags:
+  - app-help
+  - keymap
+  - keybind
+  - keybinding
+  - rebind
+  - shortcut
+  - keys
+  - remap
+commands:
+  - keymap
+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
+---
+
+`config.keymap` in `~/.dexterm/config.json` re-binds actions to keys; `dexterm keymap [screen]` shows the effective bindings including your overrides. Reserved keys (ctrl+c, esc, enter, y, !) and the confirm/dismiss/panic/quit actions cannot be rebound, and collisions refuse the whole keymap.
+
+CLI: `dexterm keymap`.

package/dist/packages/mcp/assets/kb/app-help/edit-kb-or-skill.md

@@ -0,0 +1,36 @@
+---
+id: edit-kb-or-skill
+title: Edit the knowledge base or an analyst skill
+kind: app-help
+screen: all
+feature: kb
+tags:
+  - app-help
+  - kb
+  - knowledge
+  - skill
+  - edit
+  - customize
+  - override
+  - analyst
+commands:
+  - kb
+  - skill
+tools:
+  - kb_lookup
+  - kb_search
+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
+---
+
+Your own KB entries and skills live in `~/.dexterm/kb/entries/<id>.md` and `~/.dexterm/skills/<name>.md` (same frontmatter as the bundled ones). `dexterm kb|skill list|show|new|edit|check|reset|path`: `edit` copies the bundled file and opens your editor, `check` validates it, `reset` restores the bundled one. A skill is read-only guidance and may never name a trade/sign/arm tool.
+
+CLI: `dexterm kb`, `dexterm skill`.

package/dist/packages/mcp/assets/kb/app-help/edit-rules.md

@@ -0,0 +1,34 @@
+---
+id: edit-rules
+title: Set up alert rules (dexterm rules)
+kind: app-help
+screen: all
+feature: rules-engine
+tags:
+  - app-help
+  - rules
+  - rule
+  - trigger
+  - condition
+  - alert
+  - add
+  - dry-run
+  - fields
+  - engine
+commands:
+  - rules
+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 rules list|add|remove|enable|disable|check|dry-run|fields` configures the rules engine — the conditions that raise an alert (e.g. liquidity jump, volume spike). `dry-run` tests a rule against recent data; `fields` lists what you can match on. No network, no model, and a rule can never trade. Deliver the alerts with `dexterm alerts` and `dexterm watch`.
+
+CLI: `dexterm rules`.

package/dist/packages/mcp/assets/kb/app-help/export-a-view.md

@@ -0,0 +1,36 @@
+---
+id: export-a-view
+title: Export or share the current view
+kind: app-help
+screen: all
+feature: export-share
+tags:
+  - app-help
+  - export
+  - share
+  - screenshot
+  - png
+  - report
+  - save
+  - image
+keys:
+  - E
+actions:
+  - export.view
+flags:
+  - --export
+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 `E` on any screen to write the current view to `~/.dexterm/exports/` as a PNG and a plain-text report (the toast names the file). The PNG is rendered calm with a data-source label (LIVE / SAMPLE / REPLAY) and the age of every panel. Nothing is uploaded or posted. One-shot: `--export [DIR]`.
+
+Keys: `E`.

package/dist/packages/mcp/assets/kb/app-help/follow-a-wallet.md

@@ -0,0 +1,33 @@
+---
+id: follow-a-wallet
+title: Copy / follow a wallet (dexterm follow)
+kind: app-help
+screen: all
+feature: copy-trading
+tags:
+  - app-help
+  - follow
+  - copy
+  - mirror
+  - wallet
+  - trader
+  - track
+  - unfollow
+  - list
+commands:
+  - follow
+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 follow list|add|remove` is the copy-trading follow list: local, self-directed and read-only. When a followed wallet trades, dexterm can surface a one-key MIRROR TICKET you confirm yourself — it never auto-trades, never signs, and the analyst can never add a follow or confirm a mirror.
+
+CLI: `dexterm follow`.

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

@@ -0,0 +1,37 @@
+---
+id: getting-started
+title: Get started with dexterm
+kind: app-help
+screen: all
+feature: doctor
+tags:
+  - app-help
+  - start
+  - install
+  - first
+  - run
+  - setup
+  - begin
+commands:
+  - doctor
+flags:
+  - --fixtures
+  - --calm
+  - --version
+  - -h
+  - --help
+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
+---
+
+Run `dexterm doctor` first: it checks Node, terminal colour, the claude CLI, each data source, the Helius key and a writable data dir, and prints the exact fix for anything not passing. Then run `dexterm` — the first launch shows a one-screen welcome; press any key to enter the live screener. Press `?` on any screen for that screen's full key list. Try `--fixtures` for an offline demo. `--version` prints the version; `--help` (or `-h`) prints usage.
+
+CLI: `dexterm doctor`.

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

@@ -0,0 +1,34 @@
+---
+id: kol-lists
+title: Manage KOL wallet lists (dexterm kol)
+kind: app-help
+screen: kol
+feature: kol-lists
+tags:
+  - app-help
+  - kol
+  - kols
+  - influencer
+  - leader
+  - list
+  - lists
+  - wallet
+  - mute
+  - import
+commands:
+  - kol
+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 kol list|create|add|remove|mute|unmute|enable|disable|import` manages key-opinion-leader wallet lists on the shared DB (official / authorized sources only). In-app the KOL screen shows the lists and their activity.
+
+CLI: `dexterm kol`.

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

@@ -0,0 +1,36 @@
+---
+id: larp-check
+title: Run the LARP check (is the product real?)
+kind: app-help
+screen: token
+feature: larp-check
+tags:
+  - app-help
+  - larp
+  - fake
+  - real
+  - legit
+  - website
+  - product
+  - domain
+  - github
+  - vet
+tools:
+  - larp_check
+  - get_links
+  - fetch_page
+  - check_domain
+  - check_github
+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
+---
+
+The LARP check vets whether a real product exists (website, domain age, GitHub) read-only — it is not a price call. Ask the analyst "is <coin> a larp?" (skill `larp-check`), or an agent can call the `larp_check` MCP tool. A grade is a risk flag, never a certificate; it never recommends buy/sell.

package/dist/packages/mcp/assets/kb/app-help/link-a-wallet.md

@@ -0,0 +1,41 @@
+---
+id: link-a-wallet
+title: Link a wallet for trading (dexterm wallet)
+kind: app-help
+screen: all
+feature: trading
+tags:
+  - app-help
+  - wallet
+  - link
+  - unlink
+  - phantom
+  - connect
+  - pubkey
+  - caps
+  - trade
+commands:
+  - wallet
+flags:
+  - --mainnet
+  - --max-usd
+  - --daily-usd
+  - --max-sol-out
+  - --max-slippage-bps
+  - --trade-rpc
+  - --no-live
+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 wallet link|unlink|status` links a Phantom wallet through a loopback bridge — your keys NEVER enter dexterm, only the public key is stored — and shows the link and the signer-side trade caps. dexterm is non-custodial: it builds and simulates transactions, your own wallet signs. The signer-side caps (`--max-usd`, `--daily-usd`, `--max-sol-out`, `--max-slippage-bps`) and the RPC (`--trade-rpc`) bound every trade and live on the signer; `--mainnet` opts in to mainnet and `--no-live` keeps it paper-only. The analyst can never link, unlink, sign, arm or change a cap.
+
+CLI: `dexterm wallet`.

package/dist/packages/mcp/assets/kb/app-help/login-with-x.md

@@ -0,0 +1,33 @@
+---
+id: login-with-x
+title: Connect your X account (dexterm x)
+kind: app-help
+screen: all
+feature: login-with-x
+tags:
+  - app-help
+  - x
+  - twitter
+  - login
+  - oauth
+  - account
+  - social
+  - connect
+  - client
+commands:
+  - x
+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 x status|set-client-id|login|logout` connects your X (Twitter) account via OAuth2 PKCE on a loopback callback. Tokens stay in `~/.dexterm/x` (0600), are never printed, and the scopes are read-only. It only improves social signal; nothing is posted.
+
+CLI: `dexterm x`.

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`.