rush-ai

把本地 IDE 的上下文交给 Rush 的 AI 平台继续执行 —— 不是复述 prompt，是接力。

它解决什么

你在 Cursor / Claude Code 里和本地 agent 聊得正深入 —— 它知道代码库、约束、已经试过什么。当某一步要交给 Rush 平台的云端 agent（建个真实可访问的站、调一个专家 agent、让模型在干净环境里写一套代码），你不想把整个对话再重新组织一遍。

rush-ai 就是这个"接力"动作。本地 agent 调一条 rush-ai task create 把手里有的上下文直接递过去，Rush 接手执行，你切到浏览器看 preview，继续在那边迭代。

# 本地 agent（Cursor / Claude Code / ...）内部跑：
npx rush-ai task create -a web-builder -p "做一个公司官网，大气风格，深色强调色"
# → 拿到 task id，几十秒后 Rush 给回 preview URL

三条主路径

1. 从 prompt 直接建站（web-builder）

一句话生成一个完整可访问的站，自带 preview URL。继续迭代用 task send，满意了用 task deploy 上生产。

rush-ai task create -a web-builder -p "做个极简番茄钟 SPA，深色 + emerald 强调色"
# → Task xz5xgpn45fg1 running

rush-ai task status xz5xgpn45fg1
#   Preview:  https://xz5xgpn45fg1-preview.rush.zhenguanyu.com/

rush-ai task send xz5xgpn45fg1 -p "再加一个已完成次数的历史记录"

rush-ai task domain check my-pomodoro --task xz5xgpn45fg1
rush-ai task deploy xz5xgpn45fg1 --domain my-pomodoro --yes
# → https://my-pomodoro.rush.zhenguanyu.com

2. 调用 Rush 的专家 agent 做子任务

Rush 平台有一批领域专家 agent（人力分析、营销策划、数据分析…）。你的 workflow 里某一步需要它们时，不重新写 prompt，直接调。

rush-ai agent list                     # 看看都有谁
rush-ai agent info 人力资源分析专家      # 看这个 agent 的技能和能力
rush-ai task create -a 人力资源分析专家 -p "分析 Q1 部门人效趋势"
rush-ai task result <id> --json        # 拿结构化输出

3. 本地改完代码同步到 Rush

在本地 IDE 里改了几行代码（或本地 agent 改的），想让 Rush 的 preview 立刻反映出来 —— 一条命令：

# 前提：当前目录是 Rush 项目的 checkout
cd my-rush-project
# ... 本地改代码 + commit ...
rush-ai task push

task push 会自动把改动推到 Rush，preview URL 几秒后就会显示新版本。

Quick Start

要求：Node.js >= 18。如果不想全局装，任何 rush-ai 命令都可以用 npx rush-ai 替代。

# 1. 装 CLI
npm install -g rush-ai

# 2. 登录（浏览器完成）
rush-ai auth login

# 3. 看 agent 列表
rush-ai agent list

# 4. 开一个任务
rush-ai task create -a web-builder -p "做一个极简 todo list"
rush-ai task status <id> --json

rush 是默认的通用 agent，任何 agent list 里的 agent 名字都能作为 -a 的值。

主要能力

• 任务生命周期：task create / send / status / watch（实时流）/ result / files / cancel
• 本地同步：task push —— 改完本地代码，Rush preview 立刻更新
• 生产发布：task deploy <id> —— web-builder 产物发 prod，支持自定义域名
• agent shelf：agent list / agent info —— 浏览和使用 Rush 平台的专家 agent
• MCP 集成：作为 MCP stdio server 跑，或浏览平台上的 MCP server 和工具
• 多环境 profile：在不同 Rush 环境之间切换
• shell 补全：bash / zsh / fish
• CI 友好：--json 输出、--ci 模式、出错返回非 0 退出码
• 插件分发：marketplace + plugin install 一条命令把 Rush 生态的 skill / command / rule / MCP 装到 Claude Code、Codex、Cursor 三家 IDE

命令一览

任务流

| 命令 | 说明 | |------|------| | task create | 建一个任务给某个 agent 执行 | | task send <id> | 在已有任务上继续对话 / 发新消息（附件请用 --file） | | task status <id> | 查任务状态 | | task watch <id> | 实时跟一个任务的执行流 | | task result <id> | 拿任务结果 + 文件摘要 | | task files <id> | 列 / 下载任务产出文件 | | task messages <id> | 看任务的对话历史 | | task list / task ls | 列出我的任务 | | task cancel <id> | 取消运行中的任务 | | task push | 同步本地改动到 Rush（当前目录需要是 Rush 项目的 checkout） | | task deploy <id> | 发布 web-builder 产物到 prod（--domain / --version / --env） | | task versions <id> | 列出 web-builder 任务的可发布版本 | | task domain check <prefix> | 校验自定义域名前缀是否可用（需 --task <id>） |

💡 即将推出：task link —— 把本地已有项目接入 Rush 的托管环境，继续在云端迭代。敬请期待。

agent / MCP

| 命令 | 说明 | |------|------| | agent list / agent ls | 列出可用 agent | | agent info <name> | 查某个 agent 的描述、技能、MCP 配置 | | mcp list / mcp ls | 列出 MCP server | | mcp list-tools <id> | 列 MCP server 提供的工具 | | mcp serve | 把 rush-ai 当成 MCP stdio server 启动 |

插件分发

| 命令 | 说明 | |------|------| | marketplace add <source> | 注册 marketplace（github:owner/repo 或 directory:/abs/path） | | marketplace list / remove / update | 管理本地 marketplace 缓存 | | plugin install <ref> | 一条命令同步装到 Claude Code + Codex + Cursor；--target 单独装；--dry-run / --force | | plugin list / uninstall / update | 对称管理 |

<ref> 格式：<name> 或 <name>@<marketplace>（例 rush@rush-plugin）。

认证 / 配置 / 其他

| 命令 | 说明 | |------|------| | auth login / status / logout | 登录（浏览器或 API key） / 看状态 / 登出 | | config show / set / use / create / delete / list | profile 管理（多环境切换） | | completion install / bash\|zsh\|fish | shell 补全 | | doctor | 环境 / 认证 / 连通性诊断 | | check | 本地项目部署前预检 |

全局选项

| 选项 | 说明 | |------|------| | --json | 输出 JSON（机器可读） | | --ci | CI 模式：JSON 输出 + 不交互 + 严格退出码 | | --verbose / --debug | 详细 / 调试输出 | | --no-color | 禁用颜色 | | -f, --format <type> | 输出格式：table / json / csv |

常见用法

认证

# 浏览器登录
rush-ai auth login

# API key 登录（非交互，适合 CI）
rush-ai auth login --api-key <key>

# 看当前登录态
rush-ai auth status

多环境切换

rush-ai config create prod --api https://rush.example.com
rush-ai config create staging --api https://rush-staging.example.com
rush-ai config use prod
rush-ai config list

插件分发（可选）

如果你想把 Rush 生态的 skill / command / rule / MCP 同时装到本地的 Claude Code / Codex / Cursor：

rush-ai marketplace add github:kanyun-inc/rush-plugin
rush-ai plugin install rush
# ✓ Claude Code  (commands + skills + rules + MCP)
# ✓ Codex         (skills + MCP)
# ✓ Cursor        (skills + rules + MCP)

# 只装某一家
rush-ai plugin install rush --target claude-code

# 预览不落盘
rush-ai plugin install rush --dry-run

这条路径和每个 IDE 自己的 /plugin install 等价 —— 装完之后 IDE 的 /plugin list 能看到、/plugin uninstall 也能卸载。不用这条路径就忽略；日常的 task create / task push 和插件分发完全独立。

CI / 脚本

# 非交互认证
RUSH_API_KEY=$KEY rush-ai task create -a rush -p "Run tests" --ci

# 机器可读输出
rush-ai task status <id> --json | jq '.status'
rush-ai task result <id> --json | jq -r '.result'

环境变量

| 变量 | 说明 | 默认 | |------|------|------| | RUSH_API_KEY | API key，设了就跳过浏览器登录 | — | | RUSH_API_URL | API base URL 覆盖 | https://rush.zhenguanyu.com | | RUSH_PROFILE | 覆盖 active profile | — | | NO_COLOR | 禁用颜色输出 | — | | DEBUG | 启用调试日志 | — |

配置文件

rush-ai 的状态都在 ~/.rush/：

~/.rush/
├── auth.json           # 认证凭据
├── config.json         # profile / 全局配置
├── marketplaces/       # 已注册 marketplace 的本地缓存
└── plugins/
    └── registry.json   # 已装插件账本

License

MIT