zoahdev/dsh-firstrun
First-run health check for DeepSeek Harness (dsh): verifies Node/pnpm/dsh toolchain, profile, API key (names o
dsh-firstrun is a first-run health check for DeepSeek Harness: one command tells a new user what's missing and what to run next. It verifies the pieces that trip up every first-hour user — Node.js, pnpm, the dsh CLI, home directory, dsh profile, API key (names only, never values), workspace writability, npm registry — and prints actionable next steps with exit codes (0 ready, 1 needs attention, 2 usage error). In-harness, the agent-callable quickstart tool returns a dsh-firstrun/v1 report with per-check status, detail and nextStep fields. It closes the loop between dsh-plugin-doctor (plugin health) and dsh-cn-boot (network): a single user-facing checklist plus next steps.
Install
dsh plugin add dsh-firstrunnpm dsh-firstrun 0.1.0 verified 2026-09-04 (maintainer 'zoah' prefix-consistent with GitHub owner zoahdev; README EN primary w/ zh section, CI badge links the npm package). Install: dsh plugin add dsh-firstrun, or run standalone: npx dsh-firstrun [--json].
Compatibility
DeepSeek Harness (dsh) — checks Node.js, pnpm, dsh CLI, HOME, profile, API key env names, workspace writability and npm registry; zero runtime dependencies, read-only.
Details
- Repo: zoahdev/dsh-firstrun
- Category: Web UI Enhancements
- Stars: 0
- Version: npm dsh-firstrun 0.1.0
- Last push: 2026-08-18
- First seen: 2026-08-18
Recent updates
Zero runtime dependencies; values (API keys) are never printed — only environment variable names.
FAQ
- What does it check?
- Node.js, pnpm, the dsh CLI, HOME/USERPROFILE, the dsh profile, API-key env names, workspace writability, and npm registry resolution — each with a next step when missing.
- Does it need an API key?
- No, and it is read-only by default; any write/apply is an explicit flag.
- Can I run it standalone?
- Yes — npx dsh-firstrun works outside the harness and prints the same report to the terminal.
Alternatives
Xrainsmile/DSH-Plugin-Doctor · coppynight/dsh-doctor