screenRIG
Sign inGet started

Documentation

Set up screenRIG in Hermes

Use Hermes Agent from Nous Research to load the official screenRIG skill, connect your account, and publish to your Player.

Load the skill →Pair a Player →

Get Hermes

Follow the official Hermes quickstart to install Hermes and choose your model provider. Start a conversation in the terminal or a messaging gateway you have configured. Hermes and model-provider accounts are separate from your screenRIG account.

Load the official screenRIG skill

Hermes supports skills and terminal tools. Ask it to use the skill and bundled CLI from the official screenRIG plugin:

Install prompt
Install screenrig.ai from the official plugin at https://github.com/screenrig/plugin. Load its bundled screenrig skill in Hermes and use its bundled CLI. Confirm you can run screenrig version, then help me connect my account and set up my first screen.

Review installation and tool-access requests before approving them. Hermes needs access to the complete plugin bundle and Node.js 22.23.4+, 24.22.1+, or 26.12.1+ (excluding 23.x and 25.x) in the environment where it runs commands. Loading a skill description alone is not enough: ask it to confirm the bundled CLI works before continuing.

Use Hermes’s skills documentation for skill discovery and external skill directories. The Claude Code and Codex marketplace commands are not Hermes commands. If Hermes cannot load the skill or run its launcher, ask which capability is missing; a chat response alone does not complete setup.

Create your screenRIG project

Give Hermes your actual contact email and use the organization name already provided, or default to Screens. Your agent runs screenrig agent enroll --email ADDRESS --organization "Screens" to create its identity, organization, Screens project and membership, and email you a member invitation. That email is your dashboard login, and nothing waits on it: your agent goes straight on to pairing your screen and making content. Open it whenever you want the dashboard to create a passkey, or sign in with your existing login to add the project. The dashboard shows your projects and lets you switch between them.

To sign this installation in to a project you belong to, use screenrig login: you check the code it shows, then choose the project and its access in the dashboard. Never paste passwords, invitation links, or API tokens into the conversation. See Project access.

Pair your Player and publish

  1. 01

    Follow Player downloads & setup to install the Player for the device driving your screen. The Player web app (PWA) runs in any modern browser.

  2. 02

    Launch the Player and give its pairing code to Hermes. Keep the web Player in the foreground.

  3. 03

    Tell Hermes what to show, on which screen, and when. Share only the data sources you want it to access.

  4. 04

    Ask it to publish, request a screenshot, and check the physical screen yourself.

Already have a pairing code? Send:

Use screenrig.ai for my lobby screen. My pairing code is [code]. Publish my existing welcome-board image.

Next

Return to Start, read the agent workflow, or see the CLI reference.