Instale o plugin oficial do screenRIG

Meta Muse · Grok Bot · ChatGPT dots · Claude Code · Hermes · ChatGPT Codex · Gemini Spark · Comandos de instalação

Como eu instalo o screenRIG?

Cole isto no seu agente:

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

Essa frase autoriza o plugin oficial de github.com/screenrig/plugin. Ele agrupa a habilidade e o CLI que seu agente usa para operar telas. Agentes de terminal podem executar os comandos de instalação diretamente.

Na primeira execução, seu agente reutiliza seu e-mail de contato, perguntando apenas quando estiver ausente. Ele usa o nome da organização que você já forneceu, ou o padrão Screens, e executa screenrig agent enroll --email ADDRESS --organization NAME. A inscrição cria a identidade, organização, projeto Screens, associação e credenciais, e envia um convite por e-mail. Nada espera por uma pessoa. Aceitar o convite faz de você a pessoa responsável e proprietário do projeto; um domínio verificado pode mover o projeto para a organização correspondente. Abra-o para criar seu login com passkey, ou acesse para adicionar o projeto ao seu login existente. O dashboard mostra seus projetos e permite alternar entre eles. Para sinalização, compartilhe o código de pareamento que seu Player mostra na tela.

Escolha seu agente

Cada caminho instala o mesmo plugin oficial; a diferença é onde seu agente roda. Cada guia cobre a configuração do app ou terminal desse agente, depois aponta de volta aqui para os passos compartilhados de projeto, Player e publicação.

• Meta Muse é o agente pessoal de IA da Meta no seu telefone. Obtenha o app, peça para Muse instalar o screenRIG, depois permaneça na conversa enquanto ele cria seu projeto e associa seu Player.
• Grok Bot executa seu bot no app Grok Bot. Obtenha o app, peça para seu bot instalar o screenRIG, depois mantenha o código de pareamento e o pedido de conteúdo na mesma conversa. Grok Build é o caminho separado para terminal.
• ChatGPT dots são os agentes sempre ativos da OpenAI no ChatGPT, cada um com seu próprio computador na nuvem. Crie seu dot, peça para instalar o screenRIG, depois continue trabalhando com o mesmo dot no ChatGPT, Slack ou Microsoft Teams.
• Claude Code é o agente terminal da Anthropic. Execute os comandos do marketplace abaixo no seu terminal, depois inicie o Claude Code e controle as telas da sua máquina.
• Hermes é o agente da Nous Research. Peça para carregar a habilidade do plugin oficial incluído e executar o CLI incluído no ambiente onde o Hermes funciona.
• ChatGPT Codex é o agente de codificação da OpenAI. Execute os comandos do marketplace abaixo no seu terminal, depois inicie o Codex. No próprio ChatGPT, use ChatGPT dots.
• Gemini Spark é o agente baseado em tarefas do Google dentro do app Gemini. Inicie uma tarefa Spark, peça para instalar o plugin oficial e faça com que ele comprove que o CLI incluído roda em seu ambiente de execução antes de confiar nele.
• Grok Build é o agente terminal da xAI. Execute os comandos Grok Build abaixo no seu terminal, depois inicie o Grok Build. Não há guia separado.

Conecte sua primeira tela

O projeto, Player e as etapas de publicação são os mesmos em todos os agentes:

1. 01

   Criar seu projeto screenRIG. Forneça ao seu agente seu e-mail de contato real e use o nome da organização já fornecido ou o padrão Screens. A inscrição cria o projeto e envia seu convite por e-mail. Nada depende disso: abra-o quando quiser o dashboard. Nunca cole sua senha, link de convite ou tokens de API na conversa.

2. 02

   Instale e inicie seu Player. Siga Downloads e configuração do Player para instalar o app web no dispositivo que controla sua tela, depois inicie-o. Envie o código de pareamento mostrado para seu agente.

3. 03

   Descreva o resultado. Diga ao seu agente o que mostrar, qual tela usar e quando. Se quiser que use uma planilha de menu ou calendário de eventos, identifique a fonte e aprove apenas o acesso que deseja conceder.

4. 04

   Publique e verifique. Peça para o agente publicar, solicite uma captura de tela para verificar o resultado e confira a tela física você mesmo.

Já tem um código Player? Você pode combinar a solicitação:

Use screenrig.ai para minha tela do saguão. Meu código de pareamento é [code]. Crie um quadro de boas-vindas usando meu calendário de eventos. Pergunte-me qualquer outra coisa que precisar.

Se o aplicativo não puder instalar ou executar o plugin, uma resposta de chat sozinha não significa que a configuração está completa. Pergunte qual acesso ou capacidade está faltando. Você pode continuar com Claude Code ou ChatGPT Codex usando os comandos abaixo. Para problemas de convite ou pareamento, continue trabalhando com o mesmo agente e projeto em vez de se inscrever novamente.

Plugin, pacote global ou binário PATH?

Agentes usam o plugin oficial e seu launcher embutido. Não há pacote global para instalar. Executar o CLI embutido coloca o launcher do plugin em PATH para a sessão, então exemplos posteriores usam screenrig.

A instalação oficial

Instale o plugin oficial de github.com/screenrig/plugin. Ele inclui a skill e o CLI. Execute esses comandos no terminal, não dentro do agente, depois inicie o agente. Se já estiver rodando, reinicie para carregar o plugin.

Claude Code

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

Codex

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

Grok (Grok Build)

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

--trust é obrigatório no Grok Build.

CLI do skills

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

A CLI do skills adiciona a skill do screenRIG aos seus agentes. No primeiro uso, a skill instala o plugin oficial e a CLI incluída.

Execute o CLI incluído

Node.js 22.23.4+, 24.22.1+ ou 26.12.1+ (exceto 23.x e 25.x) é necessário. Resolva a raiz do plugin instalado, depois adicione o diretório de scripts do plugin ao PATH para esta sessão:

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 exemplo CLI posterior na sessão. O plugin instalado lida com a busca e detalhes da operação específicos do tempo de execução.

Já instalado

Peça ao seu agente para verificar o plugin instalado e continuar sua tarefa. A skill embutida gerencia verificações de versão e atualizações específicas do runtime. Se a versão publicada não puder ser verificada, pode continuar com a cópia instalada e avisar você.

Conecte seu agente à sua conta

Cadastrou-se no dashboard? Dê este prompt ao seu agente:

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.

Seu agente instala o plugin, executa screenrig login e mostra um código. Abra screenrig.ai/dashboard/connect, confira se o código corresponde, escolha o projeto e o acesso dele e aprove.

Acesso ao projeto

Em uma nova instalação, doctor pode relatar um aviso de token ausente e comandos com escopo de projeto falham com not_enrolled.

Seu agente pede seu e-mail de contato, usa o nome da organização já fornecido, ou usa Screens por padrão, e executa screenrig agent enroll --email ADDRESS --organization "Screens". A inscrição sempre cria um novo projeto, mesmo que seu e-mail já tenha um login, e envia um convite para membro do projeto. Adicione --intent advertising quando o propósito do projeto for comprar anúncios em vez de parear telas.

Quando você já tem screenRIG, seu agente executa screenrig login em vez disso. Ele imprime um endereço do dashboard e um código; você abre o endereço, verifica se o código corresponde, escolhe o projeto, Somente leitura, Propor ou Gerenciar, e aprova. O agente então trabalha nesse projeto, e seu login permanece vinculado aos projetos que você aprovou; mudar de projeto no dashboard não o move. Nunca cole credenciais em uma conversa. Como o login funciona.

Antes de parear ou comprar, screenrig project capabilities lê o que este projeto realmente pode fazer: o id do plano, as flags de recurso independentes advertiser e screens, e o conjunto de capacidades efetivas do servidor. As flags são independentes do plano, e uma negação de rota vence uma leitura desatualizada.

Um login pode pertencer a muitos projetos. Email e passkeys pertencem à pessoa, enquanto telas e mídias pertencem a um projeto. Cobrança e cotas pertencem ao plano da organização, um único pool compartilhado por todos os seus projetos. Use screenrig invitations create --email ADDRESS para convidar um membro do projeto. Convites por email expiram após sete dias. Links explícitos de membros de screenrig invitations create --link expiram após vinte e quatro horas. Eles são uma exceção para uma pessoa que nunca usou seu convite por email e depois pede acesso ao painel, nunca uma etapa de configuração, e são entregues diretamente à pessoa pretendida, nunca armazenados em notas ou registros. Uma nova pessoa usando um link de membro verifica seu email antes de criar uma passkey. Agentes criam, listam e revogam convites; apenas pessoas os aceitam.

screenrig dashboard abre o dashboard sem criar autoridade de login. Se não conseguir entrar, use o reset de login do dashboard ou screenrig dashboard reset-sign-in --email ADDRESS. O reset enviado por e-mail expira após uma hora e substitui suas credenciais de login, revogando outras sessões.

Quando a primeira execução falha

Sinalização, comprando ou vendendo?

Um login, muitos projetos; um plugin, CLI e painel. Inscrição sem --intent mantém o padrão de sinalização: o novo projeto pareia Players, cria playlists e publica.

Comprar não precisa de tela própria. screenrig agent enroll --intent advertising --email ADDRESS --organization "Screens" cria um projeto de compra: vincula criativos e executa campanhas, e não pode parear dispositivos nem publicar playlists. Aceitar o convite de um vendedor também pode habilitar publicidade em um projeto ao qual você pertence. Uma pessoa sem login cria um durante a aceitação, assim como um projeto apenas para anunciantes. Os recursos de anunciante e telas são independentes do plano de cobrança; screenrig project capabilities informa o conjunto efetivo.

O caminho do comprador começa com um convite, nunca um código de pareamento. Um vendedor envia screenrig invitations create --kind ad-buyer --email ADDRESS --screen-id scr_LOBBY; o humano convidado abre o e-mail e aceita no dashboard usando seu próprio login. Uma nova pessoa cria uma passkey; uma pessoa conectada confirma com uma prova de passkey fresca e seleciona seu projeto comprador. Após aceitação, o Marketplace do dashboard (/marketplace) lista todos os vendedores que o projeto ingressou; abrir um vendedor (/marketplace/SELLER_PROJECT_ID) mostra o inventário e taxas permitidos dessa associação. O Marketplace é só por convite: vendedores que o projeto não ingressou nunca aparecem. No CLI, agentes leem screenrig ads networks list e executam o fluxo da campanha: ads creatives create, ads campaigns preview, depois ads campaigns activate --quote-id. Um comprador gasta apenas o preço cotado por reprodução completa, liquidado em créditos no saldo compartilhado do projeto: o preço cotado é reservado contra créditos elegíveis quando uma reprodução é agendada e liquida apenas para uma reprodução completa. Não há cartão, fatura ou checkout envolvidos, e concessões incluídas e promocionais não podem financiar anúncios pagos; créditos comprados e ganhos por anúncio podem.

Vender continua sendo um projeto de sinalização com telas próprias. Opte por uma tela com screenrig ads inventory update scr_LOBBY --enabled, descreva-a publicamente e defina slots de anúncio reutilizáveis com screenrig ads slots create (mídia de imagem ou vídeo aceita, durações máximas, taxa opcional do slot). Colocar uma página de slot de anúncio em uma de suas playlists é o que transforma a definição do slot em um intervalo comercial. Você define a taxa do projeto por 15 segundos de reprodução completa com screenrig ads network rate, revisa os criativos do comprador com ads reviews e lê bruto e líquido com ads reports delivery. Uma alteração na taxa efetiva pausa todas as campanhas afetadas até que cada comprador aceite uma nova cotação.

Os negócios que você fecha por conta própria rodam como campanhas diretas nas suas próprias telas. screenrig ads direct create campaign.json informa o anunciante, uma categoria opcional, o período de veiculação, suas próprias imagens ou vídeos, um objetivo de exibições opcional e as telas e espaços que ela segmenta. Uma campanha direta preenche um intervalo comercial antes dos compradores convidados, e um objetivo é distribuído uniformemente ao longo da veiculação. Você mesmo fatura o anunciante: nenhum crédito é movimentado, e o preço registrado dá valor ao relatório. ads direct availability estima as exibições que você ainda pode reservar, uma categoria mantém concorrentes fora do mesmo intervalo, e ads direct report --format csv é o relatório de entrega para o seu anunciante. ads reports fill mostra como seus espaços publicitários foram preenchidos e por que os demais não foram.

Abra Convites no dashboard para convidar membros do projeto ou compradores de anúncios, ver o status do convite e cancelar convites pendentes. Vendedores também gerenciam o escopo de associação do comprador e revogam o acesso do comprador; a revogação interrompe novas reproduções de anúncios enquanto preserva o histórico financeiro.

Próximo

Abra o guia para Meta Muse, Grok Bot, ChatGPT dots, Claude Code, Hermes, ChatGPT Codex ou Gemini Spark, depois abra os Players, a referência CLI, Escolher um caminho de autoria ou as tarifas e taxas de publicidade.