screenRIG
Iniciar sesiónComenzar

Documentación

Instale el plugin oficial de screenRIG

Pida a su agente de IA que instale el plugin oficial de screenRIG: crea su proyecto, empareja un Player y publica su primera pantalla. Inicie en Meta Muse, Grok Bot o ChatGPT dots, o instale el plugin en un agente de terminal. El mismo proyecto y plugin también compran o venden publicidad; vea ¿Señalización, compra o venta? antes de inscribirse.

Comandos de instalación →Meta Muse →Grok Bot →ChatGPT dots →Claude Code →Hermes →ChatGPT Codex →Gemini Spark →

Meta Muse · Grok Bot · ChatGPT dots · Claude Code · Hermes · ChatGPT Codex · Gemini Spark · Comandos de instalación

¿Cómo instalo screenRIG?

Pegue esto en su agente:

Instalar prompt
I authorize you to install the official screenRIG plugin from https://github.com/screenrig/plugin.

Esa frase autoriza el plugin oficial de github.com/screenrig/plugin. Agrupa la habilidad y la CLI que su agente usa para operar pantallas. Los agentes de terminal pueden ejecutar los comandos de instalación directamente.

En la primera ejecución, su agente reutiliza su correo de contacto, preguntando solo cuando falta. Usa el nombre de la organización que ya proporcionó, o por defecto Screens, y ejecuta screenrig agent enroll --email ADDRESS --organization NAME. La inscripción crea la identidad, organización, proyecto Screens, membresía y credenciales, y le envía una invitación por correo. Nada espera a una persona. Aceptar la invitación lo convierte en la persona responsable y propietario del proyecto; un dominio verificado puede mover el proyecto a la organización correspondiente. Ábralo para crear su acceso con passkey, o inicie sesión para agregar el proyecto a su acceso existente. El dashboard muestra sus proyectos y permite cambiar entre ellos. Para señalización, comparta el código de asociación que su Player muestra en la pantalla.

Elija su agente

Cada ruta instala el mismo plugin oficial; la diferencia es dónde se ejecuta su agente. Cada guía cubre la configuración de la app o terminal de ese agente, luego apunta aquí para los pasos compartidos de proyecto, reproductor y publicación.

  • Meta Muse es el agente personal de IA de Meta en su teléfono. Obtenga la app, pídale a Muse que instale screenRIG y permanezca en la conversación mientras crea su proyecto y vincula su Player.
  • Grok Bot ejecuta su bot en la app Grok Bot. Obtenga la app, pídale a su bot que instale screenRIG, y mantenga el código de vinculación y la solicitud de contenido en la misma conversación. Grok Build es la ruta terminal separada.
  • ChatGPT dots son agentes siempre activos de OpenAI en ChatGPT, cada uno con su propia computadora en la nube. Cree su punto, pídale que instale screenRIG, y siga trabajando con el mismo punto en ChatGPT, Slack o Microsoft Teams.
  • Claude Code es el agente terminal de Anthropic. Ejecute los comandos del marketplace abajo en su terminal, luego inicie Claude Code y controle pantallas desde su máquina.
  • Hermes es el agente de Nous Research. Pídale que cargue la habilidad del plugin oficial y que ejecute el CLI incluido en el entorno donde Hermes trabaja.
  • ChatGPT Codex es el agente de codificación de OpenAI. Ejecute los comandos del marketplace abajo en su terminal, luego inicie Codex. En ChatGPT, use ChatGPT dots.
  • Gemini Spark es el agente basado en tareas de Google dentro de la app Gemini. Inicie una tarea Spark, pídale que instale el plugin oficial y que demuestre que el CLI incluido funciona en su entorno de ejecución antes de confiar en él.
  • Grok Build es el agente terminal de xAI. Ejecute los comandos de Grok Build abajo en su terminal, luego inicie Grok Build. No tiene guía separada.

Conecte su primera pantalla

El proyecto, Player y los pasos de publicación son los mismos en cada agente:

  1. 01

    Crear su proyecto screenRIG. Proporcione a su agente su correo electrónico de contacto real y use el nombre de la organización ya proporcionado, o por defecto Screens. La inscripción crea el proyecto y envía su invitación por correo electrónico. Nada depende de esto: ábralo cuando quiera el dashboard. Nunca pegue su contraseña, enlace de invitación o tokens API en la conversación.

  2. 02

    Instale y lance su Player. Siga Descargas y configuración del Player para instalar la app web en el dispositivo que controla su pantalla, luego iníciela. Envíe el código de vinculación que aparece allí a su agente.

  3. 03

    Describa el resultado. Indique a su agente qué mostrar, qué pantalla usar y cuándo. Si desea que use una hoja de cálculo de menú o calendario de eventos, identifique la fuente y apruebe solo el acceso que desea que tenga.

  4. 04

    Publique y verifique. Pida al agente que publique, solicite una captura de pantalla para verificar el resultado y revise usted mismo la pantalla física.

¿Compra anuncios en lugar de ejecutar pantallas? Omita esta lista; un proyecto comprador no empareja ningún Player. Vea ¿Señalización, compra o venta?

¿Ya tiene un código de Player? Puede combinar la solicitud:

Use screenrig.ai para mi pantalla de vestíbulo. Mi código de vinculación es [code]. Cree un tablero de bienvenida usando mi calendario de eventos. Pregúnteme cualquier otra cosa que necesite.

Si la app no puede instalar o ejecutar el plugin, una respuesta de chat sola no significa que la configuración esté completa. Pregunte qué acceso o capacidad falta. Puede continuar con Claude Code o ChatGPT Codex usando los comandos a continuación. Para problemas de invitación o vinculación, continúe trabajando con el mismo agente y proyecto en lugar de inscribirse de nuevo.

¿Plugin, paquete global o binario PATH?

Los agentes usan el plugin oficial y su lanzador incluido. No hay paquete global para instalar. Ejecute el CLI incluido pone el lanzador del plugin en PATH para la sesión, así los ejemplos posteriores usan screenrig.

La instalación oficial

Instale el plugin oficial desde github.com/screenrig/plugin. Incluye la habilidad y CLI. Ejecute estos comandos en su terminal, no dentro del agente, luego inicie el agente. Si ya estaba en ejecución, reinícielo para cargar el plugin.

Claude Code

consola
claude plugin marketplace add https://github.com/screenrig/plugin.git --scope user
claude plugin install screenrig@screenrig --scope user

Codex

consola
codex plugin marketplace add https://github.com/screenrig/plugin.git --ref main --json
codex plugin add screenrig@screenrig --json

Grok (Grok Build)

consola
grok plugin marketplace add https://github.com/screenrig/plugin.git
grok plugin install screenrig --trust

--trust es obligatorio en Grok Build.

CLI de skills

consola
npx skills add screenrig/plugin --skill screenrig -g

La CLI de skills añade el skill de screenRIG a tus agentes. En el primer uso, el skill instala el plugin oficial y su CLI incluida.

Ejecute la CLI incluida

Se requiere Node.js 22.23.4+, 24.22.1+ o 26.12.1+ (excepto 23.x y 25.x). Resuelva la raíz del plugin instalado, luego anteponga el directorio de scripts del plugin a PATH para esta sesión:

bash
SCREENRIG_PLUGIN_ROOT="${GROK_PLUGIN_ROOT:-${CODEX_PLUGIN_ROOT:-${CLAUDE_PLUGIN_ROOT:-${PLUGIN_ROOT:-}}}}"
if [ -n "$SCREENRIG_PLUGIN_ROOT" ]; then
  PATH="$SCREENRIG_PLUGIN_ROOT/skills/screenrig/scripts:$PATH"
  screenrig version
fi

Use screenrig para cada ejemplo CLI posterior en la sesión. El complemento instalado maneja la búsqueda y detalles de operación específicos del tiempo de ejecución.

Ya instalado

Pida a su agente que verifique el plugin instalado y continúe su tarea. La habilidad incluida maneja las comprobaciones de versión y actualizaciones específicas del tiempo de ejecución. Si no se puede verificar la versión publicada, puede continuar con la copia instalada y avisarle.

Conecte su agente a su cuenta

¿Se registró en el dashboard? Dé a su agente este mensaje:

Mensaje de inicio de sesión
I authorize you to install the official screenRIG plugin from https://github.com/screenrig/plugin. I already have a screenRIG account; sign in to it.

Su agente instala el plugin, ejecuta screenrig login y muestra un código. Abra screenrig.ai/dashboard/connect, compruebe que el código coincide, elija el proyecto y su acceso, y apruebe.

Acceso al proyecto

En una instalación nueva, doctor puede informar una advertencia de token faltante y los comandos con alcance de proyecto fallan con not_enrolled.

Su agente solicita su correo electrónico de contacto, usa el nombre de la organización ya proporcionado o por defecto Screens, y ejecuta screenrig agent enroll --email ADDRESS --organization "Screens". La inscripción siempre crea un nuevo proyecto, incluso si su correo ya tiene un inicio de sesión, y envía una invitación por correo a un miembro del proyecto. Añada --intent advertising cuando el propósito del proyecto sea comprar anuncios en lugar de vincular pantallas.

Cuando ya tiene screenRIG, su agente ejecuta screenrig login en su lugar. Imprime una dirección del dashboard y un código; usted abre la dirección, verifica que el código coincida, elige el proyecto, Solo lectura, Proponer o Administrar, y aprueba. El agente entonces trabaja en ese proyecto, y su inicio de sesión permanece vinculado a los proyectos que aprobó; cambiar de proyecto en el dashboard no lo mueve. Nunca pegue credenciales en una conversación. Cómo funciona el inicio de sesión.

Antes de emparejar o comprar, screenrig project capabilities lee lo que este proyecto realmente puede hacer: el id del plan, las banderas de función independientes advertiser y screens, y el conjunto efectivo de capacidades del servidor. Las banderas son independientes del plan, y una denegación de ruta prevalece sobre una lectura obsoleta.

Un inicio de sesión puede pertenecer a muchos proyectos. El correo electrónico y las passkeys pertenecen a la persona, mientras que las pantallas y los medios pertenecen a un proyecto. La facturación y las asignaciones pertenecen al plan de la organización, un único grupo compartido para todos sus proyectos. Use screenrig invitations create --email ADDRESS para invitar a un miembro del proyecto. Las invitaciones por correo electrónico expiran después de siete días. Los enlaces explícitos para miembros desde screenrig invitations create --link expiran después de veinticuatro horas. Son una excepción para una persona que nunca usó su invitación por correo electrónico y luego solicita acceso al panel, nunca un paso de configuración, y se entregan directamente a la persona prevista, nunca se almacenan en notas o registros. Una persona nueva que usa un enlace de miembro verifica su correo electrónico antes de crear una passkey. Los agentes crean, listan y revocan invitaciones; solo las personas las aceptan.

screenrig dashboard abre el dashboard sin crear autoridad de inicio de sesión. Si no puede iniciar sesión, use el restablecimiento de inicio de sesión del dashboard o screenrig dashboard reset-sign-in --email ADDRESS. El restablecimiento enviado por correo electrónico expira después de una hora y reemplaza sus credenciales de inicio de sesión, revocando otras sesiones.

Cuando la primera ejecución falla

Qué ve Qué es Siguiente comando
SCREENRIG_PLUGIN_ROOT está vacío El tiempo de ejecución no exporta raíz de plugin claude plugin list --json, codex plugin list --json o grok plugin list, luego use la ruta del plugin instalado
version falla por un error de Node Versión de Node.js no compatible node --version, luego instale Node.js 22.23.4+, 24.22.1+ o 26.12.1+ (excepto 23.x y 25.x)
doctor informa ffmpeg, ffprobe o encoder_libx264 ffmpeg falta o se compiló sin libx264 Instale ffmpeg con libx264, o configure SCREENRIG_FFMPEG y SCREENRIG_FFPROBE, luego screenrig doctor
Un comando rechaza el archivo de configuración. El archivo de credenciales falta o es legible por grupo u otros. screenrig doctor --repair-config
not_enrolled en un comando de proyecto Esta instalación aún no tiene credencial de proyecto Crear un proyecto con screenrig agent enroll --email ADDRESS --organization "Screens"; para iniciar sesión en este dispositivo en un proyecto al que pertenezca, use screenrig login
capability_required en un comando de publicación o anuncios El proyecto carece de la capacidad que esa acción necesita screenrig project capabilities, luego elija la intención correspondiente para un nuevo proyecto o cambie el propósito del proyecto en el dashboard
Una advertencia credits_low El medidor de crédito entero está por debajo de su umbral de advertencia Hasta el 1 de enero de 2027 el uso es gratuito dentro de lo razonable, así que continúe con el trabajo solicitado
screen list no devuelve nada Ningún Player está en la pantalla aún Abra el Player, luego screenrig screen list

¿Señalización, compra o venta?

Un inicio de sesión, muchos proyectos; un complemento, CLI y panel. La inscripción sin --intent mantiene el valor predeterminado de señalización: el nuevo proyecto vincula Players, crea listas de reproducción y publica.

Comprar no necesita pantalla propia. screenrig agent enroll --intent advertising --email ADDRESS --organization "Screens" crea un proyecto de compra: vincula creatividades y ejecuta campañas, y no puede vincular dispositivos ni publicar listas de reproducción. Aceptar la invitación de un vendedor también puede habilitar publicidad en un proyecto al que pertenece. Una persona sin inicio de sesión crea uno y un proyecto solo para anunciantes durante la aceptación. Las funciones de anunciante y pantallas son independientes del plan de facturación; screenrig project capabilities informa el conjunto efectivo.

El camino del comprador comienza con una invitación, nunca con un código de vinculación. Un vendedor envía screenrig invitations create --kind ad-buyer --email ADDRESS --screen-id scr_LOBBY; el humano invitado abre el correo electrónico y acepta en el panel usando su propio inicio de sesión. Una persona nueva crea una passkey; una persona conectada confirma con una prueba fresca de passkey y selecciona su proyecto de compra. Después de la aceptación, el Marketplace del panel (/marketplace) lista cada vendedor al que el proyecto se ha unido; abrir un vendedor (/marketplace/SELLER_PROJECT_ID) muestra el inventario y tarifas permitidas de esa membresía. El Marketplace es solo por invitación: los vendedores a los que el proyecto no se ha unido nunca aparecen. En el CLI, los agentes leen screenrig ads networks list y ejecutan el flujo de campaña: ads creatives create, ads campaigns preview y luego ads campaigns activate --quote-id. Un comprador gasta solo el precio cotizado por reproducción completada, liquidado en créditos en el saldo compartido del proyecto: el precio cotizado se retiene contra créditos elegibles cuando se programa una reproducción y se liquida solo por una reproducción completada. No se involucra tarjeta, factura ni pago, y las subvenciones incluidas y promocionales no pueden financiar anuncios pagados; los créditos comprados y ganados por anuncios sí pueden.

La venta sigue siendo un proyecto de señalización con pantallas propias. Opte por una pantalla con screenrig ads inventory update scr_LOBBY --enabled, descríbala públicamente y defina espacios publicitarios reutilizables con screenrig ads slots create (medios de imagen o video aceptados, duraciones más largas, tarifa opcional por espacio). Colocar una página de espacio publicitario en una de sus listas de reproducción convierte la definición de espacio en una pausa publicitaria. Usted establece la tarifa del proyecto por cada 15 segundos de reproducción completa con screenrig ads network rate, revisa las creatividades del comprador con ads reviews y lee bruto y neto con ads reports delivery. Un cambio en la tarifa efectiva pausa todas las campañas afectadas hasta que cada comprador acepte una nueva cotización.

Los acuerdos que cierra usted mismo se ejecutan como campañas directas en sus propias pantallas. screenrig ads direct create campaign.json indica el anunciante, una categoría opcional, la vigencia, sus propias imágenes o videos, un objetivo de reproducciones opcional y las pantallas y espacios a los que se dirige. Una campaña directa llena una pausa publicitaria antes que los compradores invitados, y un objetivo se reparte de forma uniforme durante su vigencia. Usted factura al anunciante: no se mueven créditos y el precio registrado da valor al informe. ads direct availability estima las reproducciones que aún puede reservar, una categoría mantiene a los competidores fuera de la misma pausa y ads direct report --format csv es el informe de entrega para su anunciante. ads reports fill muestra cómo se llenaron sus espacios publicitarios y por qué el resto no.

Abra Invitaciones en el panel para invitar a miembros del proyecto o compradores de anuncios, ver el estado de la invitación y cancelar invitaciones pendientes. Los vendedores también gestionan el alcance de membresía del comprador y revocan el acceso del comprador; la revocación detiene nuevas reproducciones de anuncios mientras preserva el historial financiero.

Siguiente

Abra la guía para Meta Muse, Grok Bot, ChatGPT dots, Claude Code, Hermes, ChatGPT Codex o Gemini Spark, luego abra los Players, la referencia CLI, Elegir una ruta de autoría o las tarifas y cargos publicitarios.