docgen

Overview ¶

Command docgen generates Markdown documentation for every cobra command shipped by posh — both the binary-only commands (init, config, version) and the downstream-only commands that require a Plugin (prompt, execute, brew, require).

Output is one Markdown file per command, suitable for VitePress. The file header is rewritten so each page has a `# posh <subcommand>` title and a short YAML front matter block. Internal links between parent and subcommand pages keep cobra's default `.md` extension — VitePress resolves them.

Usage:

go run ./cmd/docgen --output docs/reference/cli