CLI: improve command descriptions in help output (#18486)
* CLI: clarify config vs configure descriptions * CLI: improve top-level command descriptions * CLI: make direct command help more descriptive * CLI: add commands hint to root help * CLI: show root help hint in implicit help output * CLI: add help example for command-specific help * CLI: tweak root subcommand marker spacing * CLI: mark clawbot as subcommand root in help * CLI: derive subcommand markers from registry metadata * CLI: escape help regex CLI name
This commit is contained in:
committed by
GitHub
parent
05a83b9e97
commit
b25f334fa2
@@ -7,6 +7,7 @@ import { formatDocsLink } from "../terminal/links.js";
|
||||
import { isRich, theme } from "../terminal/theme.js";
|
||||
import { shortenHomeInString, shortenHomePath } from "../utils.js";
|
||||
import { formatCliCommand } from "./command-format.js";
|
||||
import { formatHelpExamples } from "./help-format.js";
|
||||
|
||||
type SecurityAuditOptions = {
|
||||
json?: boolean;
|
||||
@@ -29,11 +30,16 @@ function formatSummary(summary: { critical: number; warn: number; info: number }
|
||||
export function registerSecurityCli(program: Command) {
|
||||
const security = program
|
||||
.command("security")
|
||||
.description("Security tools (audit)")
|
||||
.description("Audit local config and state for common security foot-guns")
|
||||
.addHelpText(
|
||||
"after",
|
||||
() =>
|
||||
`\n${theme.muted("Docs:")} ${formatDocsLink("/cli/security", "docs.openclaw.ai/cli/security")}\n`,
|
||||
`\n${theme.heading("Examples:")}\n${formatHelpExamples([
|
||||
["openclaw security audit", "Run a local security audit."],
|
||||
["openclaw security audit --deep", "Include best-effort live Gateway probe checks."],
|
||||
["openclaw security audit --fix", "Apply safe remediations and file-permission fixes."],
|
||||
["openclaw security audit --json", "Output machine-readable JSON."],
|
||||
])}\n\n${theme.muted("Docs:")} ${formatDocsLink("/cli/security", "docs.openclaw.ai/cli/security")}\n`,
|
||||
);
|
||||
|
||||
security
|
||||
|
||||
Reference in New Issue
Block a user