Quickstart

Current release line

v0.2.0-alpha.1 is the current alpha. Ordinary installs follow the alpha channel; plugins, CI, and reproducible environments should pin Blue 0.2.0-alpha.1 and Harness 0.1.2-alpha.3. Harness RC releases are not supported. This page is the user install path; the contributor development install (checkout, link install, iteration loop) lives in the developer manual under Contributing to Blue.

Prerequisites

Dependency	Version
Node	^22.19.0 || >=24.0.0
pnpm	11 (needed for first assembly, upgrades, and plugin management; an already-calibrated profile does not check it on every boot. Run npm i -g pnpm@11, or corepack enable && corepack prepare pnpm@11.7.0 --activate)
dsh CLI	the recommended blue launcher includes exactly 0.1.2-alpha.3; only the direct-dsh path below installs it separately

Install (preview)

Recommended: the integrated blue launcher. It carries the pinned Harness closure as common and platform archives, so npm installs one dependency-free package without resolving the Harness graph or running its install scripts:

npm i -g @dsh-blue/blue-cli@alpha
blue

If the first run reports missing pnpm or a non-11 major:

npm i -g pnpm@11
# or: corepack enable && corepack prepare pnpm@11.7.0 --activate

The launcher npm install writes the shell and compressed runtime layers. The first command that needs dsh expands only the common and current-platform layers into a user cache with bounded memory and no network request. The first blue run still assembles the Blue profile through dsh plugin add and pnpm; that separate operation downloads the Blue plugin closure and can be resumed from pnpm's cache. On slow or metered networks in China, point both registries at a mirror:

pnpm config set registry https://registry.npmmirror.com
npm config set registry https://registry.npmmirror.com   # /update's version check goes through npm

Or install over your own dsh (bring your own host — for existing dsh users):

npm i -g @deepseek-ai/dsh
dsh plugin --profile blue add @dsh-blue/blue@alpha
dsh --profile blue

After installing, follow the two sections below — one key, then a first run; models, providers, themes, and API keys are covered in detail in Configuration.

• @alpha is the current installation channel; latest remains reserved for stable, and RC is outside this Harness compatibility contract.
• Upgrading to a newer alpha: shell users re-run npm i -g @dsh-blue/blue-cli@alpha (reinstalling is the upgrade — the shell calibrates the profile's Blue to its own version and pins the host line with it); direct-dsh users type /update inside Blue (the in-app safe upgrade: pre-flight, snapshot, boot smoke, automatic rollback), or re-run the same plugin add.

One key before you ride

A single DEEPSEEK_API_KEY is all it takes to start using Blue — the out-of-the-box default talks to the DeepSeek official API (route deepseek-official, default model deepseek-v4-flash); nothing else to configure:

export DEEPSEEK_API_KEY=sk-...        # or store it in ~/.dsh/.credentials.yaml, once and for all

Switching models, wiring custom gateways, theming, and more: Configuration.

First run

blue                        # interactive: welcome banner + input editor
blue fix the null deref on the login page    # run a task directly
# direct-dsh users: dsh --profile blue (the two are equivalent — the shell
# just manages the host and the profile for you)

A few things to try first:

• type / to see slash-command autocomplete, /help for the command and key overview;
• ask something and watch the streaming reply and tool cards;
• /theme lists all six themes with the current one marked (dark/light/ocean/paper/auto/custom); /theme ocean hot-swaps and your draft survives. The Theme row in the /settings panel cycles the same palettes live and persists the default;
• on exit, the last line is the session epitaph: the session id and a one-line resume command (a triple-click selects exactly it) — pick the conversation right back up next time.

Interface preview