dexterm-cli 0.1.2 → 0.1.4

package/dist/packages/mcp/assets/kb/docs/docs-analyst-mcp-tools.md

@@ -0,0 +1,33 @@
+---
+id: docs-analyst-mcp-tools
+title: The analyst › MCP tools
+kind: docs
+page: analyst
+page_title: The analyst
+heading: MCP tools
+anchor: mcp-tools
+url: https://dexterm.xyz/docs/analyst#mcp-tools
+tags:
+  - docs
+  - analyst
+  - mcp
+  - tools
+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/analyst.md
+date: 2026-10-16
+---
+
+`dexterm mcp` is a plain stdio MCP server with (generated from the app: see https://dexterm.xyz/docs/analyst#mcp-tools; app-help has the exact keys and commands) tools. The analyst is launched with `--strict-mcp-config` and only `mcp__dexterm__*` tools allowed; it has no shell, no file access and no other tools. You can add the same server to any Claude Code with:
+
+```sh
+$ claude mcp add dexterm -- node packages/mcp/bin/dexterm-mcp.mjs
+```
+
+(generated from the app: see https://dexterm.xyz/docs/analyst#mcp-tools; app-help has the exact keys and commands)
+
+The UI-action tools are the only way the analyst can change what you see, and they come in the three tiers below (https://dexterm.xyz/docs/analyst#what-it-can-change-three-tiers). Each action is re-validated by the app against the current screen's allow-list (a mint must already be on screen; a feed, sort key, screen or workspace must exist), rate-limited, and shown as "analyst did X". An injected instruction that names a coin not on screen is rejected and changes nothing. In scan mode (https://dexterm.xyz/docs/scan) the allow-list is empty and the launch disallows the UI-action tools.

package/dist/packages/mcp/assets/kb/docs/docs-analyst-plain-language-filters.md

@@ -0,0 +1,25 @@
+---
+id: docs-analyst-plain-language-filters
+title: The analyst › Plain-language filters
+kind: docs
+page: analyst
+page_title: The analyst
+heading: Plain-language filters
+anchor: plain-language-filters
+url: https://dexterm.xyz/docs/analyst#plain-language-filters
+tags:
+  - docs
+  - analyst
+  - plain-language
+  - filters
+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/analyst.md
+date: 2026-10-16
+---
+
+"show me coins under 5M mcap with over 100k liquidity, up on the day, not rugs" becomes a filter in the grammar (https://dexterm.xyz/docs/cli#filter-grammar) applied through `show_in_screener`, and the analyst states the numbers it chose (`low cap → mcap < 5M, safe → lplocked >= 100 !flag:mint !flag:freeze org > 50`). Follow-ups ("tighter", "only ones with locked LP", "drop the age limit") modify the current filter. The app re-parses the string with the real grammar and rejects anything malformed; an invented field never reaches the screener.

package/dist/packages/mcp/assets/kb/docs/docs-analyst-skills.md

@@ -0,0 +1,31 @@
+---
+id: docs-analyst-skills
+title: The analyst › Skills
+kind: docs
+page: analyst
+page_title: The analyst
+heading: Skills
+anchor: skills
+url: https://dexterm.xyz/docs/analyst#skills
+tags:
+  - docs
+  - analyst
+  - skills
+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/analyst.md
+date: 2026-10-16
+---
+
+Four versioned skills ship with the app ((generated from the app: see https://dexterm.xyz/docs/analyst#skills; app-help has the exact keys and commands)). Each forces a JSON schema the app renders beside the summary (verdict, bias, setup quality, key levels, invalidation, size hint, `missing_data`, `sources_used`, `injection_detected`).
+
+| skill | started by | what it does |
+|---|---|---|
+| `token-dossier` | `a` on the token screen; a scan lock; `get_dossier` in one round trip | market, holders and concentration, authorities, RugCheck, candle summary, tape aggregate, creator. A partial verdict with `missing_data` when a section is unavailable; it refuses only when there is no price and no liquidity. |
+| `rug-check` | `a` on a list screen with a coin highlighted | the risk read: authorities, LP lock, holder concentration, tape, wallet share, dev history where the tier allows. |
+| `trench-scan` | `a` on a list screen with nothing highlighted | a read of the screener as a whole: what is running, what is organic, what to look at. |
+| `larp-check` | `V` on a live token | vets the advertised website, domain and GitHub; see LARP detector (https://dexterm.xyz/docs/larp). |

package/dist/packages/mcp/assets/kb/docs/docs-analyst-starting-a-run.md

@@ -0,0 +1,33 @@
+---
+id: docs-analyst-starting-a-run
+title: The analyst › Starting a run
+kind: docs
+page: analyst
+page_title: The analyst
+heading: Starting a run
+anchor: starting-a-run
+url: https://dexterm.xyz/docs/analyst#starting-a-run
+tags:
+  - docs
+  - analyst
+  - starting
+  - run
+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/analyst.md
+date: 2026-10-16
+---
+
+Nothing runs behind your back. Opening a token with `⏎` is free. A paid run starts only when you:
+
+- press `a` on a list screen: a **rug-check** of the highlighted coin, or a **trench-scan** of the screener when nothing is highlighted, on the analyst tab;
+- press `a` on the token screen: the full **token-dossier** for that coin (once a conversation exists, `a` just toggles the panel);
+- press `V` on a live token: the **larp-check** of its website and socials (see LARP detector (https://dexterm.xyz/docs/larp));
+- type a question (`i` or `⏎` to focus, `⏎` to send). A question is a chat turn on the warm session, or a new session with that question as its first turn, never a structured skill run;
+- let AI scan mode (https://dexterm.xyz/docs/scan) lock a coin.
+
+Each token keeps its own conversation for the run; the analyst tab has its own. `esc` interrupts a running answer from any screen. The caption under an answer shows cost, latency, tool calls and the model.

package/dist/packages/mcp/assets/kb/docs/docs-analyst-what-it-can-change-three-tiers.md

@@ -0,0 +1,33 @@
+---
+id: docs-analyst-what-it-can-change-three-tiers
+title: The analyst › What it can change: three tiers
+kind: docs
+page: analyst
+page_title: The analyst
+heading: What it can change: three tiers
+anchor: what-it-can-change-three-tiers
+url: https://dexterm.xyz/docs/analyst#what-it-can-change-three-tiers
+tags:
+  - docs
+  - analyst
+  - can
+  - change
+  - three
+  - tiers
+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/analyst.md
+date: 2026-10-16
+---
+
+| tier | actions | how it applies |
+| --- | --- | --- |
+| **view** (immediate) | `open_token`, `show_in_screener`, `add_to_watchlist`, `switch_feed`, `open_ticket`, `switch_screen`, `switch_workspace`, `chart_popup`, `toggle_calm`, `set_scan`, `export_view` | applied at once, re-validated against the current screen, and shown as "analyst did X". Local and reversible. `open_ticket` only opens the PAPER ticket in its editing phase. |
+| **config** (you confirm) | `set_theme`, `set_price_mode`, `set_intensity` | never applied by the model. It becomes a one-line proposal; `y` within 8 seconds accepts it and any other key dismisses it. An accepted change is written through the journaled config path as actor `analyst`, so `ctrl+z` undoes it. A proposal never takes a key you are typing into a prompt or the chat. |
+| **never** | anything touching wallets, keys, credentials, alert-channel secrets, signing, arming, caps, mandates, trade tickets beyond the PAPER `open_ticket`, network or RPC settings, voice settings, or installing and updating software | no such action exists. A request fails as an unknown action, and the config write re-runs the model-actor policy check, so even a mis-mapped action cannot write a denied path. |
+
+Voice speed and voice name are keyboard-only on purpose. The analyst can explain how to change them (`<` / `>`, `,`, or `config.json`), but it cannot change them, even behind a confirm.

package/dist/packages/mcp/assets/kb/docs/docs-analyst-what-it-sees.md

@@ -0,0 +1,26 @@
+---
+id: docs-analyst-what-it-sees
+title: The analyst › What it sees
+kind: docs
+page: analyst
+page_title: The analyst
+heading: What it sees
+anchor: what-it-sees
+url: https://dexterm.xyz/docs/analyst#what-it-sees
+tags:
+  - docs
+  - analyst
+  - sees
+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/analyst.md
+date: 2026-10-16
+---
+
+Every turn carries a firewalled **CONTEXT** block: the screen you are on, the filter and sort, the selected or hovered coin, the visible rows (price, change, liquidity, volume), your watchlist, and any open PAPER ticket or position. So "this coin", "it" and "the highlighted one" resolve without asking. Token names, descriptions, socials, RugCheck text and fetched page text are wrapped as `<untrusted>` data before the model sees them; instruction-like text inside such a block is itself reported as a red flag (`injection_detected`) and never followed.
+
+Facts come only from tools. The system prompt forbids token facts from model memory: every number, address, flag and level must come from a tool result in the session, each carrying its source and age. The knowledge base explains mechanics and patterns; it never holds a fact about a live token.

package/dist/packages/mcp/assets/kb/docs/docs-analyst-what-the-analyst-can-never-do.md

@@ -0,0 +1,31 @@
+---
+id: docs-analyst-what-the-analyst-can-never-do
+title: The analyst › What the analyst can never do
+kind: docs
+page: analyst
+page_title: The analyst
+heading: What the analyst can never do
+anchor: what-the-analyst-can-never-do
+url: https://dexterm.xyz/docs/analyst#what-the-analyst-can-never-do
+tags:
+  - docs
+  - analyst
+  - can
+  - never
+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/analyst.md
+date: 2026-10-16
+---
+
+- sign, send or confirm a transaction. No tool builds, signs or sends anything; there is no signer for it to talk to.
+- confirm a PAPER trade. `open_ticket` opens the ticket in its editing phase; your keys arm and confirm it.
+- act on a coin that is not on your screen, or act at all while the scan has the session.
+- use its memory about a token. Facts come from tools or they are not facts.
+- follow text found in a token's name, description, socials or website. That text is data, wrapped and flagged.
+- read your keys. It never sees the RPC key, your wallet, or your Claude credentials; dexterm only spawns the `claude` binary already on your machine.
+- persist a setting on its own. A theme, price-mode or intensity change waits for your `y`; voice, wallet, alert, network and money settings have no action at all.

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

@@ -0,0 +1,23 @@
+---
+id: docs-analyst
+title: The analyst
+kind: docs
+page: analyst
+page_title: The analyst
+url: https://dexterm.xyz/docs/analyst
+tags:
+  - docs
+  - analyst
+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/analyst.md
+date: 2026-10-16
+---
+
+What Claude sees, the skills, the MCP tools, the short bold answer style, and what it can never do.
+
+The analyst is **your own Claude Code login**, spawned as a local `claude` process by dexterm. No API key ships with the app; your subscription, billing and limits apply. It talks to the app through a read-only MCP server (`dexterm mcp`) that exposes the same data adapters the screens use, a sourced knowledge base and historical case files. Default model: `(generated from the app: see https://dexterm.xyz/docs/analyst; app-help has the exact keys and commands)` (override with `DEXTERM_ANALYST_MODEL`).

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

@@ -0,0 +1,35 @@
+---
+id: docs-beginners-1-start-dexterm
+title: New to terminals? Start here › Ten-minute first win › 1. Start dexterm
+kind: docs
+page: beginners
+page_title: New to terminals? Start here
+heading: 1. Start dexterm
+anchor: 1-start-dexterm
+url: https://dexterm.xyz/docs/beginners#1-start-dexterm
+tags:
+  - docs
+  - beginners
+  - start
+  - dexterm
+  - ten-minute
+  - first
+  - win
+  - new
+  - terminals
+  - 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
+---
+
+```sh launch dexterm
+dexterm
+```
+
+The first launch shows a welcome card. Press any key once to reach the **screener**, the live list of coins. A **screen** is one full view inside dexterm.

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.