@deepdub/agent-plugin

Deepdub Agent Plugin

Claude Code, Codex, and Cursor skills for adding Deepdub text-to-speech to JavaScript, Python, REST, and CLI projects.

The goal is simple: ask your coding agent to add speech generation, and it should know the right SDK, env vars, voice presets, streaming tradeoffs, and error handling without making you paste docs.

What Is Included

• Claude Code plugin: plugin/.claude-plugin/plugin.json
• Codex plugin: plugin/.codex-plugin/plugin.json
• Portable skill: plugin/skills/deepdub-tts/SKILL.md
• Cursor project skill wrapper: .cursor/skills/deepdub-tts/SKILL.md
• Codex project skill wrapper: .agents/skills/deepdub-tts/SKILL.md
• Marketplace catalogs for local testing:
  • Claude Code: .claude-plugin/marketplace.json
  • Codex: .agents/plugins/marketplace.json
• npm CLI: deepdub-agent-kit
• Runnable JavaScript and Python examples under examples/

Fastest Use

Run a TTS demo from the terminal:

npx @deepdub/agent-plugin tts \
  --text "Hello from Deepdub" \
  --out hello.mp3

If DEEPDUB_API_KEY is not set, the CLI uses Deepdub's public rate-limited trial key for that demo. For real projects:

export DEEPDUB_API_KEY=dd-your-api-key

Install Skills Locally

Install the skill into the current project for Cursor, Codex, and Claude Code:

npx @deepdub/agent-plugin install --agent all --scope project

Install globally for your user:

npx @deepdub/agent-plugin install --agent all --scope user

Use --link while developing this repository, or --force to replace an existing installed copy.

Scaffold A Tiny App

JavaScript:

npx @deepdub/agent-plugin scaffold --language js --out ./deepdub-demo
cd deepdub-demo
npm install
DEEPDUB_API_KEY=dd-your-api-key npm run tts -- "Welcome to Deepdub"

Python:

npx @deepdub/agent-plugin scaffold --language python --out ./deepdub-demo
cd deepdub-demo
pip install -r requirements.txt
DEEPDUB_API_KEY=dd-your-api-key python tts.py "Welcome to Deepdub"

Claude Code Marketplace

Install from the public GitHub repository:

claude plugin marketplace add https://github.com/deepdub-ai/deepdub-agent-plugin
claude plugin install deepdub-tts@deepdub-agent-plugins

During local development, add this repository as a marketplace from disk:

claude plugin marketplace add ./path/to/deepdub-agent-plugin
claude plugin install deepdub-tts@deepdub-agent-plugins

Or test the plugin directly:

claude --plugin-dir ./plugin

After installation, use prompts like:

Use Deepdub TTS to add a /tts endpoint that returns MP3 bytes.
Use Deepdub TTS to create a CLI command that saves speech to a file.
Use Deepdub TTS to stream WAV chunks from a WebSocket connection.

Codex Marketplace

Codex can read the repo marketplace at .agents/plugins/marketplace.json. For a local marketplace:

codex plugin marketplace add ./path/to/deepdub-agent-plugin

You can also use the repo skill directly from .agents/skills/deepdub-tts/.

Cursor Skill

Cursor discovers project skills from .cursor/skills/. This repo includes a wrapper skill that points to the canonical skill in plugin/skills/deepdub-tts/.

For use in another project:

npx @deepdub/agent-plugin install --agent cursor --scope project --project /path/to/project

CLI Reference

deepdub-agent-kit --help
deepdub-agent-kit doctor
deepdub-agent-kit install --agent cursor,codex --scope project
deepdub-agent-kit scaffold --language js --out ./deepdub-demo
deepdub-agent-kit voices --api-key dd-your-api-key
deepdub-agent-kit tts --text "Hello" --voice-prompt-id 50a537cf-1ec8-4714-b07e-c589ab76be4b --out output.mp3

Development

npm install
npm run smoke
npm run doctor

Validate Claude Code metadata if you have Claude Code installed:

claude plugin validate ./plugin

Deepdub Docs

• Documentation index: https://docs.deepdub.ai/llms.txt
• Quickstart: https://docs.deepdub.ai/quickstart.md
• JavaScript SDK: https://www.npmjs.com/package/@deepdub/node
• Python SDK: https://docs.deepdub.ai/sdk.md
• Voice presets: https://docs.deepdub.ai/voice-presets.md