dexterm-cli 0.1.3 → 0.1.5

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-use-codex-instead-of-claude.md

@@ -0,0 +1,35 @@
+---
+id: docs-analyst-use-codex-instead-of-claude
+title: The analyst › Use Codex instead of Claude
+kind: docs
+page: analyst
+page_title: The analyst
+heading: Use Codex instead of Claude
+anchor: use-codex-instead-of-claude
+url: https://dexterm.xyz/docs/analyst#use-codex-instead-of-claude
+tags:
+  - docs
+  - analyst
+  - use
+  - codex
+  - instead
+  - claude
+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
+---
+
+*Since 0.1.5.* The analyst can run on **your own Codex CLI login** instead of Claude. dexterm ships no key and reads no credential: the `codex` you set up and signed in to does the work, on your plan.
+
+- **Pick it:** `--analyst-engine codex` at launch, `DEXTERM_ANALYST_ENGINE=codex`, `"analyst": {"engine": "codex"}` in `~/.dexterm/config.json`, or type `/engine codex` in the chat box (it applies to new conversations; `/engine` alone shows the current engine and which CLIs it found). The default, `auto`, prefers Claude Code and falls back to Codex. Only you choose: the analyst cannot change its own engine.
+- **Same guarantees, enforced in the Codex CLI itself.** dexterm runs `codex exec --json` with your Codex config and rules files ignored, apps, plugins, hooks, skills discovery and sub-agents off, the shell and exec tools removed, the sandbox read-only, approvals `never` and web search off. Its only MCP server is the read-only `dexterm mcp`, limited by an allow-list: the read tools plus the UI actions the session allows (none in scan mode (https://dexterm.xyz/docs/scan)), never a paper or trade tool. If Codex still reports a command, a file change, a web search or any other tool, dexterm stops the turn and says so. The firewalled CONTEXT block, the skills and your own skill overlays are the same; the skill playbook is passed inline because Codex has no plugin directory.
+- **What is different.** Codex reports whole messages, so an answer appears per message rather than word by word. The caption shows `codex plan` instead of a dollar cost (Codex reports tokens, not cost). The model is your Codex default for your login; pin one with `DEXTERM_CODEX_MODEL`. Which models a ChatGPT plan allows is decided by your plan, not by dexterm.
+- **Codex errors are one line each:** no Codex CLI (`npm i -g @openai/codex && codex login`), a logged-out Codex (`codex login`), or an old one (update; the lock needs codex-cli 0.163.0 or newer, and an unknown lock flag fails the run instead of loosening it). `dexterm doctor` shows a Codex CLI line with the version and whether you are logged in. On Windows dexterm only starts a `codex.exe` on PATH; the npm `codex.cmd` shim is not started.
+- **How we checked.** Offline tests drive a fake `codex` through the real app path, and a measurement harness runs the real codex-cli 0.163.0 against a local mock model (no account, no model): the tool list Codex sends is the dexterm allow-list only, and forged shell, exec, patch, sub-agent and ticket calls come back "unsupported" without running. Answer quality and speed against Claude have not been benchmarked.
+
+Codex is also supported the other way round, as an MCP client that drives dexterm: `dexterm mcp install codex` (see bring your own agent (https://dexterm.xyz/docs/agents#install-in-one-command)).

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.

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.