Generate, edit, animate, upscale, or transform AI media using the WaveSpeed CLI from Codex.

Apache-2.0Auto-check passedMedia & Creative

Install Wavespeed CLI

skills CLI
$ npx skills add hashgraph-online/awesome-codex-plugins --skill wavespeed-cli -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install hashgraph-online/awesome-codex-plugins wavespeed-cli --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/hashgraph-online/awesome-codex-plugins.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/WaveSpeedAI/codex-plugin-wavespeed-cli/skills/wavespeed-cli .claude/skills/wavespeed-cli && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
wavespeed-cli
GitHub stars
1.2k
Token cost
~1k tokens
SKILL.md length
365 words
Files
1
Skills in repo
736
Repo updated
First seen
Licence
Apache-2.0

At a glance

Generate, edit, animate, upscale, or transform AI media using the WaveSpeed CLI from Codex.

  • The user asks to create image
  • SKILL.md covers Before Running, Standard Flow, Recommended Starting Models and Files, plus 2 more sections
  • Needs WAVESPEED_API_KEY
  • Marketing creatives

What it does

Wavespeed CLI is an agent skill from hashgraph-online/awesome-codex-plugins. Generate, edit, animate, upscale, or transform AI media using the WaveSpeed CLI from Codex. Use when the user asks to create image, video, audio, 3D, TTS, marketing creatives, or to inspect/run WaveSpeed models.

Its SKILL.md is about 1k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Media & Creative, covering Image editing, Text to speech and voice and AI video generation. The repository describes itself as: A curated list of awesome OpenAI Codex / ChatGPT plugins, skills, and resources. The 1 Codex Marketplace. See live plugins at: https://hol.org/plugins/best-codex-plugins. The licence is Apache-2.0.

When your agent uses it

  • The user asks to create image
  • Marketing creatives
  • Inspect/run WaveSpeed models

Example prompts

  • “/wavespeed-cli”

Requirements

  • A credential in WAVESPEED_API_KEY

What it can do on your machine

Read from SKILL.md and the folder at commit 16b4156. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are bash).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • WAVESPEED_API_KEY

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Wavespeed CLI loads about 1k tokens when it runs. Until then it costs about 56 tokens; SKILL.md has 365 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~56
When it runs · the whole SKILL.md, loaded when a task matches
~1k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from hashgraph-online/awesome-codex-plugins at commit 16b4156, republished under its Apache-2.0 licence (© hashgraph-online). 365 words, ~1,007 tokens.

Download SKILL.mdSave it as .claude/skills/wavespeed-cli/SKILL.md (or your agent's skills folder).
name
wavespeed-cli
description
Generate, edit, animate, upscale, or transform AI media using the WaveSpeed CLI from Codex. Use when the user asks to create image, video, audio, 3D, TTS, marketing creatives, or to inspect/run WaveSpeed models.

WaveSpeed CLI

Use the wavespeed CLI to run WaveSpeed image, video, audio, and 3D models. Every generation uses the same flow: search the live catalog, inspect the model schema, then run the model with explicit inputs.

This plugin also starts the WaveSpeed MCP server. Its tools map one-to-one onto the CLI commands below: search_models = wavespeed models, get_model_schema = wavespeed schema, get_price = wavespeed price, upload_file = wavespeed upload, run_model = wavespeed run, get_prediction = wavespeed show, get_balance = wavespeed balance. Prefer the MCP tools for single generations; use the CLI when it is installed and the user wants batch or scripted runs. Both share the same login.

Before Running

Check whether the CLI is available:

bash
wavespeed --version

If it is missing, run this plugin helper:

bash
./plugins/wavespeed-cli/scripts/install-wavespeed-cli.sh

Check auth before generation:

bash
wavespeed status

If the user is not signed in, ask them to run wavespeed login. Do not ask the user to paste an API key into chat. For CI or one-off shells, WAVESPEED_API_KEY may be set in the environment.

Standard Flow

bash
# 1. Search the live catalog.
wavespeed models "nano banana"
wavespeed models --type image-to-video
wavespeed models --type text-to-video
wavespeed models --type text-to-audio
wavespeed models --type text-to-3d

# 2. Inspect dynamic inputs for the selected model.
wavespeed run google/nano-banana-2/text-to-image -h

# 3. Run with --json so Codex can parse outputs.
wavespeed run google/nano-banana-2/text-to-image \
  -p "a cyberpunk skyline at golden hour" \
  -i aspect_ratio="16:9" \
  -i resolution="2k" \
  --json

wavespeed run --json returns machine-readable fields such as model, prompt, outputs, saved, elapsed_ms, and raw. Use output URLs directly when the user wants links. Add --download when the user wants local files.

Show full SKILL.md (173 more words)Show less
Use caseModel
Text to imagegoogle/nano-banana-2/text-to-image
Image editgoogle/nano-banana-2/edit
Text to videowavespeed-ai/minimax-h3/text-to-video (cheap open-weights default; bytedance/seedance-2.5/text-to-video for the highest quality)
Image to videowavespeed-ai/minimax-h3/image-to-video (bytedance/seedance-2.5/image-to-video for the highest quality)

These are defaults, not a fixed list. Browse alternatives with wavespeed models <query> and inspect each selected model before running it.

Files

Local file paths are not automatically uploaded. Upload files first, then pass returned URLs into generation commands.

bash
wavespeed upload ./input.jpg --json
wavespeed run google/nano-banana-2/edit \
  -p "replace the background with a sunlit kitchen" \
  -i images='["https://..."]' \
  --json

Save generated outputs locally:

bash
wavespeed run google/nano-banana-2/text-to-image \
  -p "minimal product photo on a glass table" \
  --download "./wavespeed-output/{index}.{ext}" \
  --json

Project Config

wavespeed init creates wavespeed.json with shared defaults and aliases.

  • defaultModel lets wavespeed run -p "..." omit the model argument.
  • aliases bundle a model with default inputs.
  • wavespeed aliases lists configured aliases.
  • CLI flags override alias defaults.

The CLI never rewrites the user's prompt or inputs.

Pitfalls

  • Do not invent model IDs. Confirm with wavespeed models or wavespeed schema <model>.
  • Prefer --json for runs, uploads, and any command that will be parsed.
  • Use structured inputs via -i key=value; inspect model help for exact names and accepted values.
  • Some models require uploaded asset URLs, not local paths.

© hashgraph-online, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in plugins/WaveSpeedAI/codex-plugin-wavespeed-cli/skills/wavespeed-cli of hashgraph-online/awesome-codex-plugins.

Open the folder on GitHubat commit 16b4156

Compare with similar skills

Wavespeed CLI next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Wavespeed CLI compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Wavespeed CLI this skillhashgraph-online/awesome-codex-plugins1.2k—~1kAutomated safety check: PassApache-2.0
Media Genclacky-ai/openclacky1.2k—~7.3kAutomated safety check: PassMIT
Clean Audiohassancs91/claude-youtube-editor3221 repos~1.8kAutomated safety check: PassMIT
Scenario Videoscenario-labs/skills898—~4.3kAutomated safety check: PassMIT
HyperFrames Media Useheygen-com/hyperframes58k2 repos~2.1kAutomated safety check: PassApache-2.0
Narrator AI CLINarratorAI-Studio/narrator-ai-cli-skill3k—~4.5kAutomated safety check: PassMIT

Similar skills

  • Media Gen

    clacky-ai/openclacky

    Generate or edit images, videos, or audio in the current task.

    1.2k GitHub stars~7.3k tokensUpdated today
    Media & CreativeAuto-check passed
  • Clean Audio

    hassancs91/claude-youtube-editor

    Voice/audio cleanup step of the AI Video Editor pipeline — diagnose a video's background noise, pick the right denoise method, and produce a cleaned master (voice isolated, levels preserved, video…

    322 GitHub starsUsed in 1 repo~1.8k tokens
    Media & CreativeAuto-check passed
  • Scenario Video

    scenario-labs/skills

    A skill your agent uses when generating or editing video on Scenario via MCP: text-to-video, a music video from a song, image-to-video (still animation, frame anchors), motion prompting, lipsync and…

    898 GitHub stars~4.3k tokensUpdated yesterday
    Media & CreativeAuto-check passed
  • HyperFrames Media Use

    heygen-com/hyperframes

    Finds, generates and edits media for HyperFrames video projects: music, sound effects, images, icons, logos, voiceovers, captions and color grades.

    58k GitHub starsUsed in 2 repos~2.1k tokens
    Media & CreativeAuto-check passed
  • Narrator AI CLI

    NarratorAI-Studio/narrator-ai-cli-skill

    AI 电影/短剧解说视频自动生成(AI 解说大师 CLI Skill)。当用户需要创建电影解说视频、短剧解说、影视二创、AI 配音旁白视频、film commentary、video narration、drama dubbing、movie narration 时触发。内置电影素材库、BGM、多语种配音、解说模板。通过 narrator-ai-cli 命令行实现:搜片→选模板→选…

    3k GitHub stars~4.5k tokensUpdated 3 mo ago
    Media & CreativeAuto-check passed
  • Agnes AI Generation

    Yacey/agnes-ai-generation-skill

    Call Agnes AI / Sapiens AI generation APIs for text, image, and video.

    419 GitHub stars~1.7k tokensUpdated 3 mo ago
    Media & CreativeAuto-check passed

More from hashgraph-online/awesome-codex-plugins

All 736 skills in this repo
  • Anime Reaction Gif

    hashgraph-online/awesome-codex-plugins

    Create original anime-style reaction stickers as looping GIFs and MP4 previews, using generated character pose sheets and timed key poses.

    1.2k GitHub stars~922 tokensUpdated yesterday
    Auto-check passed
  • Calibredb

    hashgraph-online/awesome-codex-plugins

    Manage and query Calibre libraries with the calibredb CLI (local paths or Calibre Content server URLs).

    1.2k GitHub stars~1k tokensUpdated yesterday
    Auto-check passed
  • Rust API Test Harness

    hashgraph-online/awesome-codex-plugins

    A skill your agent uses when adding, changing, testing, or debugging Rust HTTP APIs and services, especially when Codex needs black-box integration tests, random-port app startup, real database test…

    1.2k GitHub stars~1.7k tokensUpdated yesterday
    Auto-check passed
  • Art

    hashgraph-online/awesome-codex-plugins

    Make a studio's game look like something at build time — a cover from a real frame of the game (free), painted covers, backdrops, textures and character plates from image models through the…

    1.2k GitHub stars~2.4k tokensUpdated yesterday
    Auto-check passed
  • Calle

    hashgraph-online/awesome-codex-plugins

    Use CALL-E from Codex through the calle CLI. An agent skill from hashgraph-online/awesome-codex-plugins.

    1.2k GitHub stars~2.9k tokensUpdated yesterday
    Auto-check passed
  • Game Balance Economy

    hashgraph-online/awesome-codex-plugins

    Balance game difficulty, resources, rewards, probability, progression, economies, and dominant strategies.

    1.2k GitHub stars~618 tokensUpdated yesterday
    Auto-check passed

Questions about Wavespeed CLI

What does Wavespeed CLI do?

Generate, edit, animate, upscale, or transform AI media using the WaveSpeed CLI from Codex. Wavespeed CLI is an agent skill from hashgraph-online/awesome-codex-plugins. Generate, edit, animate, upscale, or transform AI media using the WaveSpeed CLI from Codex.

When should I use Wavespeed CLI?

Wavespeed CLI fits situations like: the user asks to create image; marketing creatives; inspect/run WaveSpeed models.

How do I install Wavespeed CLI in Claude Code?

Run `npx skills add hashgraph-online/awesome-codex-plugins --skill wavespeed-cli -a claude-code`. Or copy the skill folder (plugins/WaveSpeedAI/codex-plugin-wavespeed-cli/skills/wavespeed-cli in hashgraph-online/awesome-codex-plugins) into .claude/skills/wavespeed-cli in your project. Claude Code loads it when a task matches its description.

How do I install Wavespeed CLI in Codex?

Run `npx skills add hashgraph-online/awesome-codex-plugins --skill wavespeed-cli -a codex`. Or copy the skill folder (plugins/WaveSpeedAI/codex-plugin-wavespeed-cli/skills/wavespeed-cli in hashgraph-online/awesome-codex-plugins) into .agents/skills/wavespeed-cli in your project. Codex loads it when a task matches its description.

Can I use Wavespeed CLI in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add hashgraph-online/awesome-codex-plugins --skill wavespeed-cli -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/wavespeed-cli, .gemini/skills/wavespeed-cli, .github/skills/wavespeed-cli and .opencode/skills/wavespeed-cli in your project.

What does Wavespeed CLI need to run?

Going by SKILL.md and its folder, Wavespeed CLI needs credentials named WAVESPEED_API_KEY. Our summary lists: A credential in WAVESPEED_API_KEY.

Does Wavespeed CLI access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Wavespeed CLI safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Wavespeed CLI use?

Wavespeed CLI is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Wavespeed CLI use?

About 1k tokens (SKILL.md is roughly 4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Wavespeed CLI?

Skills that share tags, products or a category with Wavespeed CLI: Media Gen (clacky-ai/openclacky, 1.2k stars), Clean Audio (hassancs91/claude-youtube-editor, 322 stars), Scenario Video (scenario-labs/skills, 898 stars) and HyperFrames Media Use (heygen-com/hyperframes, 58k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Wavespeed CLI?

hashgraph-online (a GitHub organization) maintains it in hashgraph-online/awesome-codex-plugins, which has 1,232 GitHub stars. The repository holds 736 skills in this directory. The repository was last updated on October 6, 2026.

Source: hashgraph-online/awesome-codex-plugins on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.