Installieren Sie das offizielle screenRIG-Plugin

Meta Muse · Grok Bot · ChatGPT dots · Claude Code · Hermes · ChatGPT Codex · Gemini Spark · Installationsbefehle

Wie installiere ich screenRIG?

Fügen Sie dies in Ihren Agenten ein:

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

Dieser Satz autorisiert das offizielle Plugin von github.com/screenrig/plugin. Es bündelt die Fähigkeit und CLI, die Ihr Agent zur Steuerung von Bildschirmen verwendet. Terminal-Agenten können die Installationsbefehle direkt ausführen.

Beim ersten Start verwendet Ihr Agent Ihre Kontakt-E-Mail wieder und fragt nur, wenn sie fehlt. Er verwendet den bereits angegebenen Organisationsnamen oder standardmäßig Screens und führt screenrig agent enroll --email ADDRESS --organization NAME aus. Die Einschreibung erstellt Identität, Organisation, Screens-Projekt, Mitgliedschaft und Anmeldeinformationen und sendet Ihnen eine Einladung per E-Mail. Nichts wartet auf eine Person. Die Annahme der Einladung macht Sie zur verantwortlichen Person und Projektinhaber; eine verifizierte Domain kann das Projekt in die passende Organisation verschieben. Öffnen Sie es, um Ihr Login mit einer Passkey zu erstellen, oder melden Sie sich an, um das Projekt zu Ihrem bestehenden Login hinzuzufügen. Das Dashboard zeigt Ihre Projekte und ermöglicht den Wechsel zwischen ihnen. Für Digital Signage teilen Sie den Kopplungscode, den Ihr Player auf dem Bildschirm anzeigt.

Wählen Sie Ihren Agenten

Jeder Pfad installiert dasselbe offizielle Plugin; der Unterschied ist, wo Ihr Agent läuft. Jeder Leitfaden behandelt die App- oder Terminaleinrichtung dieses Agenten und verweist dann hierher für die gemeinsamen Projekt-, Player- und Veröffentlichungs-Schritte.

• Meta Muse ist Metas persönlicher KI-Agent auf Ihrem Telefon. Holen Sie sich die App, bitten Sie Muse, screenRIG zu installieren, und bleiben Sie im Gespräch, während es Ihr Projekt erstellt und Ihren Player koppelt.
• Grok Bot führt Ihren Bot in der Grok Bot-App aus. Holen Sie sich die App, bitten Sie Ihren Bot, screenRIG zu installieren, und behalten Sie den Kopplungscode und die Inhaltsanfrage im selben Gespräch. Grok Build ist der separate Terminal-Pfad.
• ChatGPT dots sind OpenAIs ständig aktive Agenten in ChatGPT, jeder mit seinem eigenen Cloud-Computer. Erstellen Sie Ihren Dot, bitten Sie ihn, screenRIG zu installieren, und arbeiten Sie dann mit demselben Dot in ChatGPT, Slack oder Microsoft Teams weiter.
• Claude Code ist Anthropics Terminal-Agent. Führen Sie die untenstehenden Marketplace-Befehle in Ihrem Terminal aus, starten Sie dann Claude Code und steuern Sie Bildschirme von Ihrem Rechner aus.
• Hermes ist Nous Researchs Agent. Bitten Sie ihn, die gebündelte Fähigkeit des offiziellen Plugins zu laden und die gebündelte CLI in der Umgebung auszuführen, in der Hermes arbeitet.
• ChatGPT Codex ist OpenAIs Codierungsagent. Führen Sie die untenstehenden Marketplace-Befehle in Ihrem Terminal aus und starten Sie dann Codex. Verwenden Sie in ChatGPT selbst ChatGPT dots.
• Gemini Spark ist Googles aufgabenbasierter Agent in der Gemini-App. Starten Sie eine Spark-Aufgabe, bitten Sie ihn, das offizielle Plugin zu installieren, und lassen Sie sich bestätigen, dass die gebündelte CLI in seiner Ausführungsumgebung läuft, bevor Sie sich darauf verlassen.
• Grok Build ist xAIs Terminal-Agent. Führen Sie die Grok Build-Befehle unten im Terminal aus und starten Sie dann Grok Build. Es gibt keinen separaten Leitfaden.

Verbinden Sie Ihren ersten Bildschirm

Das Projekt, der Player und die Veröffentlichungsschritte sind bei jedem Agenten gleich:

1. 01

   Ihr screenRIG-Projekt erstellen. Geben Sie Ihrem Agenten Ihre tatsächliche Kontakt-E-Mail und verwenden Sie den bereits angegebenen Organisationsnamen oder standardmäßig Screens. Die Registrierung erstellt das Projekt und sendet Ihre Einladung per E-Mail. Es wartet nichts darauf: Öffnen Sie das Dashboard jederzeit. Fügen Sie niemals Ihr Passwort, Einladungslink oder API-Tokens in die Konversation ein.

2. 02

   Player installieren und starten. Folgen Sie Player-Downloads & Einrichtung, um die Web-App auf dem Gerät zu installieren, das Ihren Bildschirm steuert, und starten Sie sie dann. Senden Sie den dort angezeigten Kopplungscode an Ihren Agenten.

3. 03

   Ergebnis beschreiben. Sagen Sie Ihrem Agenten, was gezeigt werden soll, welchen Bildschirm er verwenden soll und wann. Wenn Sie möchten, dass er eine Menü-Tabelle oder einen Veranstaltungskalender nutzt, benennen Sie die Quelle und genehmigen Sie nur den Zugriff, den Sie erlauben wollen.

4. 04

   Veröffentlichen und prüfen. Bitten Sie den Agenten zu veröffentlichen, fordern Sie einen Screenshot an, um das Ergebnis zu überprüfen, und kontrollieren Sie den physischen Bildschirm selbst.

Haben Sie bereits einen Player-Code? Sie können die Anfrage kombinieren:

Verwenden Sie screenrig.ai für meinen Lobby-Bildschirm. Mein Kopplungscode ist [code]. Erstellen Sie eine Willkommensanzeige mit meinem Veranstaltungskalender. Fragen Sie mich nach allem, was Sie sonst noch benötigen.

Wenn die App das Plugin nicht installieren oder ausführen kann, bedeutet eine Chat-Antwort allein nicht, dass die Einrichtung abgeschlossen ist. Fragen Sie, welcher Zugriff oder welche Berechtigung fehlt. Sie können mit Claude Code oder ChatGPT Codex mit den untenstehenden Befehlen fortfahren. Bei Einladungs- oder Kopplungsproblemen arbeiten Sie weiter mit demselben Agenten und Projekt, anstatt sich erneut anzumelden.

Plugin, globales Paket oder PATH-Binärdatei?

Agenten verwenden das offizielle Plugin und dessen gebündelten Launcher. Es gibt kein globales Paket zum Installieren. Führen Sie die gebündelte CLI aus, die den Plugin-Launcher für die Sitzung auf PATH legt, sodass spätere Beispiele screenrig verwenden.

Die offizielle Installation

Installieren Sie das offizielle Plugin von github.com/screenrig/plugin. Es enthält die Skill und CLI. Führen Sie diese Befehle im Terminal aus, nicht im Agenten, und starten Sie dann den Agenten. Wenn er bereits lief, starten Sie ihn neu, damit das Plugin geladen wird.

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 ist bei Grok Build erforderlich.

skills-CLI

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

Die skills-CLI fügt Ihren Agenten den screenRIG-Skill hinzu. Bei der ersten Nutzung installiert der Skill das offizielle Plugin und die mitgelieferte CLI.

Führen Sie die gebündelte CLI aus

Node.js 22.23.4+, 24.22.1+ oder 26.12.1+ (außer 23.x und 25.x) ist erforderlich. Ermitteln Sie das installierte Plugin-Stammverzeichnis und fügen Sie dann das Plugin-Skripte-Verzeichnis für diese Sitzung vor PATH ein:

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

Verwenden Sie screenrig für jedes spätere CLI-Beispiel in der Sitzung. Das installierte Plugin-Skill übernimmt die laufzeitspezifische Suche und Details der Operation.

Bereits installiert

Bitten Sie Ihren Agenten, das installierte Plugin zu überprüfen und Ihre Aufgabe fortzusetzen. Die gebündelte Fähigkeit übernimmt Versionsprüfungen und laufzeitspezifische Updates. Wenn die veröffentlichte Version nicht geprüft werden kann, kann sie mit der installierten Kopie fortfahren und Sie informieren.

Agent mit Ihrem Konto verbinden

Im Dashboard registriert? Geben Sie Ihrem Agent diese Aufforderung:

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.

Ihr Agent installiert das Plugin, führt screenrig login aus und zeigt einen Code an. Öffnen Sie screenrig.ai/dashboard/connect, prüfen Sie, dass der Code übereinstimmt, wählen Sie das Projekt und seinen Zugriff und bestätigen Sie.

Projektzugriff

Bei einer Neuinstallation kann doctor eine Warnung wegen fehlendem Token melden und projektbezogene Befehle schlagen mit not_enrolled fehl.

Ihr Agent fragt nach Ihrer Kontakt-E-Mail, verwendet den bereits angegebenen Organisationsnamen oder standardmäßig Screens und führt screenrig agent enroll --email ADDRESS --organization "Screens" aus. Die Anmeldung erstellt immer ein neues Projekt, auch wenn Ihre E-Mail bereits einen Login hat, und sendet eine Einladung an Projektmitglieder. Fügen Sie --intent advertising hinzu, wenn der Zweck des Projekts der Kauf von Werbung statt der Kopplung von Bildschirmen ist.

Wenn Sie bereits screenRIG haben, führt Ihr Agent stattdessen screenrig login aus. Er gibt eine Dashboard-Adresse und einen Code aus; Sie öffnen die Adresse, prüfen, ob der Code übereinstimmt, wählen das Projekt, Nur lesen, Vorschlagen oder Verwalten und genehmigen. Der Agent arbeitet dann in diesem Projekt, und seine Anmeldung bleibt an die von Ihnen genehmigten Projekte gebunden; ein Wechsel der Projekte im Dashboard verschiebt sie nicht. Fügen Sie niemals Anmeldedaten in eine Unterhaltung ein. Wie die Anmeldung funktioniert.

Vor dem Koppeln oder Kauf liest screenrig project capabilities was dieses Projekt tatsächlich kann: die Plan-ID, die unabhängigen advertiser und screens Feature-Flags und die effektiven Fähigkeiten des Servers. Die Flags sind unabhängig vom Plan, und eine Routenverweigerung hat Vorrang vor einer veralteten Lesung.

Ein Login kann zu vielen Projekten gehören. E-Mail und Passkeys gehören zur Person, während Bildschirme und Medien zu einem Projekt gehören. Abrechnung und Kontingente gehören zum Plan der Organisation, einem gemeinsamen Pool für alle ihre Projekte. Verwenden Sie screenrig invitations create --email ADDRESS, um ein Projektmitglied einzuladen. E-Mail-Einladungen verfallen nach sieben Tagen. Explizite Mitgliederlinks von screenrig invitations create --link verfallen nach vierundzwanzig Stunden. Sie sind eine Ausnahme für eine Person, die ihre per E-Mail gesendete Einladung nie genutzt hat und später Dashboard-Zugang anfragt, niemals ein Einrichtungsschritt, und werden direkt an die vorgesehene Person übergeben, nie in Notizen oder Protokollen gespeichert. Eine neue Person, die einen Mitgliederlink verwendet, verifiziert ihre E-Mail, bevor sie einen Passkey erstellt. Agenten erstellen, listen und widerrufen Einladungen; nur Personen akzeptieren sie.

screenrig dashboard öffnet das Dashboard, ohne eine Anmeldeberechtigung zu erstellen. Wenn Sie sich nicht anmelden können, verwenden Sie die Anmeldezurücksetzung des Dashboards oder screenrig dashboard reset-sign-in --email ADDRESS. Die per E-Mail gesendete Zurücksetzung läuft nach einer Stunde ab und ersetzt Ihre Anmeldeinformationen, wodurch andere Sitzungen widerrufen werden.

Wenn der erste Versuch fehlschlägt

Beschilderung, kaufen oder verkaufen?

Ein Login, viele Projekte; ein Plugin, CLI und Dashboard. Anmeldung ohne --intent behält den Signage-Standard: Das neue Projekt verbindet Player, erstellt Playlists und veröffentlicht.

Kaufen benötigt keinen eigenen Bildschirm. screenrig agent enroll --intent advertising --email ADDRESS --organization "Screens" erstellt ein Kaufprojekt: es bindet Werbemittel und führt Kampagnen aus, kann aber keine Geräte koppeln oder Playlists veröffentlichen. Die Annahme einer Einladung eines Verkäufers kann auch Werbung in einem Projekt ermöglichen, dem Sie angehören. Eine Person ohne Login erstellt während der Annahme ein solches und ein reines Werbetreibenden-Projekt. Die Feature-Flags für Werbetreibende und Bildschirme sind unabhängig vom Abrechnungsplan; screenrig project capabilities berichtet die effektive Einstellung.

Der Käuferpfad beginnt mit einer Einladung, niemals mit einem Kopplungscode. Ein Verkäufer sendet screenrig invitations create --kind ad-buyer --email ADDRESS --screen-id scr_LOBBY; der eingeladene Mensch öffnet die E-Mail und akzeptiert im Dashboard mit seinem eigenen Login. Eine neue Person erstellt einen Passkey; eine angemeldete Person bestätigt mit einem frischen Passkey-Nachweis und wählt ihr Kaufprojekt. Nach der Annahme listet der Marketplace des Dashboards (/marketplace) jeden Verkäufer, dem das Projekt beigetreten ist; das Öffnen eines Verkäufers (/marketplace/SELLER_PROJECT_ID) zeigt den erlaubten Bestand und die Preise dieser Mitgliedschaft. Der Marketplace ist nur auf Einladung zugänglich: Verkäufer, denen das Projekt nicht beigetreten ist, erscheinen nie. Im CLI lesen Agenten screenrig ads networks list und führen den Kampagnen-Workflow aus: ads creatives create, ads campaigns preview, dann ads campaigns activate --quote-id. Ein Käufer gibt nur den angegebenen Preis für abgeschlossene Wiedergaben aus, abgerechnet in Credits auf dem gemeinsamen Kontostand des Projekts: Der angegebene Preis wird bei der Planung einer Wiedergabe gegen berechtigte Credits reserviert und nur für eine abgeschlossene Wiedergabe abgerechnet. Keine Karte, Rechnung oder Kasse ist beteiligt, und enthaltene sowie Werbegutschriften können keine bezahlten Anzeigen finanzieren; gekaufte und werbeverdiente Credits können dies.

Verkauf bleibt ein Signage-Projekt mit eigenen Bildschirmen. Einen Bildschirm mit screenrig ads inventory update scr_LOBBY --enabled auswählen, öffentlich beschreiben und wiederverwendbare Werbeplätze mit screenrig ads slots create definieren (akzeptierte Bild- oder Videoinhalte, längste Dauer, optionaler Platzpreis). Das Einfügen einer Werbeplatzseite in eine Ihrer Playlists verwandelt die Platzdefinition in eine Werbepause. Den Projektpreis pro 15 Sekunden abgeschlossener Wiedergabe legen Sie mit screenrig ads network rate fest, Käufer-Kreativen mit ads reviews prüfen und Brutto und Netto mit ads reports delivery lesen. Ein geänderter effektiver Preis pausiert jede betroffene Kampagne, bis jeder Käufer ein neues Angebot akzeptiert.

Geschäfte, die Sie selbst abschließen, laufen als Direktkampagnen auf Ihren eigenen Bildschirmen. screenrig ads direct create campaign.json nennt den Werbetreibenden, eine optionale Kategorie, die Laufzeit, Ihre eigenen Bilder oder Videos, ein optionales Wiedergabeziel sowie die Bildschirme und Werbeplätze, auf die sie ausgerichtet ist. Eine Direktkampagne füllt einen Werbeblock vor eingeladenen Käufern, und ein Ziel wird gleichmäßig über die Laufzeit verteilt. Sie stellen dem Werbetreibenden selbst in Rechnung: Es werden keine Credits bewegt, und der erfasste Preis bewertet den Bericht. ads direct availability schätzt die Wiedergaben, die Sie noch buchen können, eine Kategorie hält Wettbewerber aus demselben Werbeblock heraus, und ads direct report --format csv ist der Zustellungsbericht für Ihren Werbetreibenden. ads reports fill zeigt, wie Ihre Werbeplätze gefüllt wurden und warum die übrigen leer blieben.

Öffnen Sie Einladungen im Dashboard, um Projektmitglieder oder Werbekäufer einzuladen, den Einladungsstatus zu sehen und ausstehende Einladungen zu stornieren. Verkäufer verwalten auch den Mitgliedschaftsumfang der Käufer und widerrufen den Käuferzugang; der Widerruf stoppt neue Werbeeinblendungen und bewahrt die finanzielle Historie.

Weiter

Öffnen Sie die Anleitung für Meta Muse, Grok Bot, ChatGPT dots, Claude Code, Hermes, ChatGPT Codex oder Gemini Spark und öffnen Sie dann die Player, die CLI-Referenz, wählen Sie einen Erstellungsweg oder die Werbepreise und Gebühren.