dexterm-cli 0.1.3 → 0.1.4

package/dist/packages/mcp/assets/kb/docs/docs-beginners-2-open-a-real-coin-by-contract-address.md

@@ -0,0 +1,43 @@
+---
+id: docs-beginners-2-open-a-real-coin-by-contract-address
+title: New to terminals? Start here › Ten-minute first win › 2. Open a real coin by contract address
+kind: docs
+page: beginners
+page_title: New to terminals? Start here
+heading: 2. Open a real coin by contract address
+anchor: 2-open-a-real-coin-by-contract-address
+url: https://dexterm.xyz/docs/beginners#2-open-a-real-coin-by-contract-address
+tags:
+  - docs
+  - beginners
+  - open
+  - real
+  - coin
+  - contract
+  - address
+  - 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
+---
+
+A **contract address**, often shortened to **CA**, is the long public identifier for a coin. It is public information, not a wallet secret.
+
+Press `g`. A small **go-to prompt** appears inside dexterm. Paste this DEXTERM project-token example and press Enter:
+
+```text DEXTERM project token example
+2huJ1cxDXpGrh2bPYxptaoLj89to8CnzdVC5aYTEpump
+```
+
+This is the verified address of the optional DEXTERM memecoin launched by the dexterm authors. It is not part of the software and has no utility or rewards. It appears here only as a stable public-address example, not as a recommendation or endorsement. Not financial advice. Verify the address before using it. You can instead use the verified public address of any Solana coin you choose.

package/dist/packages/mcp/assets/kb/docs/docs-beginners-3-read-the-safety-panel.md

@@ -0,0 +1,40 @@
+---
+id: docs-beginners-3-read-the-safety-panel
+title: New to terminals? Start here › Ten-minute first win › 3. Read the safety panel
+kind: docs
+page: beginners
+page_title: New to terminals? Start here
+heading: 3. Read the safety panel
+anchor: 3-read-the-safety-panel
+url: https://dexterm.xyz/docs/beginners#3-read-the-safety-panel
+tags:
+  - docs
+  - beginners
+  - read
+  - safety
+  - panel
+  - 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 coin's **token screen** opens. Find the **ON-CHAIN / SAFETY** area. “On-chain” means information read from Solana's public record. Read each source and its age.
+
+- **Mint authority** says whether someone can create more tokens.
+- **Freeze authority** says whether someone can freeze token accounts.
+- **Liquidity** is the pool available for buying and selling.
+- A **risk flag** points out a condition to inspect. It is not proof that a coin is safe or unsafe.
+
+If a value says unavailable or stale, treat it as unknown. Never turn missing data into a pass.

package/dist/packages/mcp/assets/kb/docs/docs-beginners-4-read-the-holder-panel.md

@@ -0,0 +1,35 @@
+---
+id: docs-beginners-4-read-the-holder-panel
+title: New to terminals? Start here › Ten-minute first win › 4. Read the holder panel
+kind: docs
+page: beginners
+page_title: New to terminals? Start here
+heading: 4. Read the holder panel
+anchor: 4-read-the-holder-panel
+url: https://dexterm.xyz/docs/beginners#4-read-the-holder-panel
+tags:
+  - docs
+  - beginners
+  - read
+  - holder
+  - panel
+  - 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 **holder** panel describes how ownership is distributed. `top 10` means the share held by the ten largest counted accounts. A pool or exchange account can distort that number, so read the labels and the sample note too. A concentrated supply is a reason to investigate, not a verdict.
+
+Press `?` at any time to see the keys that work on the current screen. Press `Esc` to close help or go back.

package/dist/packages/mcp/assets/kb/docs/docs-beginners-5-optionally-ask-the-analyst.md

@@ -0,0 +1,39 @@
+---
+id: docs-beginners-5-optionally-ask-the-analyst
+title: New to terminals? Start here › Ten-minute first win › 5. Optionally ask the analyst
+kind: docs
+page: beginners
+page_title: New to terminals? Start here
+heading: 5. Optionally ask the analyst
+anchor: 5-optionally-ask-the-analyst
+url: https://dexterm.xyz/docs/beginners#5-optionally-ask-the-analyst
+tags:
+  - docs
+  - beginners
+  - optionally
+  - ask
+  - analyst
+  - 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
+---
+
+If `doctor` found Claude Code and you are logged into your own Claude account, press `a`. Ask a plain question such as:
+
+```text
+Explain the safety and holder panels in beginner language. What is known, unknown, and stale?
+```
+
+The analyst uses your Claude account and may count toward that account's paid usage. Its answer is **model output**—text generated by an artificial-intelligence model—not a fact or financial advice. It can explain and navigate, but no voice or connected program can arm or sign a trade.

package/dist/packages/mcp/assets/kb/docs/docs-beginners-6-export-or-share-what-you-see.md

@@ -0,0 +1,34 @@
+---
+id: docs-beginners-6-export-or-share-what-you-see
+title: New to terminals? Start here › Ten-minute first win › 6. Export or share what you see
+kind: docs
+page: beginners
+page_title: New to terminals? Start here
+heading: 6. Export or share what you see
+anchor: 6-export-or-share-what-you-see
+url: https://dexterm.xyz/docs/beginners#6-export-or-share-what-you-see
+tags:
+  - docs
+  - beginners
+  - export
+  - share
+  - 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
+---
+
+Press `E` to export the current screen. An **export** is a saved copy: dexterm writes a PNG image (a common image-file format) and a plain-text report under `~/.dexterm/exports/`. The `~` means your home folder. Nothing is uploaded or posted.
+
+Open that folder with your normal file manager if you want to share the files yourself. Check the image and text before sending them; a live coin view may contain a public wallet address or other details you would rather hide. dexterm never posts for you.

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

@@ -0,0 +1,34 @@
+---
+id: docs-beginners-7-quit-safely
+title: New to terminals? Start here › Ten-minute first win › 7. Quit safely
+kind: docs
+page: beginners
+page_title: New to terminals? Start here
+heading: 7. Quit safely
+anchor: 7-quit-safely
+url: https://dexterm.xyz/docs/beginners#7-quit-safely
+tags:
+  - docs
+  - beginners
+  - quit
+  - safely
+  - 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
+---
+
+Press `q`. dexterm restores the terminal and the prompt returns. Closing the window also ends the shell, but `q` is the normal exit.
+
+That is the first win: one real, read-only coin review, one optional explanation, one local export, and no wallet connection.

package/dist/packages/mcp/assets/kb/docs/docs-beginners-before-any-experimental-trading.md

@@ -0,0 +1,33 @@
+---
+id: docs-beginners-before-any-experimental-trading
+title: New to terminals? Start here › Before any experimental trading
+kind: docs
+page: beginners
+page_title: New to terminals? Start here
+heading: Before any experimental trading
+anchor: before-any-experimental-trading
+url: https://dexterm.xyz/docs/beginners#before-any-experimental-trading
+tags:
+  - docs
+  - beginners
+  - before
+  - any
+  - experimental
+  - trading
+  - 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
+---
+
+Stop here until you are comfortable reading the app. Trading is experimental and has known bugs. It begins in PAPER simulation, which uses pretend funds. In the wallet path, Phantom shows and approves each wallet action, the keypress gate (a required physical key press) is on by default, and hard spending limits remain enforced in a separate signing process. No analyst, voice, or connected program can arm or sign.
+
+Never enter a seed phrase, private key, password, API key, or authentication token. Read the paper and wallet guide (https://dexterm.xyz/docs/paper-trading) before considering anything beyond the read-only walkthrough.

package/dist/packages/mcp/assets/kb/docs/docs-beginners-check-the-installation-with-doctor.md

@@ -0,0 +1,38 @@
+---
+id: docs-beginners-check-the-installation-with-doctor
+title: New to terminals? Start here › Check the installation with doctor
+kind: docs
+page: beginners
+page_title: New to terminals? Start here
+heading: Check the installation with doctor
+anchor: check-the-installation-with-doctor
+url: https://dexterm.xyz/docs/beginners#check-the-installation-with-doctor
+tags:
+  - docs
+  - beginners
+  - check
+  - installation
+  - doctor
+  - 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
+---
+
+Run:
+
+```sh check dexterm
+dexterm doctor
+```
+
+`doctor` is a read-only check. A check mark means that part is ready. A warning means an optional part is missing. A failure includes a suggested fix. It never asks for a wallet key, password, seed phrase, or token.
+
+The Claude line may warn that Claude Code is missing. That is okay: the screener works without it. Only the optional analyst needs your own Claude Code installation and login.

package/dist/packages/mcp/assets/kb/docs/docs-beginners-choose-a-setup-path.md

@@ -0,0 +1,30 @@
+---
+id: docs-beginners-choose-a-setup-path
+title: New to terminals? Start here › Choose a setup path
+kind: docs
+page: beginners
+page_title: New to terminals? Start here
+heading: Choose a setup path
+anchor: choose-a-setup-path
+url: https://dexterm.xyz/docs/beginners#choose-a-setup-path
+tags:
+  - docs
+  - beginners
+  - 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
+---
+
+Use one method for your computer. You do not need to run every method.

package/dist/packages/mcp/assets/kb/docs/docs-beginners-common-mistakes-and-recovery.md

@@ -0,0 +1,30 @@
+---
+id: docs-beginners-common-mistakes-and-recovery
+title: New to terminals? Start here › Common mistakes and recovery
+kind: docs
+page: beginners
+page_title: New to terminals? Start here
+heading: Common mistakes and recovery
+anchor: common-mistakes-and-recovery
+url: https://dexterm.xyz/docs/beginners#common-mistakes-and-recovery
+tags:
+  - docs
+  - beginners
+  - 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
+---
+
+Most first-run problems are a closed window, a missed prompt, or a command folder that is not on PATH. Use the matching recovery below.

package/dist/packages/mcp/assets/kb/docs/docs-beginners-copy-and-paste-without-surprises.md

@@ -0,0 +1,39 @@
+---
+id: docs-beginners-copy-and-paste-without-surprises
+title: New to terminals? Start here › Copy and paste without surprises
+kind: docs
+page: beginners
+page_title: New to terminals? Start here
+heading: Copy and paste without surprises
+anchor: copy-and-paste-without-surprises
+url: https://dexterm.xyz/docs/beginners#copy-and-paste-without-surprises
+tags:
+  - docs
+  - beginners
+  - copy
+  - paste
+  - without
+  - surprises
+  - 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
+---
+
+Copy only the text inside a code box. Do not copy a leading `$`; it represents the prompt. Paste one line, read it once, then press Enter.
+
+| computer | copy | paste |
+|---|---|---|
+| macOS Terminal | Command-C | Command-V |
+| Linux terminal | Ctrl-Shift-C | Ctrl-Shift-V |
+| Windows Terminal | Ctrl-Shift-C | Ctrl-Shift-V |
+
+Right-click and choose **Paste** if the shortcut does not work. A multi-line paste can run several commands, so this guide uses one command per box. Never paste a command you do not understand; read the sentence above it first.

package/dist/packages/mcp/assets/kb/docs/docs-beginners-if-data-says-unavailable-stale-or-rate-limited.md

@@ -0,0 +1,35 @@
+---
+id: docs-beginners-if-data-says-unavailable-stale-or-rate-limited
+title: New to terminals? Start here › Common mistakes and recovery › If data says unavailable, stale, or rate limited
+kind: docs
+page: beginners
+page_title: New to terminals? Start here
+heading: If data says unavailable, stale, or rate limited
+anchor: if-data-says-unavailable-stale-or-rate-limited
+url: https://dexterm.xyz/docs/beginners#if-data-says-unavailable-stale-or-rate-limited
+tags:
+  - docs
+  - beginners
+  - data
+  - says
+  - unavailable
+  - stale
+  - rate
+  - limited
+  - common
+  - mistakes
+  - recovery
+  - new
+  - terminals
+  - start
+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
+---
+
+That is an honest degraded state, not a broken safety check. Wait, press `r` where the help overlay lists refresh, or try later. Do not assume a missing warning means a coin passed.

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.