Conecta tu agente.
Frameshell no trae una IA propia. Usas el agente que ya tienes, o eliges uno de abajo, y edita el video mientras lo ves en la app. Lo configuras una vez y funciona en todos tus proyectos.
¿Cuál elijo?
Todos pueden editar tu video. Cambia la app en la que hablas con él y la cuenta que necesita.
¿Es tu primera vez? Empieza con Claude Desktop si tienes cuenta de Claude, o con Claude Code si pagas Claude.
Claude Desktop El más fácil
Chateas con Claude en su propia app y edita el proyecto abierto en Frameshell a través de la conexión MCP de Frameshell.
-
Instala Claude
Descárgalo de claude.com/download e inicia sesión. macOS y Windows; en Linux hay una beta para Ubuntu y Debian.
-
Conecta Frameshell con Claude
En Frameshell 0.8 o posterior, abre un proyecto y haz clic en Conectar Claude Desktop, arriba de la terminal. Frameshell te muestra lo que agrega a la configuración de Claude, deja los demás servidores como están y guarda una copia antes.
-
O agrégalo a mano
En Linux o con una versión anterior: en Frameshell elige Archivo → Instalar el comando 'frameshell' en el PATH (el paquete .deb ya lo trae). Luego, en Claude, abre Settings → Developer → Edit Config, pon esto en el archivo sin borrar lo que ya haya en
mcpServersy guárdalo:macOS{ "mcpServers": { "frameshell": { "command": "/usr/local/bin/frameshell", "args": ["mcp"] } } }Windows{ "mcpServers": { "frameshell": { "command": "cmd", "args": ["/c", "%LOCALAPPDATA%\\Frameshell\\desktop\\bin\\frameshell.cmd", "mcp"] } } }Linux{ "mcpServers": { "frameshell": { "command": "/usr/bin/frameshell", "args": ["mcp"] } } } -
Reinicia Claude
Cierra Claude por completo y vuelve a abrirlo. Frameshell aparece entonces entre sus conectores.
-
Pruébalo
Con tu proyecto abierto en Frameshell, pregúntale a Claude: “¿Qué videos tiene mi proyecto de Frameshell?” Claude trabaja en el proyecto de la ventana de Frameshell que usaste por última vez. Con versiones anteriores a la 0.8, dile dónde está el proyecto.
Claude Code
El agente de Anthropic para la terminal. Encuentra solo la skill de Frameshell en tu proyecto.
-
Instálalo
Pega una línea en una terminal: Terminal en macOS, PowerShell en Windows. No necesita nada más.
macOS, Linuxcurl -fsSL https://claude.ai/install.sh | bashWindowsirm https://claude.ai/install.ps1 | iex -
Ábrelo en Frameshell
Abre tu proyecto, haz clic en el panel de la terminal, escribe
claudey presiona Enter. La primera vez abre tu navegador para iniciar sesión. -
Pídele
“Quita los silencios y las tomas que repetí.” Pregunta antes de ejecutar comandos; desde Frameshell 0.7, los proyectos nuevos le dejan usar los de Frameshell sin preguntar.
Codex
El agente de OpenAI para la terminal. Lee el AGENTS.md del proyecto, que lo lleva a la skill de Frameshell.
-
Instálalo
Pega una línea en una terminal.
macOS, Linuxcurl -fsSL https://chatgpt.com/codex/install.sh | shWindowspowershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex" -
Ábrelo en Frameshell
En la terminal del proyecto escribe
codex. La primera vez elige Sign in with ChatGPT. -
Pídele
En un proyecto creado antes de Frameshell 0.7, empieza con “Lee primero .claude/skills/frameshell/SKILL.md.” Los proyectos nuevos se lo indican solos.
Gemini CLI
El agente de Google para la terminal. Lee el GEMINI.md del proyecto. En junio de 2026 Google lo reemplazó por Antigravity CLI para las cuentas gratuitas; con una API key o un plan pago sigue funcionando.
-
Instálalo
Con Homebrew en macOS, o con npm donde tengas Node.js.
macOSbrew install gemini-cliCualquieranpm install -g @google/gemini-cli -
Ábrelo en Frameshell
En la terminal del proyecto escribe
geminiy elige cómo iniciar sesión. -
Pídele
Igual que con Codex, en un proyecto creado antes de Frameshell 0.7 dile “Lee primero .claude/skills/frameshell/SKILL.md.”
OpenCode
Un agente de código abierto que funciona con muchos proveedores de modelos. Carga solo la skill de Frameshell del proyecto.
-
Instálalo
Pega una línea en una terminal. En Windows también se instala con Scoop o Chocolatey.
macOS, Linuxcurl -fsSL https://opencode.ai/install | bashWindowsscoop install opencode -
Ábrelo y elige un modelo
En la terminal del proyecto escribe
opencode, luego/connectpara entrar a un proveedor y/modelspara elegir uno. -
Pídele
“Agrega subtítulos con lo que se dice.”
Para usuarios avanzados: Pi
Pi es un agente de código abierto pequeño que funciona con muchos proveedores. Ejecuta comandos sin preguntar antes, así que puede cambiar o borrar archivos por su cuenta. Úsalo si eso no te molesta, o dentro de un contenedor.
curl -fsSL https://pi.dev/install.sh | sh
powershell -c "irm https://pi.dev/install.ps1 | iex"
En la terminal del proyecto escribe pi y luego /login. Lee el AGENTS.md; en proyectos anteriores, pídele que lea primero .claude/skills/frameshell/SKILL.md.
Qué pedirle
Háblale como a un editor. Trabaja por pasos y ves cada uno en la línea de tiempo.
- “Quita las pausas largas y las tomas que repetí.”
- “Agrega subtítulos abajo, de dos palabras a la vez.”
- “Haz una versión vertical para Reels y TikTok.”
- “Pon al principio una placa con el nombre del episodio.”
- “Expórtalo para YouTube.”
¿Cambiaste de idea? Abre History en Frameshell y revierte cualquier cambio, tuyo o del agente.
Windows: la primera vez
Frameshell todavía no está firmado para Windows, así que la primera vez Windows te protege con una ventana azul de SmartScreen. Haz clic en Más información y luego en Ejecutar de todas formas. Lo pregunta una sola vez.
Si algo no funciona
- “frameshell: command not found” fuera de Frameshell: elige File → Install 'frameshell' Command in PATH y abre una terminal nueva.
- El agente no conoce Frameshell: ábrelo desde la terminal de Frameshell, en la carpeta del proyecto, o pídele que lea
.claude/skills/frameshell/SKILL.md. - Claude Desktop no muestra Frameshell: revisa que el archivo de configuración sea JSON válido, cierra Claude por completo y vuelve a abrirlo.
- Cualquier otra cosa: ejecuta
frameshell doctoren la terminal del proyecto y envía lo que muestra en un issue de GitHub.