You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
The Darling command line verbs have no single reference; a reader must know which README section holds each one #6413
Who hits it: Darling admin and anyone scripting an install.
Where:Darling/README.md (verbs appear in at least 14 sections); Darling/PerformanceMonitor.Darling.Service/DarlingCliCommands.cs.
What is wrong or hard:
The service exe has many verbs: --test-connection, --validate-config, --check-settings, --diagnostics-bundle, --encrypt-password, --add-server, --enable-mcp, --disable-mcp, --enable-web, --disable-web, --configure-network, --configure-firewall, --export-viewer-config, --reset-password-key, --drop-xe-sessions, --set-collector-run-at, --enable-collector, --disable-collector, --backfill-rollups, --collapse-legacy-slices, --recompress-plan-dim, --add-alert-source, --print-sql. Each is explained where its feature is explained. There is no list that shows all of them with the one-line purpose, whether it needs elevation, whether the service must be stopped, and its exit codes. Exit codes are written out in long paragraphs (README lines 164-168), which is hard to scan.
Evidence:
Every verb above exists as a string in DarlingCliCommands.cs (checked with grep).
The exit code paragraphs for --check-settings, --enable-collector and --diagnostics-bundle differ slightly from each other, and each is a single long paragraph.
Proposed fix:
Add a "Command line reference" table to the Darling docs: verb, what it does, needs elevation (yes/no), service running (yes/no/either), exit codes, link. Generate or test the table against the verb list in the code so it cannot drift. Remove the long exit code paragraphs from the Quick Start.
On erikdarling.com? A searchable version on the website would help, but the table should live in the repo first.
Correction after checking this issue against current dev:
The list in this issue is not the full set. The 23 verbs it names all exist, but the code has about 17 more, for example --help, --version, --harden-files, --print-mcp-token, --print-web-token, --print-viewer-connection, --set-collector-frequency, --set-collector-retention, and the alert-source verbs.
--help already prints a usage text (DarlingCliCommands.cs). Whether it covers every verb was not checked. There is still no reference table in the docs.
The fix should generate the reference from the same source as --help, so the two cannot drift apart.
Activity
erikdarlingdata commentedon Oct 22, 2026
Claude posting for Erik Darling.
Correction after checking this issue against current
dev:--help,--version,--harden-files,--print-mcp-token,--print-web-token,--print-viewer-connection,--set-collector-frequency,--set-collector-retention, and the alert-source verbs.--helpalready prints a usage text (DarlingCliCommands.cs). Whether it covers every verb was not checked. There is still no reference table in the docs.The fix should generate the reference from the same source as
--help, so the two cannot drift apart.Docs: command line reference exit codes name the store login and conn…
Docs: one command line reference for the Darling service (#6413) (#6699)
erikdarlingdata commentedon Oct 24, 2026
Claude posting for Erik Darling. Fixed on dev by #6699 (f50b345). Ships in the next release.