El plugin de agente de ChatCut es el paquete público de npm @chatcut/skill (actualmente v0.2.1), que instala una skill de Claude Code llamada “chatcut” más una herramienta de línea de comandos chatcut que crea videos editados con IA a partir de un prompt de texto y una lista de URLs de assets o rutas de archivo locales.
¿Cómo lo instalo?
Ejecuta npm install -g @chatcut/skill (pnpm add -g y yarn global add funcionan igual), y luego reinicia Claude Code. Se requiere una instalación global — la skill invoca el binario chatcut directamente desde tu PATH, así que npx @chatcut/skill submit no funciona. El paso de postinstalación de la instalación copia SKILL.md a ~/.claude/skills/chatcut/SKILL.md para que Claude Code detecte la skill automáticamente; ese registro se hace en modo “mejor esfuerzo” y nunca hace fallar la instalación de npm, así que si Claude Code no detecta la skill después, ejecuta chatcut install para registrarla manualmente.
¿Qué necesito para ejecutarlo?
El CLI chatcut requiere Node.js 18 o más reciente (engines.node >=18 en package.json).
¿Qué puede hacer el CLI?
El comando chatcut expone nueve subcomandos: install (con una opción --link), update, login, logout, pick, submit, status <jobId>, watch <jobId> y help. El principal es submit, que toma un --prompt <text> obligatorio, una o más banderas repetibles --asset <source:type> (el tipo es audio, gif, image o video), y opcionalmente las banderas --name <string>, --resolution <480p|720p|1080p>, --format <audio|video>, --codec <h264|mp3|prores|vp8>, --max-turns <n> y --model <name>. Si aún no tienes rutas de assets a mano, chatcut pick abre un diálogo nativo de selección de archivos e imprime líneas path:type que puedes pasar directamente a submit --asset.
¿Cómo crea un video chatcut submit?
Apunta submit a un prompt y tus medios, y ejecuta todo el pipeline por ti: describes la edición en lenguaje natural y proporcionas los assets como URLs públicas o rutas de archivo local absolutas — ambas se aceptan igual — el CLI las transcodifica localmente y las sube, el agente de ChatCut arma la línea de tiempo del lado del servidor, el video se renderiza en la nube, y recibes de vuelta una URL de descarga firmada. Si no defines --resolution ni --format, el CLI añade automáticamente una instrucción de exportación a tu prompt que por defecto es video en 1080p. Enviar un trabajo es una operación de pago, así que si el agente alteró tu redacción antes de enviarlo, está obligado a detenerse y mostrarte el texto exacto de --prompt para tu aprobación primero.
¿Cuánto tarda, y dónde veo el progreso?
chatcut submit bloquea hasta que el trabajo está completamente terminado — la transcodificación, la subida, el ciclo de edición del agente y el renderizado en la nube se ejecutan todos antes de que retorne — transmitiendo progreso legible a stderr todo el tiempo. Por detrás, consulta el estado del trabajo cada 3 segundos y se rinde con un error de tiempo de espera agotado si el trabajo no ha terminado en 40 minutos.
¿Dónde terminan los resultados?
Cada ejecución de chatcut submit crea un nuevo proyecto de ChatCut — nómbralo con --name, o acepta el predeterminado — e imprime de vuelta el projectId de ese proyecto junto con el jobId del trabajo y una outputUrl firmada para el archivo renderizado, como una sola línea JSON en stdout una vez que la ejecución termina.
¿Necesito ejecutar chatcut login primero?
No — si submit no encuentra una clave de API guardada, abre tu navegador para iniciar sesión automáticamente y continúa con el trabajo una vez que termines, así que no se requiere un paso separado de chatcut login antes de tu primer submit. Ese inicio de sesión abre una ventana del navegador apuntando a la página de inicio de sesión de ChatCut; después de que lo apruebas, el CLI intercambia el resultado por una clave de API de larga duración por detrás, y todo el flujo se agota tras 5 minutos si se deja incompleto.
¿Es lo mismo que el “plugin de Codex”?
No tal como está hoy — @chatcut/skill es exclusivamente una skill de Claude Code: el CLI se registra bajo ~/.claude/skills/chatcut, y nada en el paquete se integra con OpenAI Codex.
Consulta también: Cómo está organizado el editor de ChatCut.
¿Cómo instalo e inicio sesión en el plugin de agente de ChatCut?
Instala el plugin globalmente con npm install -g @chatcut/skill — pnpm add -g y yarn global add funcionan igual — y luego reinicia Claude Code. Requiere Node.js 18 o más reciente. Instalarlo también registra SKILL.md en ~/.claude/skills/chatcut/ para que Claude Code detecte la skill automáticamente; si ese registro no ocurre (por ejemplo con --ignore-scripts), ejecuta chatcut install para hacerlo manualmente. Se requiere una instalación global — npx @chatcut/skill no funciona desde dentro de Claude Code.
No necesitas un paso de inicio de sesión separado: el primer chatcut submit abre tu navegador a un intercambio de autorización basado en PKCE, y el flujo se agota tras 5 minutos si no lo completas. Para iniciar sesión de antemano en su lugar, ejecuta chatcut login.
Consulta también: Cómo inicio sesión en ChatCut.
¿Qué puede hacer el plugin de agente de ChatCut, y cuáles son sus límites?
El plugin de agente de ChatCut — el CLI chatcut, una skill de Claude Code — crea un proyecto, sube tus medios, ejecuta un trabajo de edición con IA en lenguaje natural, y devuelve una URL de descarga firmada en un solo comando. chatcut submit toma un prompt más assets (URLs o rutas de archivo locales); transcodifica el video localmente solo cuando el códec no es compatible con navegadores, la tasa de fotogramas supera los 30fps, o el bitrate supera los 8Mbps, limitando la salida a 1920px en el lado más largo — de lo contrario sube el archivo sin tocarlo. Luego bloquea hasta que el agente del lado del servidor de ChatCut termina de editar y de renderizar en la nube, transmitiendo progreso a stderr y una línea JSON final de jobId/projectId/outputUrl a stdout.
Límites: submit consulta cada 3 segundos, agotándose tras 40 minutos. chatcut status <jobId> verifica un trabajo una vez; chatcut watch <jobId> consulta hasta 20 minutos. El CLI verifica si hay una versión más reciente cada 24 horas (en caché) y solo avisa — nunca bloquea un comando.
Consulta también: Cómo instalo e inicio sesión en el plugin de agente de ChatCut.