dexterm-cli 0.1.1 → 0.1.3

package/dist/packages/mcp/assets/kb/app-help/bubble-map.md

@@ -0,0 +1,35 @@
+---
+id: bubble-map
+title: Open the bubble map
+kind: app-help
+screen: token
+feature: bubble-map
+tags:
+  - app-help
+  - bubble
+  - bubbles
+  - map
+  - cluster
+  - clusters
+  - holders
+  - wallets
+  - cabal
+keys:
+  - M
+actions:
+  - intel.bubbles
+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 `M` on a token to open the BUBBLE MAP: top holders as discs (area = share of supply, colour = the rule that labelled the wallet), linked-cluster rings, a CLUSTERS table and a WHY THIS LABEL panel. Keyless it uses the public holder list with static labels; a free Helius key adds funders and the launch window.
+
+Keys: `M` (token).

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

@@ -0,0 +1,31 @@
+---
+id: calm-mode
+title: Turn on calm mode (effects off)
+kind: app-help
+screen: all
+feature: look
+tags:
+  - app-help
+  - calm
+  - effects
+  - rain
+  - glitch
+  - quiet
+  - still
+  - intensity
+flags:
+  - --calm
+  - --intensity
+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` to toggle calm mode: rain, glitch, blink and scanlines off, back to the last intensity when pressed again. Start calm with `--calm` (or `DEXTERM_CALM=1`); `--intensity normal|fever|off` picks a tier. The analyst can toggle calm for you.

package/dist/packages/mcp/assets/kb/app-help/change-voice-speed.md

@@ -0,0 +1,31 @@
+---
+id: change-voice-speed
+title: Change the voice speed (rate)
+kind: app-help
+screen: all
+feature: jarvis
+tags:
+  - app-help
+  - voice
+  - speed
+  - rate
+  - faster
+  - slower
+  - wpm
+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
+---
+
+Voice speed is `voice.rate` in `~/.dexterm/config.json` (words per minute, 80–400). Edit it there and restart. Voice settings are yours alone: the analyst/agent CANNOT change them (the voice path is denied to models) — only you set them. `dexterm voice status` shows the current voice engines.
+
+CLI: `dexterm voice`.

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

@@ -0,0 +1,30 @@
+---
+id: change-voice
+title: Change which voice speaks
+kind: app-help
+screen: all
+feature: jarvis
+tags:
+  - app-help
+  - voice
+  - choose
+  - speak
+  - say
+  - name
+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
+---
+
+The default speaking voice is the neural Piper voice once it is set up (`dexterm voice setup`), with the built-in macOS `say` as the fallback. Press `,` to cycle the `say` voice while running, or set `voice.name` in `~/.dexterm/config.json` (that chooses the `say` fallback voice; Piper has one fixed voice). Nothing is sent to a paid API. Voice is user-only: the analyst/agent cannot change it (the voice path is denied to models) — only the keyboard or your config sets it.
+
+CLI: `dexterm voice`.

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

@@ -0,0 +1,32 @@
+---
+id: chart-popup-selftest
+title: Run the popup self-test (dexterm popup --self-test)
+kind: app-help
+screen: all
+feature: popup-selftest
+tags:
+  - app-help
+  - self-test
+  - selftest
+  - test
+  - shell
+  - fps
+  - diagnose
+  - hotkey
+commands:
+  - popup
+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 popup --self-test [--browser] [--seconds N] [--theme NAME]` opens a chart popup on fixture data and reports the shell, hotkey and fps it can measure headlessly, labelling what still needs a human at an unlocked Mac. In-app, open the popup for real with `C` on the token screen (see "Open the chart popup").
+
+CLI: `dexterm popup`.

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

@@ -0,0 +1,29 @@
+---
+id: coin-images
+title: Turn coin images on or off
+kind: app-help
+screen: all
+feature: coin-images
+tags:
+  - app-help
+  - images
+  - image
+  - pictures
+  - icons
+  - logos
+  - off
+flags:
+  - --no-images
+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
+---
+
+Coin pictures render as real pixels in image-capable terminals (kitty/iTerm2/sixel) and as block art everywhere else. Turn them off with `--no-images` (or `DEXTERM_IMAGES=0`, or `enabled:false` in `~/.dexterm/images.json`). `dexterm doctor` has a Coin images line that says which path you get.

package/dist/packages/mcp/assets/kb/app-help/configure-rpc-key.md

@@ -0,0 +1,28 @@
+---
+id: configure-rpc-key
+title: Configure a Helius / RPC key for holders
+kind: app-help
+screen: all
+feature: keyless
+tags:
+  - app-help
+  - helius
+  - rpc
+  - key
+  - holders
+  - free
+  - api
+  - ranked
+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 is free-forever and keyless by default. The one real keyless gap is the ranked top-holder list: add a free RPC key for it. Save a Helius key ONLY at `~/.dexterm/helius.key` (mode 600, never a repo or command line), or set `DEXTERM_RPC_URL` to any read-only RPC. `dexterm doctor` prints the exact command. Without a key the holders panel shows count + top-10% via Jupiter.

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

@@ -0,0 +1,35 @@
+---
+id: connect-an-agent-registry
+title: Manage connected agents (dexterm agent)
+kind: app-help
+screen: all
+feature: mcp
+tags:
+  - app-help
+  - agent
+  - agents
+  - registry
+  - tier
+  - pause
+  - resume
+  - kick
+  - audit
+  - bus
+  - serve
+commands:
+  - agent
+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 agent add|list|rotate|remove|tier|pause|resume|kick|audit|packs` manages your bring-your-own-agent registry and the loopback bus; `dexterm agent serve` runs a standalone bus on fixtures and `connect` attaches one. Every agent is untrusted and read-only: it can never sign, arm, raise a cap, touch keys or change network settings.
+
+CLI: `dexterm agent`.

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