Installez le plugin officiel screenRIG

Meta Muse · Grok Bot · ChatGPT dots · Claude Code · Hermes · ChatGPT Codex · Gemini Spark · Commandes d’installation

Comment installer screenRIG ?

Collez ceci dans votre agent :

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

Cette phrase autorise le plugin officiel de github.com/screenrig/plugin. Il regroupe la compétence et le CLI que votre agent utilise pour gérer les écrans. Les agents en terminal peuvent exécuter directement les commandes d’installation.

Lors de la première exécution, votre agent réutilise votre courriel de contact, ne le demandant que s’il manque. Il utilise le nom de l’organisation que vous avez déjà fourni, ou par défaut Screens, et exécute screenrig agent enroll --email ADDRESS --organization NAME. L’inscription crée l’identité, l’organisation, le projet Screens, l’adhésion et les identifiants, et vous envoie une invitation par courriel. Rien ne dépend d’une personne. Accepter l’invitation fait de vous la personne responsable et le propriétaire du projet ; un domaine vérifié peut déplacer le projet dans l’organisation correspondante. Ouvrez-le pour créer votre connexion avec une clé d’accès, ou connectez-vous pour ajouter le projet à votre connexion existante. Le tableau de bord affiche vos projets et vous permet de passer de l’un à l’autre. Pour la signalisation, partagez le code de jumelage que votre Player affiche à l’écran.

Choisissez votre agent

Chaque chemin installe le même plugin officiel ; la différence est l’endroit où votre agent s’exécute. Chaque guide couvre la configuration de l’app ou du terminal de cet agent, puis renvoie ici pour les étapes partagées du projet, du Player et de la publication.

• Meta Muse est l’agent IA personnel de Meta sur votre téléphone. Obtenez l’application, demandez à Muse d’installer screenRIG, puis restez dans la conversation pendant qu’il crée votre projet et jumelle votre lecteur.
• Grok Bot exécute votre bot dans l’application Grok Bot. Obtenez l’application, demandez à votre bot d’installer screenRIG, puis conservez le code de jumelage et la demande de contenu dans la même conversation. Grok Build est le chemin terminal séparé.
• ChatGPT dots sont les agents toujours actifs d’OpenAI dans ChatGPT, chacun avec son propre ordinateur cloud. Créez votre dot, demandez-lui d’installer screenRIG, puis continuez à travailler avec le même dot dans ChatGPT, Slack ou Microsoft Teams.
• Claude Code est l’agent terminal d’Anthropic. Exécutez les commandes du marketplace ci-dessous dans votre terminal, puis lancez Claude Code et pilotez les écrans depuis votre machine.
• Hermes est l’agent de Nous Research. Demandez-lui de charger la compétence du plugin officiel et d’exécuter le CLI inclus dans l’environnement où Hermes fonctionne.
• ChatGPT Codex est l’agent de codage d’OpenAI. Exécutez les commandes du marketplace ci-dessous dans votre terminal, puis lancez Codex. Dans ChatGPT lui-même, utilisez ChatGPT dots.
• Gemini Spark est l’agent basé sur les tâches de Google dans l’application Gemini. Lancez une tâche Spark, demandez-lui d’installer le plugin officiel, et faites-lui prouver que le CLI inclus fonctionne dans son environnement d’exécution avant de vous y fier.
• Grok Build est l’agent terminal de xAI. Exécutez les commandes Grok Build ci-dessous dans votre terminal, puis lancez Grok Build. Il n’a pas de guide séparé.

Connectez votre premier écran

Le projet, le Lecteur et les étapes de publication sont les mêmes dans chaque agent :

1. 01

   Créer votre projet screenRIG. Donnez à votre agent votre courriel de contact réel et utilisez le nom d’organisation déjà fourni, ou par défaut Screens. L’inscription crée le projet et envoie votre invitation par courriel. Rien ne dépend de cela : ouvrez-le quand vous voulez le tableau de bord. Ne collez jamais votre mot de passe, lien d’invitation ou jetons API dans la conversation.

2. 02

   Installer et lancer votre lecteur. Suivez Téléchargements et configuration du lecteur pour installer l’application Web sur l’appareil qui pilote votre écran, puis lancez-la. Envoyez le code de jumelage affiché à votre agent.

3. 03

   Décrire le résultat. Dites à votre agent quoi afficher, quel écran utiliser et quand. Si vous voulez qu’il utilise une feuille de calcul de menu ou un calendrier d’événements, identifiez la source et approuvez seulement l’accès que vous voulez lui accorder.

4. 04

   Publiez et vérifiez. Demandez à l’agent de publier, demandez une capture d’écran pour vérifier le résultat, puis vérifiez vous-même l’écran physique.

Vous avez déjà un code Player ? Vous pouvez combiner la demande :

Utilisez screenrig.ai pour mon écran d’accueil. Mon code de jumelage est [code]. Créez un tableau de bienvenue avec mon calendrier d’événements. Demandez-moi tout ce dont vous avez besoin.

Si l’application ne peut pas installer ou exécuter le plugin, une réponse de clavardage seule ne signifie pas que la configuration est terminée. Demandez quel accès ou quelle capacité manque. Vous pouvez continuer avec Claude Code ou ChatGPT Codex en utilisant les commandes ci-dessous. Pour les problèmes d’invitation ou de jumelage, continuez avec le même agent et projet plutôt que de vous inscrire à nouveau.

Plugin, paquet global ou binaire PATH ?

Les agents utilisent le plugin officiel et son lanceur intégré. Il n’y a pas de paquet global à installer. Exécuter le CLI intégré place le lanceur de plugin sur PATH pour la session, ainsi les exemples suivants utilisent screenrig.

L’installation officielle

Installez le plugin officiel depuis github.com/screenrig/plugin. Il inclut la compétence et la CLI. Exécutez ces commandes dans votre terminal, pas dans l’agent, puis démarrez l’agent. S’il était déjà en marche, redémarrez-le pour qu’il charge le 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 est requis sur Grok Build.

CLI skills

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

La CLI skills ajoute la compétence screenRIG à vos agents. À la première utilisation, la compétence installe le plugin officiel et sa CLI intégrée.

Exécuter le CLI intégré

Node.js 22.23.4+, 24.22.1+ ou 26.12.1+ (sauf 23.x et 25.x) est requis. Résoudre la racine du plugin installé, puis préfixer le répertoire des scripts du plugin à PATH pour cette session :

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

Utilisez screenrig pour chaque exemple CLI ultérieur dans la session. Le plugin installé gère la recherche et les détails d’opération spécifiques à l’exécution.

Déjà installé

Demander à votre agent de vérifier le plugin installé et de poursuivre votre tâche. La compétence intégrée gère les vérifications de version et les mises à jour spécifiques au runtime. Si la version publiée ne peut être vérifiée, il peut continuer avec la copie installée et vous en informer.

Connecter votre agent à votre compte

Inscrit dans le tableau de bord? Donnez cette invite à votre agent :

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.

Votre agent installe le plugiciel, exécute screenrig login et affiche un code. Ouvrez screenrig.ai/dashboard/connect, vérifiez que le code correspond, choisissez le projet et son accès, puis approuvez.

Accès au projet

Sur une nouvelle installation, doctor peut signaler un avertissement de jeton manquant et les commandes à l’échelle du projet échouent avec not_enrolled.

Votre agent demande votre courriel de contact, utilise le nom de l’organisation déjà fourni, ou par défaut Screens, et exécute screenrig agent enroll --email ADDRESS --organization "Screens". L’inscription crée toujours un nouveau projet, même si votre courriel a déjà une connexion, et envoie un courriel d’invitation aux membres du projet. Ajoutez --intent advertising lorsque le but du projet est d’acheter des publicités plutôt que de jumeler des écrans.

Lorsque vous avez déjà screenRIG, votre agent exécute screenrig login à la place. Il affiche une adresse de tableau de bord et un code ; vous ouvrez l’adresse, vérifiez que le code correspond, choisissez le projet, Lecture seule, Proposer ou Gérer, et approuvez. L’agent travaille alors dans ce projet, et sa connexion reste liée aux projets que vous avez approuvés ; changer de projet dans le tableau de bord ne le déplace pas. Ne collez jamais vos identifiants dans une conversation. Comment fonctionne la connexion.

Avant le jumelage ou l’achat, screenrig project capabilities lit ce que ce projet peut réellement faire : l’identifiant du forfait, les indicateurs de fonctionnalités indépendants advertiser et screens, et l’ensemble des capacités effectives du serveur. Les indicateurs sont indépendants du forfait, et un refus de route l’emporte sur une lecture périmée.

Un login peut appartenir à plusieurs projets. Le courriel et les passkeys appartiennent à la personne, tandis que les écrans et les médias appartiennent à un projet. La facturation et les allocations appartiennent au forfait de l’organisation, un pool partagé entre tous ses projets. Utilisez screenrig invitations create --email ADDRESS pour inviter un membre de projet. Les invitations par courriel expirent après sept jours. Les liens membres explicites de screenrig invitations create --link expirent après vingt-quatre heures. Ils sont une exception pour une personne n’ayant jamais utilisé son invitation par courriel et demandant plus tard l’accès au tableau de bord, jamais une étape de configuration, et sont remis directement à la personne visée, jamais stockés dans les notes ou journaux. Une nouvelle personne utilisant un lien membre vérifie son courriel avant de créer un passkey. Les agents créent, listent et révoquent les invitations ; seules les personnes les acceptent.

screenrig dashboard ouvre le tableau de bord sans créer d’autorité de connexion. Si vous ne pouvez pas vous connecter, utilisez la réinitialisation de connexion du tableau de bord ou screenrig dashboard reset-sign-in --email ADDRESS. La réinitialisation envoyée par courriel expire après une heure et remplace vos identifiants de connexion, révoquant les autres sessions.

Lors de la première exécution échouée

Affichage, achat ou vente ?

Un login, plusieurs projets ; un plugin, CLI et tableau de bord. L’inscription sans --intent conserve la signalisation par défaut : le nouveau projet jumelle les Players, crée des listes de lecture et publie.

L’achat ne nécessite aucun écran possédé. screenrig agent enroll --intent advertising --email ADDRESS --organization "Screens" crée un projet d’achat : il lie des créations et lance des campagnes, et il ne peut pas jumeler d’appareils ni publier de listes de lecture. Accepter une invitation de vendeur peut aussi permettre la publicité sur un projet auquel vous appartenez. Une personne sans connexion en crée une et un projet réservé aux annonceurs lors de l’acceptation. Les fonctionnalités annonceur et écrans sont indépendantes du forfait de facturation ; screenrig project capabilities rapporte l’ensemble effectif.

Le chemin acheteur commence par une invitation, jamais un code de jumelage. Un vendeur envoie screenrig invitations create --kind ad-buyer --email ADDRESS --screen-id scr_LOBBY ; l’humain invité ouvre le courriel et accepte dans le tableau de bord avec sa propre connexion. Une nouvelle personne crée une clé d’accès ; une personne connectée confirme avec une preuve fraîche de clé d’accès et sélectionne son projet d’achat. Après acceptation, le Marketplace du tableau de bord (/marketplace) liste chaque vendeur que le projet a rejoint ; ouvrir un vendeur (/marketplace/SELLER_PROJECT_ID) montre l’inventaire et les tarifs autorisés de cette adhésion. Le Marketplace est sur invitation uniquement : les vendeurs que le projet n’a pas rejoints n’apparaissent jamais. Dans le CLI, les agents lisent screenrig ads networks list et exécutent le flux de campagne : ads creatives create, ads campaigns preview, puis ads campaigns activate --quote-id. Un acheteur ne dépense que le prix de lecture complète indiqué, réglé en crédits sur le solde partagé du projet : le prix indiqué est retenu contre les crédits éligibles lors de la programmation d’une lecture et ne se règle qu’à la lecture complète. Aucune carte, facture ou paiement n’est impliqué, et les subventions incluses et promotionnelles ne peuvent financer les publicités payantes ; les crédits achetés et gagnés par publicité le peuvent.

La vente reste un projet de signalisation avec des écrans possédés. Optez pour un écran avec screenrig ads inventory update scr_LOBBY --enabled, décrivez-le publiquement, et définissez des emplacements publicitaires réutilisables avec screenrig ads slots create (médias image ou vidéo acceptés, durées maximales, tarif optionnel par emplacement). Placer une page d’emplacement publicitaire dans une de vos listes de lecture transforme la définition d’emplacement en pause publicitaire. Vous fixez le tarif du projet par tranche de 15 secondes de lecture complète avec screenrig ads network rate, examinez les créations des acheteurs avec ads reviews, et consultez le brut et le net avec ads reports delivery. Un changement de tarif effectif met en pause chaque campagne affectée jusqu’à ce que chaque acheteur accepte un nouveau devis.

Les ententes que vous concluez vous-même s’exécutent comme campagnes directes sur vos propres écrans. screenrig ads direct create campaign.json indique l’annonceur, une catégorie facultative, la période de diffusion, vos propres images ou vidéos, un objectif de diffusions facultatif ainsi que les écrans et emplacements ciblés. Une campagne directe remplit une pause publicitaire avant les acheteurs invités, et un objectif est réparti uniformément sur sa période de diffusion. Vous facturez vous-même l’annonceur : aucun crédit n’est déplacé, et le prix enregistré valorise le rapport. ads direct availability estime les diffusions que vous pouvez encore réserver, une catégorie tient les concurrents hors de la même pause, et ads direct report --format csv est le rapport de livraison pour votre annonceur. ads reports fill montre comment vos emplacements publicitaires ont été remplis et pourquoi les autres ne l’ont pas été.

Ouvrez Invitations dans le tableau de bord pour inviter des membres de projet ou des acheteurs publicitaires, voir le statut des invitations et annuler les invitations en attente. Les vendeurs gèrent aussi la portée d’adhésion des acheteurs et révoquent l’accès des acheteurs ; la révocation arrête les nouvelles diffusions publicitaires tout en conservant l’historique financier.

Suivant

Ouvrez le guide pour Meta Muse, Grok Bot, ChatGPT dots, Claude Code, Hermes, ChatGPT Codex ou Gemini Spark, puis ouvrez les Players, la référence CLI, Choisir une voie de création ou les tarifs et frais publicitaires.