feat: add kilo help --all command and auto-generated CLI reference docs

[kilo-code-bot]

Re-opens #6116 (from maphew/kilocode) with main merged in and conflict resolved.

Note: Re-created from Kilo-Org/kilo#571 per @markijbema's request, since the repo has moved to kilocode.

Closes #6114

Summary

• Add kilo help --all command that outputs full CLI reference in markdown or plain text format
• Add generateCommandTable() function that produces a markdown command table from the command barrel
• Auto-generate two docs artifacts via script/generate.ts: a Markdoc partial for the command table and a full CLI Command Reference page
• Replace the hand-written (stale) command table in cli.md with the generated partial
• Add CLI Command Reference nav entry in the docs site

Credit

The quick-reference table format was inspired by @Githubguy132010's contribution in #6294 — thanks for the idea!

Changes

kilo help command

• src/kilocode/help.ts — Core generateHelp() + new generateCommandTable() functions
• src/kilocode/help-command.ts — HelpCommand yargs CommandModule
• src/cli/commands.ts — Barrel file exporting all CommandModule objects
• src/index.ts — Replaced 19 individual .command() calls with barrel import + loop

Auto-generated docs

• script/generate-cli-docs.ts — Generation script (runs with --conditions=browser)
• src/kilocode/generate-cli-docs.ts — Entrypoint that writes both generated files
• script/generate.ts — Added CLI docs generation step before format
• packages/kilo-docs/markdoc/partials/cli-commands-table.md — Generated command table partial
• packages/kilo-docs/pages/code-with-ai/platforms/cli-reference.md — Generated full reference page

Docs site updates

• packages/kilo-docs/pages/code-with-ai/platforms/cli.md — Replaced hand-written table with {% partial %}
• packages/kilo-docs/lib/nav/code-with-ai.ts — Added "Command Reference" subLink under CLI

Usage

kilo help --all                    # Full CLI reference in Markdown
kilo help auth                     # Scoped to auth command + subcommands
kilo help --all --format text      # Plain text format
kilo help --all > REFERENCE.md     # Pipeable to file

Testing

• 15 tests in test/kilocode/help.test.ts (no mocks) — markdown/text output, subcommands, filtering, ANSI stripping, table generation, edge cases
• Typecheck clean (bun turbo typecheck)
• Docs build succeeds with new cli-reference page

[kilo-code-bot]

Code Review Summary

Status: 2 Issues Found | Recommendation: Address before merge

Overview

Severity	Count
CRITICAL	0
WARNING	2
SUGGESTION	0

Fix these issues in Kilo Cloud

Issue Details (click to expand)

The incremental packages/opencode/src/kilocode/commands.ts and packages/opencode/test/kilocode/help.test.ts changes do not introduce new defects.

Previously reported issue for the sync-test robustness at packages/opencode/test/kilocode/help.test.ts:168 is resolved in the current diff. Previously reported issues for global --help, kilo remote, nested subcommands, and the default kilo entrypoint remain resolved.

Other Observations (not in diff)

Issues found in unchanged code that cannot receive inline comments:

File	Line	Issue
packages/kilo-docs/pages/code-with-ai/platforms/cli-reference.md	803	The generated CLI reference artifact is still stale and still omits a kilo completion section even though the command barrel exports that command
packages/opencode/test/kilocode/help.test.ts	39	The local command fixture still diverges from the real command registry, so the generated help/table assertions still do not validate the actual exported command list or the synthetic completion entry

Files Reviewed (2 files)

• packages/opencode/src/kilocode/commands.ts - 0 issues
• packages/opencode/test/kilocode/help.test.ts - 0 new issues

---

_{Reviewed by gpt-5.4-20260305 · 667,585 tokens}

[alex-alecu]