Installa il plugin ufficiale screenRIG

Meta Muse · Grok Bot · ChatGPT dots · Claude Code · Hermes · ChatGPT Codex · Gemini Spark · Comandi di installazione

Come si installa screenRIG?

Incolla questo nel tuo agente:

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

Quella frase autorizza il plugin ufficiale da github.com/screenrig/plugin. Include la skill e la CLI che il tuo agente usa per gestire gli schermi. Gli agenti terminali possono eseguire direttamente i comandi di installazione.

Al primo avvio il tuo agente riusa la tua email di contatto, chiedendo solo se manca. Usa il nome organizzazione già fornito, o di default Screens, ed esegue screenrig agent enroll --email ADDRESS --organization NAME. L’iscrizione crea identità, organizzazione, progetto Screens, membership e credenziali, e ti invia un invito via email. Nessuna attesa su una persona. Accettare l’invito ti rende persona responsabile e proprietario del progetto; un dominio verificato può spostare il progetto nell’organizzazione corrispondente. Aprilo per creare il login con passkey, o accedi per aggiungere il progetto al login esistente. Il dashboard mostra i tuoi progetti e permette di passare da uno all’altro. Per la segnaletica, condividi il codice di associazione che il tuo Player mostra sul vetro.

Scegli il tuo agente

Ogni percorso installa lo stesso plugin ufficiale; la differenza è dove gira il tuo agente. Ogni guida copre la configurazione dell’app o terminale di quell’agente, poi rimanda qui per progetto, Player e passaggi di pubblicazione condivisi.

• Meta Muse è l’agente AI personale di Meta sul tuo telefono. Ottieni l’app, chiedi a Muse di installare screenRIG, poi resta nella conversazione mentre crea il tuo progetto e associa il tuo lettore.
• Grok Bot esegue il tuo bot nell’app Grok Bot. Ottieni l’app, chiedi al tuo bot di installare screenRIG, poi conserva il codice di associazione e la richiesta di contenuti nella stessa conversazione. Grok Build è il percorso terminale separato.
• ChatGPT dots sono gli agenti sempre attivi di OpenAI in ChatGPT, ognuno con il proprio computer cloud. Crea il tuo dot, chiedigli di installare screenRIG, poi continua a lavorare con lo stesso dot in ChatGPT, Slack o Microsoft Teams.
• Claude Code è l’agente terminale di Anthropic. Esegui i comandi marketplace qui sotto nel terminale, poi avvia Claude Code e controlla gli schermi dalla tua macchina.
• Hermes è l’agente di Nous Research. Chiedigli di caricare la skill del plugin ufficiale e di eseguire il CLI incluso nell’ambiente in cui Hermes opera.
• ChatGPT Codex è l’agente di codifica di OpenAI. Esegui i comandi marketplace qui sotto nel terminale, poi avvia Codex. In ChatGPT stesso, usa ChatGPT dots.
• Gemini Spark è l’agente basato su attività di Google dentro l’app Gemini. Avvia un’attività Spark, chiedi di installare il plugin ufficiale e fagli dimostrare che il CLI incluso funziona nel suo ambiente di esecuzione prima di affidarti a lui.
• Grok Build è l’agente terminale di xAI. Esegui i comandi Grok Build nel terminale, poi avvia Grok Build. Non ha una guida separata.

Connetti il tuo primo schermo

Il progetto, il Player e i passaggi di pubblicazione sono gli stessi in ogni agente:

1. 01

   Crea il tuo progetto screenRIG. Fornisci al tuo agente la tua email di contatto reale e usa il nome dell’organizzazione già fornito, o predefinito a Screens. L’iscrizione crea il progetto e invia via email il tuo invito. Non si aspetta nulla: aprilo quando vuoi la dashboard. Non incollare mai password, link di invito o token API nella conversazione.

2. 02

   Installa e avvia il tuo lettore. Segui Download e configurazione del lettore per installare l’app web sul dispositivo che gestisce il tuo schermo, poi avviala. Invia il codice di associazione mostrato lì al tuo agente.

3. 03

   Descrivi il risultato. Dì al tuo agente cosa mostrare, quale schermo usare e quando. Se vuoi che usi un foglio menu o un calendario eventi, identifica la fonte e approva solo l’accesso che vuoi concedere.

4. 04

   Pubblica e verifica. Chiedi all’agente di pubblicare, richiedi uno screenshot per verificare il risultato e controlla personalmente lo schermo fisico.

Hai già un codice Player? Puoi combinare la richiesta:

Usa screenrig.ai per il mio schermo lobby. Il mio codice di associazione è [code]. Crea una bacheca di benvenuto usando il mio calendario eventi. Chiedimi tutto il resto che ti serve.

Se l’app non può installare o eseguire il plugin, una risposta chat da sola non significa che la configurazione sia completa. Chiedi quale accesso o capacità manca. Puoi continuare con Claude Code o ChatGPT Codex usando i comandi qui sotto. Per problemi di invito o associazione, continua a lavorare con lo stesso agente e progetto invece di iscriverti di nuovo.

Plugin, pacchetto globale o binario PATH?

Gli agenti usano il plugin ufficiale e il suo launcher incluso. Non esiste un pacchetto globale da installare. Esegui la CLI inclusa mette il launcher del plugin su PATH per la sessione, così gli esempi successivi usano screenrig.

L’installazione ufficiale

Installa il plugin ufficiale da github.com/screenrig/plugin. Include la skill e la CLI. Esegui questi comandi nel terminale, non dentro l’agente, poi avvia l’agente. Se era già in esecuzione, riavvialo per caricare il 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 è obbligatorio su Grok Build.

CLI skills

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

La CLI skills aggiunge la skill screenRIG ai tuoi agenti. Al primo utilizzo la skill installa il plugin ufficiale e la sua CLI inclusa.

Esegui la CLI inclusa

Node.js 22.23.4+, 24.22.1+ o 26.12.1+ (escluse 23.x e 25.x) è richiesto. Risolvi la radice del plugin installato, poi aggiungi la directory degli script del plugin a PATH per questa sessione:

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

Usa screenrig per ogni esempio CLI successivo nella sessione. Il plugin installato gestisce i dettagli specifici del runtime per ricerca e operazioni.

Già installato

Chiedi al tuo agente di controllare il plugin installato e continuare il compito. La skill inclusa gestisce i controlli di versione e gli aggiornamenti specifici del runtime. Se la versione pubblicata non può essere verificata, può continuare con la copia installata e informarti.

Collega il tuo agente al tuo account

Ti sei registrato nella dashboard? Dai al tuo agente questo prompt:

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.

Il tuo agente installa il plugin, esegue screenrig login e mostra un codice. Apri screenrig.ai/dashboard/connect, controlla che il codice corrisponda, scegli il progetto e il suo accesso e approva.

Accesso progetto

Su una nuova installazione, doctor può segnalare un avviso token mancante e i comandi con ambito progetto falliscono con not_enrolled.

Il tuo agente chiede la tua email di contatto, usa il nome dell’organizzazione già fornito o predefinisce Screens, e esegue screenrig agent enroll --email ADDRESS --organization "Screens". L’iscrizione crea sempre un nuovo progetto, anche se la tua email ha già un login, e invia un invito ai membri del progetto. Aggiungi --intent advertising quando lo scopo del progetto è comprare annunci anziché associare schermi.

Quando hai già screenRIG, il tuo agente esegue screenrig login invece. Stampa un indirizzo dashboard e un codice; apri l’indirizzo, verifica che il codice corrisponda, scegli il progetto, Solo lettura, Proponi o Gestisci, e approva. L’agente lavora quindi in quel progetto e il suo accesso resta vincolato ai progetti approvati; cambiare progetto nel dashboard non lo sposta. Non incollare mai credenziali in una conversazione. Come funziona l’accesso.

Prima di associare o acquistare, screenrig project capabilities legge cosa può effettivamente fare questo progetto: l’id piano, le flag funzionalità indipendenti advertiser e screens, e il set di capacità effettive del server. Le flag sono indipendenti dal piano, e un rifiuto di percorso prevale su una lettura obsoleta.

Un login può appartenere a molti progetti. Email e passkey appartengono alla persona, mentre schermi e media appartengono a un progetto. Fatturazione e quote appartengono al piano dell’organizzazione, un unico pool condiviso per tutti i suoi progetti. Usa screenrig invitations create --email ADDRESS per invitare un membro del progetto. Gli inviti via email scadono dopo sette giorni. I link espliciti per membri da screenrig invitations create --link scadono dopo ventiquattro ore. Sono un’eccezione per una persona che non ha mai usato il suo invito via email e poi chiede accesso al dashboard, mai un passaggio di configurazione, e sono consegnati direttamente alla persona prevista, mai memorizzati in note o log. Una nuova persona che usa un link membro verifica la sua email prima di creare una passkey. Gli agenti creano, elencano e revocano inviti; solo le persone li accettano.

screenrig dashboard apre il dashboard senza creare autorizzazioni di accesso. Se non puoi accedere, usa il reset accesso del dashboard o screenrig dashboard reset-sign-in --email ADDRESS. Il reset inviato via email scade dopo un’ora e sostituisce le credenziali di accesso, revocando altre sessioni.

Quando il primo avvio fallisce

Segnaletica, acquisto o vendita?

Un login, molti progetti; un plugin, CLI e dashboard. L’iscrizione senza --intent mantiene il default della segnaletica: il nuovo progetto associa Player, crea playlist e pubblica.

L’acquisto non richiede uno schermo di proprietà. screenrig agent enroll --intent advertising --email ADDRESS --organization "Screens" crea un progetto di acquisto: associa creatività e gestisce campagne, senza poter associare dispositivi o pubblicare playlist. Accettare un invito da venditore può anche abilitare la pubblicità su un progetto di cui si fa parte. Una persona senza accesso crea un account e un progetto solo per inserzionisti durante l’accettazione. Le funzionalità inserzionista e schermi sono indipendenti dal piano di fatturazione; screenrig project capabilities riporta l’insieme effettivo.

Il percorso acquirente inizia con un invito, mai un codice di associazione. Un venditore invia screenrig invitations create --kind ad-buyer --email ADDRESS --screen-id scr_LOBBY; l’umano invitato apre l’email e accetta nella dashboard usando il proprio accesso. Una nuova persona crea una passkey; una persona connessa conferma con una prova passkey fresca e seleziona il progetto di acquisto. Dopo l’accettazione, il Marketplace della dashboard (/marketplace) elenca ogni venditore a cui il progetto ha aderito; aprire un venditore (/marketplace/SELLER_PROJECT_ID) mostra l’inventario e le tariffe consentite da quella adesione. Il Marketplace è solo su invito: i venditori non aderenti al progetto non appaiono mai. Nel CLI, gli agenti leggono screenrig ads networks list e eseguono il workflow campagna: ads creatives create, ads campaigns preview e poi ads campaigns activate --quote-id. Un acquirente spende solo il prezzo quotato per la riproduzione completata, regolato in crediti sul saldo condiviso del progetto: il prezzo quotato è bloccato contro i crediti idonei quando una riproduzione è programmata e si regola solo per una riproduzione completata. Nessuna carta, fattura o checkout è coinvolto, e le sovvenzioni incluse e promozionali non possono finanziare annunci a pagamento; i crediti acquistati e guadagnati con annunci sì.

La vendita resta un progetto di segnaletica con schermi di proprietà. Aggiungi uno schermo con screenrig ads inventory update scr_LOBBY --enabled, descrivilo pubblicamente e definisci slot pubblicitari riutilizzabili con screenrig ads slots create (contenuti immagine o video accettati, durate massime, tariffa opzionale per slot). Inserire una pagina di slot pubblicitario in una delle tue playlist trasforma la definizione dello slot in una pausa pubblicitaria. Imposti la tariffa del progetto per 15 secondi di riproduzione completata con screenrig ads network rate, revisioni le creatività degli acquirenti con ads reviews e leggi lordo e netto con ads reports delivery. Una variazione della tariffa effettiva mette in pausa ogni campagna interessata finché ogni acquirente non accetta un nuovo preventivo.

Gli accordi che concludi tu stesso vanno in onda come campagne dirette sui tuoi schermi. screenrig ads direct create campaign.json indica l'inserzionista, una categoria facoltativa, il periodo di programmazione, le tue immagini o i tuoi video, un obiettivo di riproduzioni facoltativo e gli schermi e gli spazi a cui si rivolge. Una campagna diretta riempie un'interruzione pubblicitaria prima degli acquirenti invitati e un obiettivo è distribuito uniformemente sul suo periodo. Fatturi tu l'inserzionista: non si spostano crediti e il prezzo registrato dà valore al rapporto. ads direct availability stima le riproduzioni che puoi ancora prenotare, una categoria tiene i concorrenti fuori dalla stessa interruzione e ads direct report --format csv è il rapporto di consegna per il tuo inserzionista. ads reports fill mostra come sono stati riempiti i tuoi spazi pubblicitari e perché gli altri no.

Apri Inviti nel dashboard per invitare membri progetto o acquirenti pubblicitari, vedere lo stato degli inviti e cancellare inviti in sospeso. I venditori gestiscono anche l’ambito di appartenenza degli acquirenti e revocano l’accesso acquirente; la revoca interrompe nuove riproduzioni pubblicitarie preservando la storia finanziaria.

Avanti

Apri la guida per Meta Muse, Grok Bot, ChatGPT dots, Claude Code, Hermes, ChatGPT Codex o Gemini Spark, poi apri i Players, il riferimento CLI, Scegli un percorso di authoring o le tariffe e commissioni pubblicitarie.