Delegate command's --help to local cli

Describe the bug

When using global cli, vp <dev/pack/bulid etc.> --help does not delegate to local cli. Instead, Vite+ maintained a help.rs to record all commands

This can cause bugs: when the global Vite+'s cli version is different from local cli's, the help document will mismatch with the real behavior.

What's more, I don't think having a document in global cli is good for maintaining, it requires Vite+ to update help.rs when upstream gets update every single time. It has already had some mismatch.

$ vp dev --help
VITE+ - The Unified Toolchain for the Web

Usage: vp dev [ROOT] [OPTIONS]

Run the development server.
Options are forwarded to Vite.

Arguments:
  [ROOT]  Project root directory (default: current directory)

Options:
  --host [HOST]        Specify hostname
  --port <PORT>        Specify port
  --open [PATH]        Open browser on startup
  --strictPort         Exit if specified port is already in use
  -c, --config <FILE>  Use specified config file
  --base <PATH>        Public base path
  -m, --mode <MODE>    Set env mode
  -h, --help           Print help
  # ⚠️⚠️ Missed: `--force`, `--experimentalBundle`, `--debug` etc. ⚠️⚠️

Examples:
  vp dev
  vp dev --open
  vp dev --host localhost --port 5173

Documentation: https://viteplus.dev/guide/dev

However, directly delegating help document to local may bring new challenge. Different tools have different output formats. Vite itself, Vitest and tsdown use cac (no color / special format), while Oxlint and Oxfmt use its own colorful output, Vite+'s commands like vp check use viteplus style output. It's hard to make all tools' output unified. But I still believe document correctness should take precedence over brand consistency.

Reproduction

https://github.com/liang-demos/vite-plus-help-message-mismatch.git

Steps to reproduce

vp dev --help
vpr localhelp --help

Local cli's help message is not completely proper, either.

# Should be `vp test ...`
% vpx vp test --help
vitest/4.1.9

Usage:
  $ vitest [...filters]

Commands:
  run [...filters]      
  related [...filters]  
  watch [...filters]    
  dev [...filters]      
  bench [...filters]    
  init <project>        
  list [...filters]     
  [...filters]          
  complete [shell]      

For more info, run any command with the `--help` flag:
  $ vitest run --help
  $ vitest related --help
  $ vitest watch --help
  $ vitest dev --help
  $ vitest bench --help
  $ vitest init --help
  $ vitest list --help
  $ vitest --help
  $ vitest complete --help
  $ vitest --help --expand-help

# Should be `vp dev`
$ vpx vp dev --help 
vp/0.2.1

Usage:
  $ vp [root]

Commands:
  [root]           start dev server
  build [root]     build for production
  optimize [root]  pre-bundle dependencies (deprecated, the pre-bundle process runs automatically and does not need to be called)
  preview [root]   locally preview production build

For more info, run any command with the `--help` flag:
  $ vp --help
  $ vp build --help
  $ vp optimize --help
  $ vp preview --help

fix(cli): delegate command help to local cli (#2184)

Navigation Menu

Repository navigation

Delegate command's `--help` to local cli #1995

Describe the bug

Reproduction

Steps to reproduce

Metadata

Assignees

Labels

Type

Fields

Projects

Milestone

Relationships

Development

Delegate command's --help to local cli #1995

Description

Describe the bug

Reproduction

Steps to reproduce

Activity

liangmiQwQ commented on Jul 1, 2026

Metadata

Metadata

Assignees

Labels

Type

Fields

Projects

Milestone

Relationships

Development

Issue actions

Delegate command's `--help` to local cli #1995