Codex Plugin Wavespeed CLI — Development skill for Claude Code

WaveSpeed plugin for Codex

A [Codex](https://developers.openai.com/codex) plugin that lets the agent generate and edit AI media — image, video, audio, 3D — on the [WaveSpeed](https://wavespeed.ai) platform.

It bundles two things:

• MCP server — `@wavespeed/mcp`, started on demand with npx. Tools: search_models, get_model_schema, get_price, upload_file, run_model, get_prediction, get_balance.
• Skill — the find → inspect → run workflow on the open-source `@wavespeed/cli`: search the live catalog, read any model's input schema, run it, upload local files with the @path marker, and quote prices before spending credits.

Install

Add this repository as a plugin marketplace, then install **WaveSpeed** from `/plugins`:

codex plugin marketplace add WaveSpeedAI/codex-plugin-wavespeed-cli

Pin a release instead of tracking `main`:

codex plugin marketplace add WaveSpeedAI/codex-plugin-wavespeed-cli --ref v0.1.2

Or, with the community CLI: `npx codex-marketplace add WaveSpeedAI/codex-plugin-wavespeed-cli --plugins`.

Requirements

• Node.js ≥ 18 (npx runs the MCP server, nothing else to install)
• A WaveSpeed account. Either set WAVESPEED_API_KEY, or install the CLI (npm install -g @wavespeed/cli) and run wavespeed login once. One login covers both the MCP server and the CLI. Keys live at wavespeed.ai/accesskey.

Helper scripts, if you prefer the CLI path:

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

What the agent can do with it

• "Generate a 16:9 hero image of a cyberpunk skyline at golden hour."
• "Animate ./hero.jpg into a 5-second clip with subtle parallax."
• "Replace the background of ./product.png with a sunlit kitchen."
• *"How much would a 10-second 1080p video cost before you run i