substrate diagnose — Environment and Health Report - Substrate

Run substrate diagnose when something is wrong — or before filing a bug report. It exits non-zero if any probe fails, and every probe is wrapped so that a missing or malformed config.json produces a diagnostic line rather than a crash. Pair its output with substrate logs --errors to answer most first-round questions on an issue.

Usage

substrate diagnose

What It Reports

Probe	Tells you
Environment	Node version, platform, the binary’s version and schema version.
Substrate	Whether `.substrate/` exists, and whether `config.json` parses.
Boards	Whether the substrate loads, and how many boards, policies, and members.
Database	Whether `data.sqlite` opens, and its current schema version.
Server	Whether a `serve` is live and which port it bound, read from `.substrate/serve.json`, falling back to probing `7475–7499`.
Skill	Whether the installed agent skill has drifted from this binary.
Log	Recent error activity from `.substrate/logs/substrate.log`.

Include the full output of substrate diagnose in every bug report, paired with substrate logs --errors. Together they answer most first-round questions.