@wavespeed/cli 0.4.6 → 0.4.8

package/README.md

@@ -84,8 +84,8 @@ wavespeed run ... -p "..." --json | jq '.outputs[0]'
                 "input": { "aspect_ratio": "16:9", "resolution": "2k" } },
     "social": { "model": "bytedance/seedream-v5.0-pro",
                 "input": { "aspect_ratio": "1:1",  "resolution": "1k" } },
-    "vid":    { "model": "bytedance/seedance-2.5/text-to-video",
-                "input": { "resolution": "720p", "duration": 5 } }
+    "vid":    { "model": "wavespeed-ai/minimax-h3/text-to-video",
+                "input": { "resolution": "768p", "duration": 5 } }
   }
 }
 ```
@@ -103,27 +103,31 @@ Resolution: positional with `/` is a model ID; otherwise looked up as an alias.
 |---|---|
 | Text → image | `bytedance/seedream-v5.0-pro` |
 | Image edit | `bytedance/seedream-v5.0-pro/edit` |
-| Text → video | `bytedance/seedance-2.5/text-to-video` |
-| Image → video | `bytedance/seedance-2.5/image-to-video` |
-| Video edit | `bytedance/seedance-2.5/video-edit` |
-| Video extend | `bytedance/seedance-2.5/video-extend` |
+| Text → video | `wavespeed-ai/minimax-h3/text-to-video` |
+| Image → video | `wavespeed-ai/minimax-h3/image-to-video` |
+| Video edit | `wavespeed-ai/minimax-h3/video-edit` |
+| Video extend | `wavespeed-ai/minimax-h3/video-extend` |
 
-Browse alternatives with `wavespeed models <query>`.
+MiniMax H3 is the open-weights default: cheap, fast, and native stereo audio — the best place to start. When you need the highest quality, switch to `bytedance/seedance-2.5/*` (text-to-video, image-to-video, video-edit, video-extend). Browse alternatives with `wavespeed models <query>`.
 
 ## Use from coding agents
 
 No MCP server, no daemon. The CLI **is** the interface — agents already know how to run shell commands.
 
 ```bash
-wavespeed skill install        # writes .claude/skills/wavespeed/SKILL.md
+wavespeed skill install        # writes .claude/skills/wavespeed/SKILL.md and .agents/skills/wavespeed/SKILL.md
 ```
 
 The skill teaches the agent the three-step pattern: `models` to find, `run <id> -h` to discover params, `run <id> -p "…" --json` to execute. Every command supports `--json` for clean piping.
 
 **OpenCode** loads the same file with no extra steps — `.claude/skills/` is on its skill search path.
 
+**Codex** reads `.agents/skills/`, which the same command writes. For a one-line install that also wires up the MCP server: `codex plugin marketplace add WaveSpeedAI/codex-plugin-wavespeed-cli` ([WaveSpeedAI/codex-plugin-wavespeed-cli](https://github.com/WaveSpeedAI/codex-plugin-wavespeed-cli)).
+
 **DeepSeek Harness (dsh)**: the same skill is packaged for dsh's `.dsh/skills` layout at [WaveSpeedAI/wavespeed-dsh-skill](https://github.com/WaveSpeedAI/wavespeed-dsh-skill).
 
+**Kimi Code CLI** reads `.claude/skills/` too, so `wavespeed skill install` is enough. For a one-line install that also wires up the MCP server, use the plugin: `/plugins install https://github.com/WaveSpeedAI/wavespeed-kimi-plugin` ([WaveSpeedAI/wavespeed-kimi-plugin](https://github.com/WaveSpeedAI/wavespeed-kimi-plugin)).
+
 ## Commands
 
 ```

package/dist/cli.js

@@ -44,7 +44,7 @@ ${chalk.bold('Quick start:')}
   ${chalk.cyan('$ wavespeed models                                                # browse the catalog')}
   ${chalk.cyan('$ wavespeed run wavespeed-ai/z-image/turbo -h                    # see the model\'s flags')}
   ${chalk.cyan('$ wavespeed run wavespeed-ai/z-image/turbo -p "a cyberpunk skyline"   # ~5s')}
-  ${chalk.cyan('$ wavespeed run bytedance/seedance-2.5/text-to-video -p "drone shot over snowy peaks"')}
+  ${chalk.cyan('$ wavespeed run wavespeed-ai/minimax-h3/text-to-video -p "drone shot over snowy peaks"')}
 
 ${chalk.bold('Use from any coding agent (Claude Code, Cursor, Codex):')}
   ${chalk.cyan('$ wavespeed skill install')}   ${chalk.gray('# drops a SKILL.md so the agent knows how to call wavespeed')}

package/dist/commands/auth.js

@@ -109,7 +109,7 @@ async function loginFlow(opts) {
     console.log(chalk.bold('Try it:'));
     console.log('  ' + chalk.cyan('wavespeed models                       # browse the catalog'));
     console.log('  ' + chalk.cyan('wavespeed run wavespeed-ai/z-image/turbo -p "a cyberpunk skyline at golden hour"'));
-    console.log('  ' + chalk.cyan('wavespeed run bytedance/seedance-2.5/text-to-video -p "drone shot over snowy peaks"'));
+    console.log('  ' + chalk.cyan('wavespeed run wavespeed-ai/minimax-h3/text-to-video -p "drone shot over snowy peaks"'));
     console.log();
 }
 export function registerAuth(program) {

package/dist/commands/skill.js

@@ -7,11 +7,22 @@ function skillSourcePath() {
     // dist/commands/skill.js -> ../../skills/SKILL.md
     return path.resolve(here, '..', '..', 'skills', 'SKILL.md');
 }
+// Two discovery roots cover every agent we target: Claude Code, Cursor and
+// OpenCode read `.claude/skills/`; Codex, Kimi Code and the wider agents.md
+// ecosystem read `.agents/skills/`. Writing both keeps a single install
+// command working everywhere.
+export const SKILL_ROOTS = ['.claude', '.agents'];
+export function writeSkills(cwd = process.cwd()) {
+    return SKILL_ROOTS.map((root) => {
+        const dest = path.join(cwd, root, 'skills', 'wavespeed', 'SKILL.md');
+        fs.mkdirSync(path.dirname(dest), { recursive: true });
+        fs.copyFileSync(skillSourcePath(), dest);
+        return dest;
+    });
+}
+/** @deprecated use writeSkills — kept for callers that expect the Claude path. */
 export function writeSkill(cwd = process.cwd()) {
-    const dest = path.join(cwd, '.claude', 'skills', 'wavespeed', 'SKILL.md');
-    fs.mkdirSync(path.dirname(dest), { recursive: true });
-    fs.copyFileSync(skillSourcePath(), dest);
-    return dest;
+    return writeSkills(cwd)[0];
 }
 export function registerSkill(program) {
     const skill = program
@@ -19,19 +30,21 @@ export function registerSkill(program) {
         .description('Install a Wavespeed skill for Claude Code, Cursor, Codex, and other coding agents');
     skill
         .command('install', { isDefault: true })
-        .description('Drop a SKILL.md into .claude/skills/wavespeed/ so Claude Code, Cursor, and Codex know how to call the CLI')
+        .description('Drop a SKILL.md into .claude/skills/ and .agents/skills/ so Claude Code, Cursor, Codex, Kimi Code and other agents know how to call the CLI')
         .option('--print', 'Print the skill body to stdout instead of writing a file')
         .action((opts) => {
         if (opts.print) {
             process.stdout.write(fs.readFileSync(skillSourcePath(), 'utf8'));
             return;
         }
-        const dest = writeSkill();
+        const dests = writeSkills();
         console.log();
-        console.log(chalk.green('Installed skill: ') + chalk.cyan(path.relative(process.cwd(), dest)));
+        for (const dest of dests) {
+            console.log(chalk.green('Installed skill: ') + chalk.cyan(path.relative(process.cwd(), dest)));
+        }
         console.log();
         console.log(chalk.bold('You\'re set.'));
-        console.log(chalk.gray('  Claude Code, Cursor, and other agents auto-discover .claude/skills/*.'));
+        console.log(chalk.gray('  Claude Code, Cursor and OpenCode read .claude/skills/*; Codex, Kimi Code and other agents read .agents/skills/*.'));
         console.log(chalk.gray('  Agents will call the CLI directly — no MCP server, no extra config.'));
         console.log();
         console.log(chalk.gray('  Quick check: ask the agent to run ') + chalk.cyan('wavespeed models') + chalk.gray('.'));

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@wavespeed/cli",
-  "version": "0.4.6",
-  "description": "WaveSpeed CLI \u2014 one command to run any WaveSpeed AI model from your terminal.",
+  "version": "0.4.8",
+  "description": "WaveSpeed CLI — one command to run any WaveSpeed AI model from your terminal.",
   "publishConfig": {
     "access": "public"
   },

package/skills/SKILL.md

@@ -31,12 +31,12 @@ wavespeed run bytedance/seedream-v5.0-pro \
 |---|---|
 | Text → image | `bytedance/seedream-v5.0-pro` |
 | Image edit (instruction-driven) | `bytedance/seedream-v5.0-pro/edit` — requires `images: [url, ...]` |
-| Text → video | `bytedance/seedance-2.5/text-to-video` |
-| Image → video | `bytedance/seedance-2.5/image-to-video` — requires `image: url` |
-| Video edit (instruction-driven) | `bytedance/seedance-2.5/video-edit` — requires `video: url` |
-| Video extend | `bytedance/seedance-2.5/video-extend` — requires `video: url` |
+| Text → video | `wavespeed-ai/minimax-h3/text-to-video` |
+| Image → video | `wavespeed-ai/minimax-h3/image-to-video` — requires `image: url` |
+| Video edit (instruction-driven) | `wavespeed-ai/minimax-h3/video-edit` — requires `video: url` |
+| Video extend | `wavespeed-ai/minimax-h3/video-extend` — requires `video: url` |
 
-These are good starting points. Browse alternatives with `wavespeed models <query>`.
+These are good starting points. MiniMax H3 is the open-weights default: cheap, fast, and native stereo audio — the best place to start. When you need the highest quality, switch to `bytedance/seedance-2.5/*` (text-to-video, image-to-video, video-edit, video-extend). Browse alternatives with `wavespeed models <query>`.
 
 ## Common recipes
 
@@ -47,7 +47,7 @@ wavespeed run bytedance/seedream-v5.0-pro/edit \
   -i images='["@./input.jpg"]' --json
 
 # Image-to-video — same @ marker for single-URL fields
-wavespeed run bytedance/seedance-2.5/image-to-video \
+wavespeed run wavespeed-ai/minimax-h3/image-to-video \
   -p "subtle parallax, gentle wind" \
   -i image=@./hero.jpg -i duration=5 --json