spaceflow/docs/guide/commands/runx.md

runx — 运行命令

全局安装并运行 Extension 命令，类似于 npx。别名为 x。

基本用法

# 运行指定 Extension 的命令
spaceflow x @spaceflow/review --help

# 运行本地路径的 Extension
spaceflow x ./commands/ci-scripts -- --script ./deploy.sh

# 使用完整命令名
spaceflow runx @spaceflow/review -- -p 123

工作流程

1. 全局安装 — 如果 Extension 未全局安装，先执行全局安装
2. 运行命令 — 执行该 Extension 提供的命令，透传所有参数

参数传递

使用 -- 分隔 runx 自身的选项和传递给 Extension 的参数：

spaceflow x <source> [runx选项] -- [Extension参数]

示例：

# 传递 --help 给 review 命令
spaceflow x @spaceflow/review -- --help

# 传递 -p 123 给 review 命令
spaceflow x @spaceflow/review -- -p 123

# 指定名称并传递参数
spaceflow x ./commands/ci-scripts -n ci-scripts -- --script ./test.sh

与 install 的区别

特性	install	runx
安装位置	本地项目（默认）	全局
持久化	写入 spaceflow.json	不修改配置
用途	长期使用的 Extension	临时运行

命令行选项

选项	简写	说明
--name <name>	-n	自定义 Extension 名称
--verbose	-v	详细日志

示例

# 临时运行 review
spaceflow x @spaceflow/review -- -p 42

# 临时运行本地 Extension
spaceflow x ./commands/my-tool -- --config custom.json