rush-ai 0.4.0 → 0.6.0

package/README.md

@@ -2,9 +2,7 @@
 
 # rush-ai
 
-**Command-line interface for the Rush AI platform**
-
-*Create tasks, manage agents, stream results, and integrate IDE plugins — all from the terminal*
+**Call Rush agents from your terminal — relay the context, not the prompt.**
 
 [![npm version](https://img.shields.io/npm/v/rush-ai.svg)](https://www.npmjs.com/package/rush-ai)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
@@ -13,23 +11,60 @@
 
 ---
 
-## Quick Start
+## Why rush-ai
+
+### Hand off your context, not your prompt
+
+You're already deep in a conversation with your local agent — Cursor, Claude Code, or your own. It knows the codebase, the constraints, what you've already tried. When part of that work belongs on the Rush platform (building a site, asking a specialist agent), you don't want to summarize everything again.
+
+`rush-ai` is the hand-off. Your local agent calls `rush-ai task create` with the context it already has. Rush picks it up, you switch to the browser to watch the preview, and you keep iterating there.
 
 ```bash
-npm install -g rush-ai
+# From inside Cursor / Claude Code, the local agent runs:
+npx rush-ai task create -a web-builder -p "做一个公司官网，风格大气专业"
+```
 
-rush-ai auth login
-rush-ai agent list
-rush-ai task create -a <agent> -p "Build a landing page"
-rush-ai task watch <task-id>
+### Rush agents as your sub-agents
+
+Rush hosts a growing shelf of specialist agents. Any of them can become a sub-agent inside your own workflow — you don't rewrite the prompt, you call the agent.
+
+```bash
+# Browse the shelf
+npx rush-ai agent list
+
+# Pick one and put it to work — e.g. the HR analytics specialist
+npx rush-ai task create -a 人力资源分析专家 -p "分析 Q1 部门人效趋势"
 ```
 
+### Featured: `web-builder`
+
+`web-builder` is Rush's most intensive agent. One prompt gives you back a live preview URL and a git repository — share it, clone it, or keep iterating via `task send`.
+
+```bash
+npx rush-ai task create -a web-builder -p "Build a product landing page"
+# → Task lodig8oknq0r  running
+
+npx rush-ai task status lodig8oknq0r
+#   Preview:  https://lodig8oknq0r-preview.rush.zhenguanyu.com/
+#   Git:      https://gitlab-ee.zhenguanyu.com/rush/online/lodig8oknq0r
+```
+
+## Quick Start
+
+```bash
+npx rush-ai auth login
+npx rush-ai agent list
+npx rush-ai task create -a rush -p "Add a contact form to the homepage"
+npx rush-ai task watch <task-id>
+```
+
+`rush` is the default general-purpose agent. Swap `-a` for any agent from `agent list` to call a specialist instead.
+
 ## Features
 
-- **Task lifecycle** — Create, watch (SSE streaming), cancel, and download artifacts
-- **Agent management** — Browse agents, inspect skills and MCP servers
-- **MCP integration** — Discover MCP servers, list tools, run as MCP stdio server
-- **IDE plugins** — Install, update, diagnose plugins for Claude Code and Cursor
+- **Task lifecycle** — Create, watch (SSE streaming), send follow-ups, cancel, and download artifacts
+- **Agent shelf** — Browse agents, inspect skills and MCP servers, plug any agent into your own workflow as a sub-agent
+- **MCP integration** — Discover MCP servers, list tools, run as an MCP stdio server
 - **Multi-profile** — Switch between environments (test, production, custom)
 - **Shell completion** — Bash, Zsh, and Fish auto-completion
 - **CI-friendly** — `--json` output, `--ci` mode, non-zero exit codes on failure
@@ -39,8 +74,11 @@ rush-ai task watch <task-id>
 **Requirements:** Node.js >= 18.0.0
 
 ```bash
-npm install -g rush-ai       # Global install
-npx rush-ai <command>        # Or use npx directly
+# Recommended — always runs the latest version, zero setup
+npx rush-ai <command>
+
+# Optional — pin a global binary
+npm install -g rush-ai
 ```
 
 ## Commands
@@ -57,18 +95,13 @@ npx rush-ai <command>        # Or use npx directly
 | `task status <id>` | - | Check task status |
 | `task result <id>` | - | Get task result and file summary |
 | `task files <id>` | - | List and download task artifacts |
+| `task messages <id>` | - | View conversation messages for a task |
 | `task list` | `task ls` | List tasks |
 | `task watch <id>` | - | Stream task execution in real-time (SSE) |
 | `task cancel <id>` | - | Cancel a running task |
 | `mcp serve` | - | Start MCP stdio server |
 | `mcp list` | `mcp ls` | List available MCP servers |
 | `mcp list-tools <id>` | - | List tools provided by an MCP server |
-| `plugin install <name>` | - | Install an IDE plugin |
-| `plugin update <name>` | - | Update an installed plugin |
-| `plugin uninstall <name>` | - | Remove a plugin |
-| `plugin list` | `plugin ls` | List available and installed plugins |
-| `plugin status <name>` | - | Show plugin installation status |
-| `plugin doctor [name]` | - | Diagnose plugin issues |
 | `config show` | - | Show current configuration |
 | `config set <key> <value>` | - | Set a config value (`api`, `collectMetrics`, `currentTeam`) |
 | `config use <profile>` | - | Switch active profile |
@@ -124,6 +157,13 @@ rush-ai task send <task-id> -p "Change the button color to blue"
 # Pipe prompt from stdin
 echo "Refactor the auth module" | rush-ai task create -a rush
 
+# View conversation messages
+rush-ai task messages <task-id>
+rush-ai task messages <task-id> -c <conversation-id>
+rush-ai task messages <task-id> --last 5 --role user
+rush-ai task messages <task-id> --compact
+rush-ai task messages <task-id> --json
+
 # List recent tasks
 rush-ai task list -l 10 -s completed
 ```
@@ -140,19 +180,6 @@ rush-ai mcp list --search "database"
 rush-ai mcp list-tools <server-id>
 ```
 
-### IDE Plugin Management
-
-```bash
-# Install plugin for Claude Code
-rush-ai plugin install claude-code
-
-# Check plugin health
-rush-ai plugin doctor claude-code
-
-# Update plugin
-rush-ai plugin update claude-code --force
-```
-
 ### Multi-Profile Configuration
 
 ```bash
@@ -195,9 +222,7 @@ Config files are stored in `~/.rush/`:
 ```
 ~/.rush/
 ├── auth.json             # Credentials (token, refresh token, expiry)
-├── config.json           # Global settings (profiles, metrics, team)
-└── plugins/
-    └── installed.json    # Plugin manifest
+└── config.json           # Global settings (profiles, metrics, team)
 ```
 
 ## Development

package/dist/index.js

@@ -3342,7 +3342,15 @@ function gitPushUrl(projectPath, url) {
       cwd: projectPath,
       stdio: "pipe",
       timeout: 3e5,
-      maxBuffer: 10 * 1024 * 1024
+      maxBuffer: 10 * 1024 * 1024,
+      env: {
+        ...process.env,
+        // 失败时不要弹密码 / SSH key 提示，否则在非交互环境（CI / 测试）
+        // 会一直 hang 到外层 timeout（300s）才返回。
+        GIT_TERMINAL_PROMPT: "0",
+        GIT_ASKPASS: "true",
+        SSH_ASKPASS: "true"
+      }
     });
     return { success: true, stderr: "" };
   } catch (err) {
@@ -3508,6 +3516,54 @@ function registerDeploySubcommand(task, program) {
 }
 
 // src/commands/task/index.ts
+var MAX_TEXT_LENGTH = 500;
+function truncateText(text) {
+  if (text.length <= MAX_TEXT_LENGTH) return text;
+  return text.slice(0, MAX_TEXT_LENGTH) + "...";
+}
+function summarizeTools(parts) {
+  const toolParts = parts.filter(
+    (p) => p.type === "tool-invocation" || p.type.startsWith("tool-")
+  );
+  if (toolParts.length === 0) return "";
+  return toolParts.map((p) => {
+    if (p.toolName) return p.toolName;
+    if (p.type.startsWith("tool-")) return p.type.slice(5);
+    return "unknown";
+  }).join(", ");
+}
+function formatTimestamp(ts) {
+  if (!ts) return "";
+  const d = new Date(ts);
+  return d.toLocaleString();
+}
+function renderMessages(messages, conversationId, compact) {
+  output.log(
+    output.bold(`Conversation ${conversationId} \u2014 ${messages.length} messages`)
+  );
+  output.newline();
+  for (const msg of messages) {
+    const ts = formatTimestamp(msg.createdAt);
+    output.log(`[${msg.role}] ${ts}`);
+    const textParts = (msg.parts ?? []).filter(
+      (p) => p.type === "text" && p.text
+    );
+    if (textParts.length > 0) {
+      for (const tp of textParts) {
+        output.log(`  ${truncateText(tp.text)}`);
+      }
+    } else if (msg.content) {
+      output.log(`  ${truncateText(msg.content)}`);
+    }
+    if (!compact && msg.role === "assistant" && msg.parts) {
+      const toolSummary = summarizeTools(msg.parts);
+      if (toolSummary) {
+        output.dim(`  Tools: ${toolSummary}`);
+      }
+    }
+    output.newline();
+  }
+}
 var VALID_CATEGORIES = ["code", "image", "document", "other"];
 function sanitizeFilePath(filePath, outputDir) {
   let stripped = filePath.replace(/^[/\\]+/, "").replace(/^[a-zA-Z]:/, "");
@@ -3521,8 +3577,25 @@ function sanitizeFilePath(filePath, outputDir) {
   }
   return target;
 }
-async function downloadFile(url, destPath) {
-  const response = await fetch(url);
+async function downloadFile(file, destPath, client) {
+  let response = null;
+  if (file.ossPath) {
+    try {
+      const proxyResponse = await client.fetchRaw(
+        `/api/files/oss-preview?action=file&path=${encodeURIComponent(file.ossPath)}`
+      );
+      if (proxyResponse.ok) {
+        response = proxyResponse;
+      }
+    } catch {
+    }
+  }
+  if (!response && file.ossUrl) {
+    response = await fetch(file.ossUrl);
+  }
+  if (!response) {
+    throw new Error("No download path available");
+  }
   if (!response.ok) {
     throw new Error(
       `Download failed: ${response.status} ${response.statusText}`
@@ -3619,8 +3692,23 @@ function registerTaskCommand(program) {
       output.log(output.bold(`Task ${data.id}`));
       output.log(`  Agent: ${data.agent}`);
       output.log(`  Status: ${data.status}`);
+      if (data.template) {
+        output.log(`  Template: ${data.template}`);
+      }
+      if (data.podImageName) {
+        output.log(`  Image: ${data.podImageName}`);
+      }
       output.log(`  Created: ${new Date(data.createdAt).toLocaleString()}`);
       output.log(`  Updated: ${new Date(data.updatedAt).toLocaleString()}`);
+      if (data.previewUrl) {
+        output.log(`  Preview: ${data.previewUrl}`);
+      }
+      if (data.gitRepoUrl) {
+        output.log(`  Git: ${data.gitRepoUrl}`);
+      }
+      if (data.deployedProductionUrl) {
+        output.log(`  Production: ${data.deployedProductionUrl}`);
+      }
       if (data.error) {
         output.error(`  Error: ${data.error}`);
       }
@@ -3704,8 +3792,8 @@ function registerTaskCommand(program) {
           output.error(`File not found: ${options.download}`);
           process.exit(1);
         }
-        if (!file.ossUrl) {
-          output.error(`File "${file.fileName}" has no download URL.`);
+        if (!file.ossPath && !file.ossUrl) {
+          output.error(`File "${file.fileName}" has no download path.`);
           process.exit(1);
         }
         const outputDir = options.output || ".";
@@ -3714,7 +3802,7 @@ function registerTaskCommand(program) {
           output.error(`Unsafe file path: ${file.filePath}`);
           process.exit(1);
         }
-        await downloadFile(file.ossUrl, destPath);
+        await downloadFile(file, destPath, client);
         if (format === "json") {
           output.log(
             JSON.stringify(
@@ -3734,10 +3822,10 @@ function registerTaskCommand(program) {
         let skipped = 0;
         let failed = 0;
         for (const file of files) {
-          if (!file.ossUrl) {
+          if (!file.ossPath && !file.ossUrl) {
             skipped++;
             if (format !== "json") {
-              output.dim(`  Skipped (no URL): ${file.filePath}`);
+              output.dim(`  Skipped (no download path): ${file.filePath}`);
             }
             continue;
           }
@@ -3750,7 +3838,7 @@ function registerTaskCommand(program) {
             continue;
           }
           try {
-            await downloadFile(file.ossUrl, destPath);
+            await downloadFile(file, destPath, client);
             downloaded++;
             if (format !== "json") {
               output.dim(`  Downloaded: ${file.filePath}`);
@@ -3807,7 +3895,65 @@ function registerTaskCommand(program) {
       output.log(formatOutput(rows, format));
     }
   );
-  task.command("list").alias("ls").description("List tasks").option("-l, --limit <limit>", "Maximum number of tasks", "20").option("-s, --status <status>", "Filter by status").action(async (options) => {
+  task.command("messages").description("View conversation messages for a task").argument("<id>", "Task ID (project ID)").option("-c, --conversation <id>", "Specific conversation ID").option("--last <n>", "Show only last N messages").option("--role <role>", "Filter by role (user, assistant, system)").option("--compact", "Text-only output, no tool details or reasoning").action(
+    async (id, options) => {
+      requireAuth();
+      const format = resolveFormat(program.opts());
+      const client = createClient();
+      let conversationId = options.conversation;
+      if (!conversationId) {
+        const { data: convData } = await client.get(
+          `/api/chat/${encodeURIComponent(id)}/conversations`
+        );
+        if (!convData.conversations || convData.conversations.length === 0) {
+          if (format === "json") {
+            output.log(
+              JSON.stringify({ messages: [], conversationId: null }, null, 2)
+            );
+          } else {
+            output.info("No conversations found for this task.");
+          }
+          return;
+        }
+        conversationId = convData.conversations[0].id;
+      }
+      const { data } = await client.get(
+        `/api/chat/${encodeURIComponent(id)}/conversations/${encodeURIComponent(conversationId)}`
+      );
+      let messages = data.messages ?? [];
+      if (messages.length === 0) {
+        if (format === "json") {
+          output.log(
+            JSON.stringify({ messages: [], conversationId }, null, 2)
+          );
+        } else {
+          output.info("No messages in this conversation.");
+        }
+        return;
+      }
+      if (options.role) {
+        messages = messages.filter((m) => m.role === options.role);
+      }
+      if (options.last) {
+        const n = parseInt(options.last, 10);
+        if (!isNaN(n) && n > 0) {
+          messages = messages.slice(-n);
+        }
+      }
+      if (format === "json") {
+        output.log(
+          JSON.stringify(
+            { messages, conversationId, metadata: data.metadata },
+            null,
+            2
+          )
+        );
+      } else {
+        renderMessages(messages, conversationId, !!options.compact);
+      }
+    }
+  );
+  task.command("list").alias("ls").description("List tasks").option("-l, --limit <limit>", "Maximum number of tasks", "50").option("-s, --status <status>", "Filter by status").action(async (options) => {
     requireAuth();
     const format = resolveFormat(program.opts());
     const client = createClient();