Skip to content

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

Closed as not planned

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

  1. github-actions commented on Feb 21, 2026

    @github-actions
    Contributor

    This issue doesn't fully meet our contributing guidelines.

    What needs to be fixed:

    • This is a feature request but doesn't use the Feature Request template
    • The title should start with [FEATURE]: prefix
    • Please confirm the verification checkbox: "I have verified this feature I'm about to request hasn't been suggested before."
    • Use the Feature Request template format with the description field

    Please edit this issue to address the above within 2 hours, or it will be automatically closed.

    If you believe this was flagged incorrectly, please let a maintainer know.

  2. changed the title [-]Auto-generate CLI reference docs from help.ts[/-] [+][Feature]: Auto-generate CLI reference docs from help.ts[/+] on Feb 21, 2026
  3. maphew commented on Feb 21, 2026

    @maphew
    ContributorAuthor

    the title has been fixed to comply with guidelines, but there is no checkbox to check I confirm I've searched for prior issues, so I can't comply.

  4. transferred this issue fromKilo-Org/kiloon Feb 25, 2026
  5. github-actions commented on Jun 13, 2026

    @github-actions
    Contributor

    To stay organized issues are automatically closed after 60 days of no activity. If the issue is still relevant please reopen it or create a fresh new one.

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