dexterm-cli 0.1.3 → 0.1.5

package/dist/packages/mcp/assets/kb/docs/docs-beginners-if-dexterm-says-command-not-found.md

@@ -0,0 +1,36 @@
+---
+id: docs-beginners-if-dexterm-says-command-not-found
+title: New to terminals? Start here › Common mistakes and recovery › If dexterm says command not found
+kind: docs
+page: beginners
+page_title: New to terminals? Start here
+heading: If dexterm says command not found
+anchor: if-dexterm-says-command-not-found
+url: https://dexterm.xyz/docs/beginners#if-dexterm-says-command-not-found
+tags:
+  - docs
+  - beginners
+  - dexterm
+  - says
+  - command
+  - found
+  - common
+  - mistakes
+  - recovery
+  - 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
+---
+
+Close and reopen the terminal first. Then run `npm prefix -g` to see npm's global install folder. On macOS/Linux, npm's executable folder must be on your PATH; the installer output normally tells you the exact line for your setup. Do not paste a PATH fix from a stranger. On Windows, rerun the Node.js installer and keep its “Add to PATH” option enabled, then reopen Windows Terminal.
+
+You can confirm whether the shell can find dexterm with `command -v dexterm` on macOS/Linux or `Get-Command dexterm` in PowerShell.

package/dist/packages/mcp/assets/kb/docs/docs-beginners-if-optional-help-is-unavailable.md

@@ -0,0 +1,33 @@
+---
+id: docs-beginners-if-optional-help-is-unavailable
+title: New to terminals? Start here › Common mistakes and recovery › If optional help is unavailable
+kind: docs
+page: beginners
+page_title: New to terminals? Start here
+heading: If optional help is unavailable
+anchor: if-optional-help-is-unavailable
+url: https://dexterm.xyz/docs/beginners#if-optional-help-is-unavailable
+tags:
+  - docs
+  - beginners
+  - optional
+  - help
+  - unavailable
+  - common
+  - mistakes
+  - recovery
+  - 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 screener still works when the analyst does not start. Run `dexterm doctor`; the Claude line explains what is missing. Never enter a Claude password or authentication token into dexterm.

package/dist/packages/mcp/assets/kb/docs/docs-beginners-if-paste-does-nothing-or-pastes-twice.md

@@ -0,0 +1,35 @@
+---
+id: docs-beginners-if-paste-does-nothing-or-pastes-twice
+title: New to terminals? Start here › Common mistakes and recovery › If paste does nothing or pastes twice
+kind: docs
+page: beginners
+page_title: New to terminals? Start here
+heading: If paste does nothing or pastes twice
+anchor: if-paste-does-nothing-or-pastes-twice
+url: https://dexterm.xyz/docs/beginners#if-paste-does-nothing-or-pastes-twice
+tags:
+  - docs
+  - beginners
+  - paste
+  - does
+  - nothing
+  - pastes
+  - twice
+  - common
+  - mistakes
+  - recovery
+  - 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
+---
+
+Use the right-click Paste menu. Make sure the cursor is in the terminal or in dexterm's go-to prompt. Press `Esc` once and then `g` to reopen the correct prompt.

package/dist/packages/mcp/assets/kb/docs/docs-beginners-if-the-screen-looks-broken.md

@@ -0,0 +1,33 @@
+---
+id: docs-beginners-if-the-screen-looks-broken
+title: New to terminals? Start here › Common mistakes and recovery › If the screen looks broken
+kind: docs
+page: beginners
+page_title: New to terminals? Start here
+heading: If the screen looks broken
+anchor: if-the-screen-looks-broken
+url: https://dexterm.xyz/docs/beginners#if-the-screen-looks-broken
+tags:
+  - docs
+  - beginners
+  - screen
+  - looks
+  - broken
+  - common
+  - mistakes
+  - recovery
+  - 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
+---
+
+Make the terminal window wider, then run `dexterm --calm` for a simpler display. Press `Ctrl-C` once if the app is stuck; it should restore the terminal. Run `dexterm doctor` and read the failed line.

package/dist/packages/mcp/assets/kb/docs/docs-beginners-if-you-typed-the-wrong-thing.md

@@ -0,0 +1,33 @@
+---
+id: docs-beginners-if-you-typed-the-wrong-thing
+title: New to terminals? Start here › Common mistakes and recovery › If you typed the wrong thing
+kind: docs
+page: beginners
+page_title: New to terminals? Start here
+heading: If you typed the wrong thing
+anchor: if-you-typed-the-wrong-thing
+url: https://dexterm.xyz/docs/beginners#if-you-typed-the-wrong-thing
+tags:
+  - docs
+  - beginners
+  - typed
+  - wrong
+  - thing
+  - common
+  - mistakes
+  - recovery
+  - 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 `Esc` to cancel an open prompt or return to the previous screen. Press `?` for current keys. Press `q` to leave and start again. Merely opening and reading a coin cannot trade.

package/dist/packages/mcp/assets/kb/docs/docs-beginners-install-node-js-first.md

@@ -0,0 +1,36 @@
+---
+id: docs-beginners-install-node-js-first
+title: New to terminals? Start here › Install Node.js first
+kind: docs
+page: beginners
+page_title: New to terminals? Start here
+heading: Install Node.js first
+anchor: install-node-js-first
+url: https://dexterm.xyz/docs/beginners#install-node-js-first
+tags:
+  - docs
+  - beginners
+  - install
+  - node
+  - first
+  - 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
+---
+
+dexterm needs Node.js 22.18 or newer. Node.js is the program that runs dexterm. Check whether it is already installed:
+
+```sh check Node.js
+node -v
+```
+
+Output such as `v22.18.0` or a larger version is ready. If the command is missing or the number is lower, install the current **Long-Term Support (LTS)** release—the version maintained for ordinary users—from nodejs.org (https://nodejs.org/), close the terminal, reopen it, and run `node -v` again.

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

@@ -0,0 +1,30 @@
+---
+id: docs-beginners-linux
+title: New to terminals? Start here › Open the terminal › Linux
+kind: docs
+page: beginners
+page_title: New to terminals? Start here
+heading: Linux
+anchor: linux
+url: https://dexterm.xyz/docs/beginners#linux
+tags:
+  - docs
+  - beginners
+  - linux
+  - 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 your applications menu and search for **Terminal**. On many desktops, **Ctrl-Alt-T** also opens it.

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 passed the same automated tests in CI for 0.1.4. 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: the full CI suite passed for 0.1.4, though some file-permission checks are skipped. 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: the project's CI suite passed for 0.1.4, but nobody has used it much by hand. 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.