Generate the CLI docs

[artberger]

Update the existing Helm & API docs workflow or create a new one to automatically update the CLI docs for:

• kagent
• kmcp

Resources:

• Existing API & Helm workflow: https://github.com/kagent-dev/website/blob/main/.github/workflows/update-ref-docs.yaml
• kagent CLI source: https://github.com/kagent-dev/kagent/blob/main/go/cli/cmd/kagent/main.go
• kmcp CLI source: https://github.com/kagent-dev/kmcp/tree/main/cmd

[yashrajshuklaaa]

hey @artberger will u assign me this

[peterj]

assigned to @yashrajshuklaaa

[yashrajshuklaaa]

hey @peterj
i’ve reviewed #262 regarding the CLI docs. currently, kagent’s CLI docs are manual MDX files while kmcp has none meanwhile, api and helm docs are already automated via update-ref-docs.yaml
my proposed approach is
automate: add a Go "docgen" command (using cobra/doc) to both the kagent and kmcp repos to generate markdown directly from the code
integrate: update the website repo's workflow to run these tools and sync the output into the docs folders
expand: add a new generated CLI section for kmcp
two questions for you sir :-
Where should the kmcp CLI docs live in the site hierarchy?
Should I keep any of the existing manual kagent text as intros, or switch to 100% generated content for command pages?
Lemme know if this aligns with your vision