widget-embedding — Claude Code subagent: what it does, how to install
widget-embedding guides the integration of ElevenLabs voice conversation widgets into web projects, handling visual styles, mobile layouts, and secure access.
AGPL-3.0 ★ 78,316 updated 2026-10-24
.claude/agents/widget-embedding.mdWhat widget-embedding does
This subagent assists with embedding the <elevenlabs-convai> custom element into web pages. It supplies patterns for script injection, configuring orb color schemes, swapping avatar icons, and adjusting status captions.
It also details JavaScript methods like startConversation() and endConversation() alongside Shadow DOM custom properties for responsive sizing. Frontend setups include component snippets tailored for React, Vue, and Next.js.
Direct agent identifiers function solely with unauthenticated public bots: private setups strictly require your backend to issue signed URLs.
What it helps with
- Embed an interactive ElevenLabs voice assistant button on a web page
- Style the floating widget with custom colors and avatar images
- Trigger conversations programmatically using JavaScript event listeners
- Pass secure signed URLs to private voice agents from a backend API
Example prompts for the agent
- Embed the ElevenLabs voice widget with a custom start button and hidden default container
- Show me how to fetch a signed URL in Python and supply it to the conversational widget
- Create a Vue component that registers the convai script and embeds the agent element
How to install widget-embedding
Manually: put the files in place
.claude/agents/widget-embedding.mdFor all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention
Manually: put the files in place
.codex/agents/widget-embedding.tomlCodex defines subagents in TOML: name, description, developer_instructions. Move the Markdown text into developer_instructions by hand. For all projects use ~/.codex/agents/
Manually: put the files in place
.cursor/agents/widget-embedding.mdCursor also reads .claude/agents/
Step by step, with commands for each platform: Claude Code subagents: how to create one, call it and keep context clean
Questions about widget-embedding
How to install widget-embedding in Claude Code?
Add the subagent definition file to .claude/agents/widget-embedding.md. If you use Codex, place it in .codex/agents/widget-embedding.toml.
What does the widget-embedding subagent do?
It provides implementation templates and CSS properties to embed ElevenLabs conversational voice widgets into websites and modern frameworks.
Can I use private ElevenLabs agents with the embeddable widget?
Yes, but you must supply a backend-generated signed-url instead of exposing a public agent-id in your client markup.