dexterm-cli 0.1.3 → 0.1.4

package/dist/packages/mcp/assets/kb/docs/docs-beginners-macos-homebrew.md

@@ -0,0 +1,46 @@
+---
+id: docs-beginners-macos-homebrew
+title: New to terminals? Start here › Choose a setup path › macOS: Homebrew
+kind: docs
+page: beginners
+page_title: New to terminals? Start here
+heading: macOS: Homebrew
+anchor: macos-homebrew
+url: https://dexterm.xyz/docs/beginners#macos-homebrew
+tags:
+  - docs
+  - beginners
+  - macos
+  - homebrew
+  - choose
+  - setup
+  - path
+  - new
+  - terminals
+  - start
+  - here
+confidence: high
+owner: maintainers
+origin: docs-generated
+reviewed_by: generated@2026-10-16
+generated_from: dexterm/site content/docs (task-1420)
+sources:
+  - site/content/docs/beginners.md
+date: 2026-10-16
+---
+
+If you already use Homebrew, this tested macOS path also works:
+
+```sh add the dexterm tap
+brew tap dexterm-xyz/dexterm
+```
+
+```sh trust that tap
+brew trust dexterm-xyz/dexterm
+```
+
+```sh install dexterm
+brew install dexterm
+```
+
+Homebrew on Apple Silicon has not yet run the project's manual install test. On an Intel Mac it may spend a long time building Node; the npm path above is faster.

package/dist/packages/mcp/assets/kb/docs/docs-beginners-macos-or-linux-npm.md

@@ -0,0 +1,39 @@
+---
+id: docs-beginners-macos-or-linux-npm
+title: New to terminals? Start here › Choose a setup path › macOS or Linux: npm
+kind: docs
+page: beginners
+page_title: New to terminals? Start here
+heading: macOS or Linux: npm
+anchor: macos-or-linux-npm
+url: https://dexterm.xyz/docs/beginners#macos-or-linux-npm
+tags:
+  - docs
+  - beginners
+  - macos
+  - linux
+  - npm
+  - choose
+  - setup
+  - path
+  - new
+  - terminals
+  - start
+  - here
+confidence: high
+owner: maintainers
+origin: docs-generated
+reviewed_by: generated@2026-10-16
+generated_from: dexterm/site content/docs (task-1420)
+sources:
+  - site/content/docs/beginners.md
+date: 2026-10-16
+---
+
+`npm` is the installer included with Node.js. This is the shortest path:
+
+```sh install dexterm
+npm i -g dexterm-cli
+```
+
+Linux x64 with Node 22 and 24 and macOS on Intel processors have passed the full automated tests plus a clean install-and-start check. Apple Silicon macOS has not yet run the project's written automated test. No `sudo` (the command that grants administrator power) is required for this npm path.

package/dist/packages/mcp/assets/kb/docs/docs-beginners-macos.md

@@ -0,0 +1,30 @@
+---
+id: docs-beginners-macos
+title: New to terminals? Start here › Open the terminal › macOS
+kind: docs
+page: beginners
+page_title: New to terminals? Start here
+heading: macOS
+anchor: macos
+url: https://dexterm.xyz/docs/beginners#macos
+tags:
+  - docs
+  - beginners
+  - macos
+  - open
+  - terminal
+  - new
+  - terminals
+  - start
+  - here
+confidence: high
+owner: maintainers
+origin: docs-generated
+reviewed_by: generated@2026-10-16
+generated_from: dexterm/site content/docs (task-1420)
+sources:
+  - site/content/docs/beginners.md
+date: 2026-10-16
+---
+
+Press **Command-Space**, type **Terminal**, then press **Return**. Terminal.app is enough; iTerm2, Ghostty and WezTerm also work.

package/dist/packages/mcp/assets/kb/docs/docs-beginners-open-the-terminal.md

@@ -0,0 +1,29 @@
+---
+id: docs-beginners-open-the-terminal
+title: New to terminals? Start here › Open the terminal
+kind: docs
+page: beginners
+page_title: New to terminals? Start here
+heading: Open the terminal
+anchor: open-the-terminal
+url: https://dexterm.xyz/docs/beginners#open-the-terminal
+tags:
+  - docs
+  - beginners
+  - open
+  - terminal
+  - new
+  - terminals
+  - start
+  - here
+confidence: high
+owner: maintainers
+origin: docs-generated
+reviewed_by: generated@2026-10-16
+generated_from: dexterm/site content/docs (task-1420)
+sources:
+  - site/content/docs/beginners.md
+date: 2026-10-16
+---
+
+Choose your computer below. Opening this app does not change anything; it only gives you a place to type a command.

package/dist/packages/mcp/assets/kb/docs/docs-beginners-reopen-dexterm-later.md

@@ -0,0 +1,36 @@
+---
+id: docs-beginners-reopen-dexterm-later
+title: New to terminals? Start here › Reopen dexterm later
+kind: docs
+page: beginners
+page_title: New to terminals? Start here
+heading: Reopen dexterm later
+anchor: reopen-dexterm-later
+url: https://dexterm.xyz/docs/beginners#reopen-dexterm-later
+tags:
+  - docs
+  - beginners
+  - reopen
+  - dexterm
+  - later
+  - new
+  - terminals
+  - start
+  - here
+confidence: high
+owner: maintainers
+origin: docs-generated
+reviewed_by: generated@2026-10-16
+generated_from: dexterm/site content/docs (task-1420)
+sources:
+  - site/content/docs/beginners.md
+date: 2026-10-16
+---
+
+Open Terminal, a Linux terminal, or PowerShell again and run:
+
+```sh reopen dexterm
+dexterm
+```
+
+You do not reinstall it each time. Run `dexterm doctor` again after changing Node.js, your terminal, or an optional data key.

package/dist/packages/mcp/assets/kb/docs/docs-beginners-ten-minute-first-win.md

@@ -0,0 +1,30 @@
+---
+id: docs-beginners-ten-minute-first-win
+title: New to terminals? Start here › Ten-minute first win
+kind: docs
+page: beginners
+page_title: New to terminals? Start here
+heading: Ten-minute first win
+anchor: ten-minute-first-win
+url: https://dexterm.xyz/docs/beginners#ten-minute-first-win
+tags:
+  - docs
+  - beginners
+  - ten-minute
+  - first
+  - win
+  - new
+  - terminals
+  - start
+  - here
+confidence: high
+owner: maintainers
+origin: docs-generated
+reviewed_by: generated@2026-10-16
+generated_from: dexterm/site content/docs (task-1420)
+sources:
+  - site/content/docs/beginners.md
+date: 2026-10-16
+---
+
+The steps below are read-only. They do not connect a wallet or place a trade.

package/dist/packages/mcp/assets/kb/docs/docs-beginners-terminal-shell-prompt-command-output-and-path.md

@@ -0,0 +1,40 @@
+---
+id: docs-beginners-terminal-shell-prompt-command-output-and-path
+title: New to terminals? Start here › Terminal, shell, prompt, command, output, and PATH
+kind: docs
+page: beginners
+page_title: New to terminals? Start here
+heading: Terminal, shell, prompt, command, output, and PATH
+anchor: terminal-shell-prompt-command-output-and-path
+url: https://dexterm.xyz/docs/beginners#terminal-shell-prompt-command-output-and-path
+tags:
+  - docs
+  - beginners
+  - terminal
+  - shell
+  - prompt
+  - command
+  - output
+  - path
+  - new
+  - terminals
+  - start
+  - here
+confidence: high
+owner: maintainers
+origin: docs-generated
+reviewed_by: generated@2026-10-16
+generated_from: dexterm/site content/docs (task-1420)
+sources:
+  - site/content/docs/beginners.md
+date: 2026-10-16
+---
+
+- A **terminal** is a text window for giving your computer instructions. macOS calls its built-in app Terminal. Windows users should use PowerShell inside Windows Terminal. Linux includes a terminal app with the desktop.
+- A **shell** is the program inside that window that reads what you type. PowerShell is a shell; `zsh` and `bash` are common macOS and Linux shells. You do not need to learn which one you have.
+- A **prompt** is the short text, often ending in `$` or `>`, that means the shell is ready. Do not type the prompt itself.
+- A **command** is one line you type after the prompt, such as `dexterm doctor`.
+- **Output** is the text the computer prints after a command. Output is an answer, not another command to copy blindly.
+- **PATH** is the list of folders where the shell looks for commands. If it says `dexterm: command not found`, dexterm may be installed but its folder may not be on that list. The fix is below (https://dexterm.xyz/docs/beginners#if-dexterm-says-command-not-found).
+
+Press **Enter** after each command. Wait until the prompt returns before typing the next one.

package/dist/packages/mcp/assets/kb/docs/docs-beginners-where-to-go-next.md

@@ -0,0 +1,32 @@
+---
+id: docs-beginners-where-to-go-next
+title: New to terminals? Start here › Where to go next
+kind: docs
+page: beginners
+page_title: New to terminals? Start here
+heading: Where to go next
+anchor: where-to-go-next
+url: https://dexterm.xyz/docs/beginners#where-to-go-next
+tags:
+  - docs
+  - beginners
+  - where
+  - next
+  - new
+  - terminals
+  - start
+  - here
+confidence: high
+owner: maintainers
+origin: docs-generated
+reviewed_by: generated@2026-10-16
+generated_from: dexterm/site content/docs (task-1420)
+sources:
+  - site/content/docs/beginners.md
+date: 2026-10-16
+---
+
+- Getting started (https://dexterm.xyz/docs/getting-started) has the complete install choices and tested-platform evidence.
+- Screens (https://dexterm.xyz/docs/screens) explains every panel.
+- Keyboard (https://dexterm.xyz/docs/keyboard) lists the exact keys generated from the app.
+- Troubleshooting (https://dexterm.xyz/docs/troubleshooting) covers doctor messages and reporting a problem.

package/dist/packages/mcp/assets/kb/docs/docs-beginners-windows-expectations.md

@@ -0,0 +1,29 @@
+---
+id: docs-beginners-windows-expectations
+title: New to terminals? Start here › Windows expectations
+kind: docs
+page: beginners
+page_title: New to terminals? Start here
+heading: Windows expectations
+anchor: windows-expectations
+url: https://dexterm.xyz/docs/beginners#windows-expectations
+tags:
+  - docs
+  - beginners
+  - windows
+  - expectations
+  - new
+  - terminals
+  - start
+  - here
+confidence: high
+owner: maintainers
+origin: docs-generated
+reviewed_by: generated@2026-10-16
+generated_from: dexterm/site content/docs (task-1420)
+sources:
+  - site/content/docs/beginners.md
+date: 2026-10-16
+---
+
+Windows x64 is experimental and has not yet run the written CI job. File permissions rely on your Windows user profile; voice has no Windows speech engine; browser-opening actions show a URL instead; `doctor` may print a macOS/Linux repair command; and the npm-installed `claude.cmd` is not detected as a usable analyst binary. These limits do not change the key rule: dexterm never holds your wallet keys.

package/dist/packages/mcp/assets/kb/docs/docs-beginners-windows-powershell-experimental.md

@@ -0,0 +1,39 @@
+---
+id: docs-beginners-windows-powershell-experimental
+title: New to terminals? Start here › Choose a setup path › Windows: PowerShell (experimental)
+kind: docs
+page: beginners
+page_title: New to terminals? Start here
+heading: Windows: PowerShell (experimental)
+anchor: windows-powershell-experimental
+url: https://dexterm.xyz/docs/beginners#windows-powershell-experimental
+tags:
+  - docs
+  - beginners
+  - windows
+  - powershell
+  - experimental
+  - choose
+  - setup
+  - path
+  - new
+  - terminals
+  - start
+  - here
+confidence: high
+owner: maintainers
+origin: docs-generated
+reviewed_by: generated@2026-10-16
+generated_from: dexterm/site content/docs (task-1420)
+sources:
+  - site/content/docs/beginners.md
+date: 2026-10-16
+---
+
+Install Node.js LTS first, reopen PowerShell, and run:
+
+```powershell install dexterm
+npm i -g dexterm-cli
+```
+
+The Windows path is experimental and not yet tested by the project. The core read-only screens are expected to work, but voice has no Windows engine, browser-opening shortcuts do not work, and some repair instructions are written for macOS/Linux. See Windows expectations (https://dexterm.xyz/docs/beginners#windows-expectations).

package/dist/packages/mcp/assets/kb/docs/docs-beginners-windows.md

@@ -0,0 +1,30 @@
+---
+id: docs-beginners-windows
+title: New to terminals? Start here › Open the terminal › Windows
+kind: docs
+page: beginners
+page_title: New to terminals? Start here
+heading: Windows
+anchor: windows
+url: https://dexterm.xyz/docs/beginners#windows
+tags:
+  - docs
+  - beginners
+  - windows
+  - open
+  - terminal
+  - new
+  - terminals
+  - start
+  - here
+confidence: high
+owner: maintainers
+origin: docs-generated
+reviewed_by: generated@2026-10-16
+generated_from: dexterm/site content/docs (task-1420)
+sources:
+  - site/content/docs/beginners.md
+date: 2026-10-16
+---
+
+Open the Start menu, type **Windows Terminal**, and choose the **PowerShell** tab. Windows support is experimental and has not yet passed the project's test run; the known limits are listed under Windows expectations (https://dexterm.xyz/docs/beginners#windows-expectations).

package/dist/packages/mcp/assets/kb/docs/docs-beginners.md

@@ -0,0 +1,29 @@
+---
+id: docs-beginners
+title: New to terminals? Start here
+kind: docs
+page: beginners
+page_title: New to terminals? Start here
+url: https://dexterm.xyz/docs/beginners
+tags:
+  - docs
+  - beginners
+  - new
+  - terminals
+  - start
+  - here
+confidence: high
+owner: maintainers
+origin: docs-generated
+reviewed_by: generated@2026-10-16
+generated_from: dexterm/site content/docs (task-1420)
+sources:
+  - site/content/docs/beginners.md
+date: 2026-10-16
+---
+
+A no-jargon, ten-minute path from opening a terminal to safely reading your first coin.
+
+This guide is for you if you have never used a terminal. Your first win is simple: install dexterm, open one real coin in **read-only** mode (display information without changing anything or trading), understand the safety and holder panels, save the result, and quit. It is **not** a trade and it does not require a wallet.
+
+> warn: Never paste a seed phrase, private key, password, API key, login token, or authentication token into a terminal, dexterm, a chat, a command, a URL, or a log. dexterm never needs your wallet keys and never holds them. The experimental trading path asks **Phantom** to approve each wallet action. If anything claiming to be dexterm asks for a secret, stop.

package/dist/packages/mcp/assets/kb/docs/docs-cli-dexterm-help.md

@@ -0,0 +1,31 @@
+---
+id: docs-cli-dexterm-help
+title: CLI flags and commands › dexterm --help
+kind: docs
+page: cli
+page_title: CLI flags and commands
+heading: dexterm --help
+anchor: dexterm-help
+url: https://dexterm.xyz/docs/cli#dexterm-help
+tags:
+  - docs
+  - cli
+  - dexterm
+  - help
+  - flags
+  - commands
+confidence: high
+owner: maintainers
+origin: docs-generated
+reviewed_by: generated@2026-10-16
+generated_from: dexterm/site content/docs (task-1420)
+sources:
+  - site/content/docs/cli.md
+date: 2026-10-16
+---
+
+The built-in help, verbatim from the app at `(generated from the app: see https://dexterm.xyz/docs/cli#dexterm-help; app-help has the exact keys and commands)`:
+
+```text
+(generated from the app: see https://dexterm.xyz/docs/cli#dexterm-help; app-help has the exact keys and commands)
+```

package/dist/packages/mcp/assets/kb/docs/docs-cli-filter-grammar.md

@@ -0,0 +1,37 @@
+---
+id: docs-cli-filter-grammar
+title: CLI flags and commands › Filter grammar
+kind: docs
+page: cli
+page_title: CLI flags and commands
+heading: Filter grammar
+anchor: filter-grammar
+url: https://dexterm.xyz/docs/cli#filter-grammar
+tags:
+  - docs
+  - cli
+  - filter
+  - grammar
+  - flags
+  - commands
+confidence: high
+owner: maintainers
+origin: docs-generated
+reviewed_by: generated@2026-10-16
+generated_from: dexterm/site content/docs (task-1420)
+sources:
+  - site/content/docs/cli.md
+date: 2026-10-16
+---
+
+Used by `--filter`, the `/` line, and the analyst's `show_in_screener` tool. Space-separated clauses are ANDed. A clause is `field op value`, a tag, or a bare word (symbol or name substring).
+
+- Operators: `>` `>=` `<` `<=` `=` `==` `!=`.
+- Money takes `K` / `M` / `B` (`5M`, `100K`). Percents are plain or `%`. Ages need a unit: `s` `m` `h` `d` `w` `mo` (`6h`, `30m`).
+- Tags: `launchpad:` (alias `lp:`) one of `pump dbc raydium meteora bonk` · `flag:` one of `mint freeze top10 dev bundle lp clean` · `verified:yes|no` · `sus:yes|no` · `chain:solana`. Negate with a leading `!` (`!flag:mint`).
+
+(generated from the app: see https://dexterm.xyz/docs/cli#filter-grammar; app-help has the exact keys and commands)
+
+Aliases: (generated from the app: see https://dexterm.xyz/docs/cli#filter-grammar; app-help has the exact keys and commands)
+
+Example: `vol24 > 250K liq > 50K age < 30d org >= 60 launchpad:pump !flag:mint cat`.

package/dist/packages/mcp/assets/kb/docs/docs-cli-flags.md

@@ -0,0 +1,27 @@
+---
+id: docs-cli-flags
+title: CLI flags and commands › Flags
+kind: docs
+page: cli
+page_title: CLI flags and commands
+heading: Flags
+anchor: flags
+url: https://dexterm.xyz/docs/cli#flags
+tags:
+  - docs
+  - cli
+  - flags
+  - commands
+confidence: high
+owner: maintainers
+origin: docs-generated
+reviewed_by: generated@2026-10-16
+generated_from: dexterm/site content/docs (task-1420)
+sources:
+  - site/content/docs/cli.md
+date: 2026-10-16
+---
+
+(generated from the app: see https://dexterm.xyz/docs/cli#flags; app-help has the exact keys and commands)
+
+Exclusive combinations parseArgs rejects: `--fixtures` with `--replay`; `--record` with either; `--mint` or `--event` without the data they need (`--mint` needs live or replay data, `--event` needs `--fixtures`); `--scan` with `--fixtures` or with `--screen`.

package/dist/packages/mcp/assets/kb/docs/docs-cli-invocations.md

@@ -0,0 +1,43 @@
+---
+id: docs-cli-invocations
+title: CLI flags and commands › Invocations
+kind: docs
+page: cli
+page_title: CLI flags and commands
+heading: Invocations
+anchor: invocations
+url: https://dexterm.xyz/docs/cli#invocations
+tags:
+  - docs
+  - cli
+  - invocations
+  - flags
+  - commands
+confidence: high
+owner: maintainers
+origin: docs-generated
+reviewed_by: generated@2026-10-16
+generated_from: dexterm/site content/docs (task-1420)
+sources:
+  - site/content/docs/cli.md
+date: 2026-10-16
+---
+
+```sh
+$ dexterm                                     # interactive, live keyless data (needs a TTY)
+$ dexterm doctor                              # pre-flight checks with the exact fix per line
+$ dexterm --fixtures                          # interactive demo on seeded fixtures
+$ dexterm --calm                              # effects off
+$ dexterm --scan                              # live, with AI scan mode on from the start
+$ dexterm --screen screener --width 176 --height 48          # one live frame to stdout
+$ dexterm --screen token --mint <MINT> --interval 5m         # one live token frame
+$ dexterm --screen screener --record /tmp/rec.json           # live frame, saved for replay
+$ dexterm --screen screener --replay /tmp/rec.json           # the same frame, no network
+$ dexterm mcp                                 # the read-only MCP server on stdio
+$ dexterm popup --self-test                   # chart popup self-test
+$ dexterm x login                             # Login with X (your own X app; read scopes only)
+$ dexterm --workspace morning-hud             # start in a workspace (task-1358)
+$ dexterm pack verify ./some-pack             # the install card for a shareable pack
+```
+
+Exit codes: 0 ok · 1 interactive mode without a TTY, or a doctor failure · 2 bad arguments (the message names the flag).

package/dist/packages/mcp/assets/kb/docs/docs-cli-presets.md

@@ -0,0 +1,26 @@
+---
+id: docs-cli-presets
+title: CLI flags and commands › Presets
+kind: docs
+page: cli
+page_title: CLI flags and commands
+heading: Presets
+anchor: presets
+url: https://dexterm.xyz/docs/cli#presets
+tags:
+  - docs
+  - cli
+  - presets
+  - flags
+  - commands
+confidence: high
+owner: maintainers
+origin: docs-generated
+reviewed_by: generated@2026-10-16
+generated_from: dexterm/site content/docs (task-1420)
+sources:
+  - site/content/docs/cli.md
+date: 2026-10-16
+---
+
+(generated from the app: see https://dexterm.xyz/docs/cli#presets; app-help has the exact keys and commands)

package/dist/packages/mcp/assets/kb/docs/docs-cli-scan-commands.md

@@ -0,0 +1,26 @@
+---
+id: docs-cli-scan-commands
+title: CLI flags and commands › /scan commands
+kind: docs
+page: cli
+page_title: CLI flags and commands
+heading: /scan commands
+anchor: scan-commands
+url: https://dexterm.xyz/docs/cli#scan-commands
+tags:
+  - docs
+  - cli
+  - scan
+  - commands
+  - flags
+confidence: high
+owner: maintainers
+origin: docs-generated
+reviewed_by: generated@2026-10-16
+generated_from: dexterm/site content/docs (task-1420)
+sources:
+  - site/content/docs/cli.md
+date: 2026-10-16
+---
+
+Typed on the screener's `/` line or in the chat input; the leading slash is optional on the `/` line. (generated from the app: see https://dexterm.xyz/docs/cli#scan-commands; app-help has the exact keys and commands)

package/dist/packages/mcp/assets/kb/docs/docs-cli-sort-keys.md

@@ -0,0 +1,27 @@
+---
+id: docs-cli-sort-keys
+title: CLI flags and commands › Sort keys
+kind: docs
+page: cli
+page_title: CLI flags and commands
+heading: Sort keys
+anchor: sort-keys
+url: https://dexterm.xyz/docs/cli#sort-keys
+tags:
+  - docs
+  - cli
+  - sort
+  - keys
+  - flags
+  - commands
+confidence: high
+owner: maintainers
+origin: docs-generated
+reviewed_by: generated@2026-10-16
+generated_from: dexterm/site content/docs (task-1420)
+sources:
+  - site/content/docs/cli.md
+date: 2026-10-16
+---
+
+(generated from the app: see https://dexterm.xyz/docs/cli#sort-keys; app-help has the exact keys and commands)

package/dist/packages/mcp/assets/kb/docs/docs-cli-subcommands.md

@@ -0,0 +1,26 @@
+---
+id: docs-cli-subcommands
+title: CLI flags and commands › Subcommands
+kind: docs
+page: cli
+page_title: CLI flags and commands
+heading: Subcommands
+anchor: subcommands
+url: https://dexterm.xyz/docs/cli#subcommands
+tags:
+  - docs
+  - cli
+  - subcommands
+  - flags
+  - commands
+confidence: high
+owner: maintainers
+origin: docs-generated
+reviewed_by: generated@2026-10-16
+generated_from: dexterm/site content/docs (task-1420)
+sources:
+  - site/content/docs/cli.md
+date: 2026-10-16
+---
+
+(generated from the app: see https://dexterm.xyz/docs/cli#subcommands; app-help has the exact keys and commands)