Skip to content

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

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

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

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