feat: add vpr as standalone shorthand for vp run

Add `vpr` as a shim binary that acts as a shorthand for `vp run`,
following the same pattern as `vpx` (shorthand for `vp exec`).
When invoked, `vpr` delegates to the same run-or-delegate logic:
local vite-plus CLI when vite-plus is a dependency, otherwise
falls back to `<pm> run`.

- Add vpr command module with execute_vpr entry point
- Add vpr detection in shim/mod.rs detect_shim_tool()
- Add vpr dispatch in shim/dispatch.rs
- Add vpr to SHIM_TOOLS in env setup and doctor
- Update tip message to mention vpr shorthand
- Update run guide, run RFC, and trampoline RFC docs

Author: fengmk2

crates/vite_global_cli/src/commands/env/doctor.rs

@@ -63,7 +63,7 @@ const KNOWN_VERSION_MANAGERS: &[(&str, &str)] = &[
 ];
 
 /// Tools that should have shims
-const SHIM_TOOLS: &[&str] = &["node", "npm", "npx", "vpx"];
+const SHIM_TOOLS: &[&str] = &["node", "npm", "npx", "vpx", "vpr"];
 
 /// Column width for left-side keys in aligned output
 const KEY_WIDTH: usize = 18;

crates/vite_global_cli/src/commands/env/setup.rs

@@ -23,8 +23,8 @@ use owo_colors::OwoColorize;
 use super::config::{get_bin_dir, get_vp_home};
 use crate::{cli::Args, error::Error, help};
 
-/// Tools to create shims for (node, npm, npx, vpx)
-const SHIM_TOOLS: &[&str] = &["node", "npm", "npx", "vpx"];
+/// Tools to create shims for (node, npm, npx, vpx, vpr)
+const SHIM_TOOLS: &[&str] = &["node", "npm", "npx", "vpx", "vpr"];
 
 fn accent_command(command: &str) -> String {
     if help::should_style_help() {

crates/vite_global_cli/src/commands/mod.rs

@@ -172,7 +172,8 @@ pub mod version;
 // Category D: Environment Management
 pub mod env;
 
-// Standalone binary command
+// Standalone binary commands
+pub mod vpr;
 pub mod vpx;
 
 // Self-Management

crates/vite_global_cli/src/commands/vpr.rs

@@ -0,0 +1,26 @@
+//! `vpr` command implementation.
+//!
+//! Standalone shorthand for `vp run`. Executes tasks via the same
+//! run-or-delegate logic: delegates to local vite-plus CLI when
+//! vite-plus is a dependency, otherwise falls back to `<pm> run`.
+
+use vite_path::AbsolutePath;
+use vite_shared::output;
+
+/// Main entry point for vpr execution.
+///
+/// Called from shim dispatch when `argv[0]` is `vpr`.
+pub async fn execute_vpr(args: &[String], cwd: &AbsolutePath) -> i32 {
+    if crate::help::maybe_print_unified_delegate_help("run", args, true) {
+        return 0;
+    }
+
+    let cwd_buf = cwd.to_absolute_path_buf();
+    match super::run_or_delegate::execute(cwd_buf, args).await {
+        Ok(status) => status.code().unwrap_or(1),
+        Err(e) => {
+            output::error(&e.to_string());
+            1
+        }
+    }
+}

crates/vite_global_cli/src/shim/dispatch.rs

@@ -673,6 +673,18 @@ pub async fn dispatch(tool: &str, args: &[String]) -> i32 {
         return crate::commands::vpx::execute_vpx(args, &cwd).await;
     }
 
+    // Handle vpr — standalone shorthand for `vp run`
+    if tool == "vpr" {
+        let cwd = match current_dir() {
+            Ok(path) => path,
+            Err(e) => {
+                eprintln!("vp: Failed to get current directory: {e}");
+                return 1;
+            }
+        };
+        return crate::commands::vpr::execute_vpr(args, &cwd).await;
+    }
+
     // Check recursion prevention - if already in a shim context, passthrough directly
     // Only applies to core tools (node/npm/npx) whose bin dir is prepended to PATH.
     // Package binaries are always resolved via metadata lookup, so they can't loop.

crates/vite_global_cli/src/shim/mod.rs

@@ -148,6 +148,9 @@ pub fn detect_shim_tool(argv0: &str) -> Option<String> {
     if argv0_tool == "vpx" {
         return Some("vpx".to_string());
     }
+    if argv0_tool == "vpr" {
+        return Some("vpr".to_string());
+    }
 
     // Fall back to argv[0] detection (Unix symlinks)
     if is_shim_tool(&argv0_tool) { Some(argv0_tool) } else { None }
@@ -264,4 +267,23 @@ mod tests {
         let result = detect_shim_tool("vpx.exe");
         assert_eq!(result, Some("vpx".to_string()));
     }
+
+    #[test]
+    fn test_detect_shim_tool_vpr() {
+        // vpr should be detected via the argv0 check, same pattern as vpx
+        // SAFETY: We're in a test
+        unsafe {
+            std::env::remove_var(SHIM_TOOL_ENV_VAR);
+        }
+        let result = detect_shim_tool("vpr");
+        assert_eq!(result, Some("vpr".to_string()));
+
+        // Also works with full path
+        let result = detect_shim_tool("/home/user/.vite-plus/bin/vpr");
+        assert_eq!(result, Some("vpr".to_string()));
+
+        // Also works with .exe extension (Windows)
+        let result = detect_shim_tool("vpr.exe");
+        assert_eq!(result, Some("vpr".to_string()));
+    }
 }

crates/vite_global_cli/src/tips/use_vpx_or_run.rs

@@ -11,7 +11,7 @@ impl Tip for UseVpxOrRun {
     }
 
     fn message(&self) -> &'static str {
-        "Execute a package binary with `vpx <pkg[@version]>`, or a script with `vp run <script>`"
+        "Execute a package binary with `vpx <pkg[@version]>`, or a script with `vpr <script>` (or `vp run <script>`)"
     }
 }
 

docs/guide/run.md

@@ -2,6 +2,10 @@
 
 `vp run` runs `package.json` scripts and tasks defined in `vite.config.ts`. It works like `pnpm run`, with caching, dependency ordering, and workspace-aware execution built in.
 
+::: tip
+`vpr` is available as a standalone shorthand for `vp run`. All examples below work with both `vp run` and `vpr`.
+:::
+
 ## Overview
 
 Use `vp run` with existing `package.json` scripts:

rfcs/run-without-vite-plus-dependency.md

@@ -427,6 +427,20 @@ fn test_yarn_run_script() {
 }
 ```
 
+## Standalone Shorthand: `vpr`
+
+`vpr` is available as a standalone binary shorthand for `vp run`, following the same pattern as `vpx` (shorthand for `vp exec`). It is implemented as a shim symlink to the `vp` binary, detected via `argv[0]`, and dispatches to the same `run_or_delegate` logic:
+
+```bash
+# These are equivalent:
+vpr dev
+vp run dev
+
+# Fallback behavior is identical:
+vpr build          # → <pm> run build (when no vite-plus dependency)
+vpr -r build       # → delegates to vite-plus task runner (when vite-plus is a dependency)
+```
+
 ## Backward Compatibility
 
 - **Projects with vite-plus**: No change in behavior. The `has_vite_plus_dependency` check passes, and delegation proceeds as before.

rfcs/trampoline-exe-for-shims.md

@@ -6,7 +6,7 @@ Implemented
 
 ## Summary
 
-Replace Windows `.cmd` wrapper scripts with lightweight trampoline `.exe` binaries for all shim tools (`vp`, `node`, `npm`, `npx`, `vpx`, and globally installed package binaries). This eliminates the `Terminate batch job (Y/N)?` prompt that appears when users press Ctrl+C, providing the same clean signal behavior as direct `.exe` invocation.
+Replace Windows `.cmd` wrapper scripts with lightweight trampoline `.exe` binaries for all shim tools (`vp`, `node`, `npm`, `npx`, `vpx`, `vpr`, and globally installed package binaries). This eliminates the `Terminate batch job (Y/N)?` prompt that appears when users press Ctrl+C, providing the same clean signal behavior as direct `.exe` invocation.
 
 ## Motivation
 
@@ -64,7 +64,9 @@ On Unix, shims are symlinks to the `vp` binary. The binary detects the tool name
 ├── vp   → ../current/bin/vp     (symlink)
 ├── node → ../current/bin/vp     (symlink)
 ├── npm  → ../current/bin/vp     (symlink)
-└── npx  → ../current/bin/vp     (symlink)
+├── npx  → ../current/bin/vp     (symlink)
+├── vpx  → ../current/bin/vp     (symlink)
+└── vpr  → ../current/bin/vp     (symlink)
 ```
 
 ### Windows (Trampoline `.exe` Files)
@@ -76,6 +78,7 @@ On Unix, shims are symlinks to the `vp` binary. The binary detects the tool name
 ├── npm.exe      # Trampoline → sets VITE_PLUS_SHIM_TOOL=npm, spawns vp.exe
 ├── npx.exe      # Trampoline → sets VITE_PLUS_SHIM_TOOL=npx, spawns vp.exe
 ├── vpx.exe      # Trampoline → sets VITE_PLUS_SHIM_TOOL=vpx, spawns vp.exe
+├── vpr.exe      # Trampoline → sets VITE_PLUS_SHIM_TOOL=vpr, spawns vp.exe
 └── tsc.exe      # Trampoline → sets VITE_PLUS_SHIM_TOOL=tsc, spawns vp.exe (package shim)
 ```