dsh-firstrun

The hardest part of a first-time DeepSeek Harness setup is rarely a single cryptic error. It is the fog: no idea whether Node is on PATH, pnpm is installed, the API key is actually set, or the working directory is writable. Every missing piece produces a different failure, and the error messages rarely point you back to the true cause.

dsh-firstrun collapses those eight checks into one read-only command with zero runtime dependencies. It verifies Node.js, pnpm, the dsh CLI, the home directory, the dsh profile, API key environment variables, workspace writability, and npm registry connectivity, then prints actionable next steps for each gap. API key values are never displayed, only the variable names. Exit codes distinguish ready, needs-attention, and usage-error at a glance, and inside the Harness the agent can invoke the tool directly and receive a structured report.

It is built for newcomers hitting the typical first-hour friction, teams onboarding new machines in bulk, and developers who want a quick post-reinstall sanity check on their toolchain.