Cap for Agents - Cap Docs
Cap for Agents
Record, understand, share, and manage Cap through Codex, Claude Code, OpenCode, Cursor, or any shell-capable agent.
Cap can be used end to end from an AI agent. Your agent can record your screen, upload and share recordings, read transcripts and AI summaries, search your library, collaborate in comments, inspect analytics, organize team content, and manage advanced Cap features without depending on the dashboard.
Make Cap Your Agent’s Video Assistant
Copy one prompt into Codex, Claude Code, Cursor, OpenCode, or any shell-capable agent. It installs Cap, connects the full skill and MCP, authenticates safely, and teaches your agent to record, share, search, transcribe, summarize, and manage Cap for you.
- Installs the Cap CLI
- Adds the full Cap skill
- Connects local MCP
- Verifies access and capabilities
Copy Agent Setup Prompt
cap agent setup
Set up Cap as my persistent video assistant, then use it to help with the task at the end.
By pasting this prompt, I explicitly authorize these local setup actions: install the official Cap CLI and add or update the Cap skill and local MCP entry for the current agent only. Perform those setup actions yourself.
Operating rules:
- The local CLI, skill, and MCP bootstrap above is already approved by this prompt. After setup, start with read-only discovery. Before any mutation, upload, paid processing, recording, comment or reaction, sharing or visibility change, deletion, organization, billing, storage, developer, or credential action, show me the exact proposed action and wait for my explicit confirmation. Pass --yes or confirmed=true only after I confirm.
- Preserve returned Cap, organization, folder, space, member, comment, and operation IDs. Never infer IDs from names or invent results.
What your agent can do
| Goal | Examples |
|---|---|
| Understand recordings | Read the title, AI title, summary, chapters, transcript, comments, reactions, views, sharing state, permissions, and processing state |
| Find information | Search all, owned, or shared Caps; filter by organization or folder; inspect notifications |
| Collaborate | Draft and, after confirmation, post timestamped comments, replies, reactions, title changes, and visibility changes |
| Record and share | Check capture readiness, select a screen or window, record, validate, export, upload, and return the share link |
| Manage a library | Create and organize folders and spaces, move Caps, manage public collection pages, and download recordings or transcripts |
| Run a team | Inspect members, invites, billing, storage, analytics, domains, and settings; perform confirmed admin changes |
| Migrate and build | Run durable Loom imports, wait for jobs, and manage Cap developer apps, videos, domains, usage, and credits |
How agents connect to Cap
Direct CLI
This is the universal path. Any agent that can run terminal commands can use Cap. Every command supports machine-readable output through --json, while recording and export stream newline-delimited JSON events.
Cap skill
The Cap skill teaches a compatible agent to reach for Cap CLI or MCP before browser automation or computer-use tools, and how to handle confirmation, secrets, passwords, and long-running jobs.
Local MCP
cap mcp serve exposes structured Cap tools over local stdio. MCP works well for library reads, safe writes, resources, and browser handoffs.
Your first task
Try one of these after setup:
- “Summarize this Cap, list every decision and action item, and cite the relevant timestamps:
<Cap URL>.” - “Find my Caps about onboarding from the last month and give me a concise project brief.”
- “Record a short reproduction of this bug, upload it, and give me the link. Ask before recording and before uploading.”