twelve-labs-claude-code-plugin

Upload, list, or delete TwelveLabs assets — generic reference files (images or videos) used by entities and async-analyze. Triggers on "upload this image", "upload this video as an asset", "delete that asset", or any explicit asset-management request.

Asynchronously analyze a video — by URL, local file path (auto-uploaded), asset ID, or base64 — no prior indexing required. Use for URL inputs, videos over 1 hour, time-based metadata extraction, multimodal prompting with reference images, structured JSON output, or when the user asks to check/list/delete async analysis tasks.

Set up and search for specific people or objects in videos using entity search. Use when the user wants to find a specific person, track someone across videos, or set up face/object recognition. Triggers on phrases like "find this person", "set up entity search", "track this person in my videos", "who is in this video".

Synchronously analyze a video to understand its content. Accepts an indexed videoId, a direct video URL, a previously uploaded asset, or a local file path (auto-uploaded). Use when the user asks "what is this video about?", "summarize the video", "analyze this video", or has questions about video content.

Create, check, and retrieve video embeddings. Use when user wants to generate embeddings from a video, check embedding status, or retrieve embeddings for a video.

Search videos using an image combined with text for refined results. Use when the user wants to search with a reference image, says "find videos matching this image", "search with this picture", or wants to combine visual reference with text description.

Index video files or URLs for AI search and analysis. Use when user wants to add a video for processing, says "index this video", "add this video for analysis", or mentions a video file they want to work with.

List indexed videos and available indexes. Use when user wants to know what videos they have indexed, asks "what videos do I have?", "show my videos", or needs to find a video ID for analysis.

Search indexed videos using natural language. Use when the user wants to find specific content, moments, or scenes in their indexed videos. Triggers on phrases like "find the part where...", "search for...", "look for...", "where does...", "when does...".

Check the status of video indexing tasks. Use when user asks about indexing progress, says "is my video ready?", "how long until indexing is done?", or wants to know if they can search/analyze yet.