Getting Started

Xiaotaozi DSH ships as a single CLI: xtz. It wraps a pinned DeepSeek Harness runtime, prepares the official web profile, and seeds six first-party plugins on first start. The UI is the official dsh web, opened in your browser — there is no desktop app to install.

Prerequisites

• Node.js ^22.19.0 or >=24 on your PATH. Same range as DeepSeek Harness; Node 23 is not supported.
• macOS or Linux shell. npm and bun are only used as installers — xtz always runs on Node.

Managing Node versions

If you use a version manager such as fnm, nvm, or mise, install a supported version first, e.g. fnm install 22.19.0 && fnm use 22.19.0, or Node 24+.

Install

Pick one of the three:

script

curl -fsSL https://raw.githubusercontent.com/kedoupi/xiaotaozi-dsh/main/apps/cli/scripts/install.sh | sh

npm

npm install -g xiaotaozi-dsh-cli

bun

bun add -g xiaotaozi-dsh-cli

The script prefers npm when both npm and bun are present; pass --bun or --pnpm to choose explicitly:

curl -fsSL https://raw.githubusercontent.com/kedoupi/xiaotaozi-dsh/main/apps/cli/scripts/install.sh | sh -s -- --bun

First run

xtz start

On first start, xtz:

1. Prepares the official Harness home at ~/.dsh/profiles/web (first launch, or after you move that profile aside).
2. Seeds all six first-party plugins — Models, IM bots, WeCom office, Xiaotaozi UI, Side card, and Market. Already-installed plugins are not upgraded on a later xtz start; see FAQ to pick up a new snapshot.
3. Starts the official dsh web service in the background on 127.0.0.1:3080.
4. Prints the URL and opens your browser.

Verify the installation

xtz --help     # command overview
xtz status     # inspect the remembered port without changing anything
xtz doctor     # inspect runtime, xtz stamp, profile, and port

xtz doctor is the health check: it verifies the pinned Node and DSH versions, the profile state, and the port. If something is off, it tells you exactly what.

Next steps

• Sign in to a model provider: open Settings → Models. See Plugins.
• Chat with your agent from an IM app: sidebar → IM bots.
• Install extra plugins: sidebar → Market. See Plugin Market.
• Full command list: CLI Reference.

Uninstall

Remove the CLI with the installer you used (npm rm -g xiaotaozi-dsh-cli or bun remove -g xiaotaozi-dsh-cli). Your Harness home stays at ~/.dsh until you remove it yourself.