Skip to content

[Feature]: Auto-generate CLI reference docs from help.ts #6291

@maphew

Description

@maphew

Summary

Use generateHelp from src/kilocode/help.ts to auto-generate CLI reference documentation, eliminating manual maintenance of the command table in cli.md and adding a full detailed reference page.

Problem

packages/kilo-docs/pages/code-with-ai/platforms/cli.md contains a hand-written command table that is already stale — lists kilo github (disabled), missing acp and help. Every command add/remove/rename requires a manual docs update that is easy to forget.

Design

Two generated artifacts, one source of truth:

  1. Quick reference table — a Markdoc partial (cli-commands-table.md) included in the existing CLI docs page via {% partial %}. Replaces the hand-written table.
  2. Full CLI reference page — a standalone page (cli-reference.md) with detailed help for every command and subcommand, generated by generateHelp({ all: true, format: "md" }).

Both are generated by script/generate.ts and auto-committed by the existing generate.yml workflow on push to dev.

Depends on

Status

🚧 Work in progress on branch feat/help-all-command

Metadata

Metadata

Assignees

No one assigned

    Labels

    contributordocumentationImprovements or additions to documentationenhancementNew feature or requestkilo-auto-fixAuto-generated label by Kilokilo-triagedAuto-generated label by Kilo

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions