peer-displays

Creates and announces virtual displays on federated peer machines via Intendant ctl commands.

14|Updated Mar 2, 2026
One-click install
npx skills add https://github.com/intendant-dev/Intendant --skill peer-displays-intendant-dev
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: peer-displays
Source: https://github.com/intendant-dev/Intendant/tree/main/skills/peer-displays
Command: npx skills add https://github.com/intendant-dev/Intendant --skill peer-displays-intendant-dev

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When working across federated Intendant machines, GUI work done on a peer's display is invisible to the user unless it is properly created and announced. This Skill walks through the full loop of opening a display on a remote peer, arranging work on it, and surfacing it on the user's dashboard so nothing runs on a screen the owner cannot find. ## Core Features & Use Cases - Peer Display Creation: Runs ctl --peer <id> display create to spin up an agent-owned Xvfb virtual display on a Linux peer and returns its display id. - Work Arrangement: Drives the display with cu actions targeting the display, or delegates to the peer's own agent via ctl peer task. - User Surfacing: Uses shared show to raise a shared-view banner on the user's Activity pane with a click-through to the live pane, and shared hide to retire it. - Grant Awareness: Explains which peer IAM grants each step needs (display view for screenshots and shared show, display input for display create and cu actions) and how to report denials. - Use Case: A user says "open a screen on the dell and show me the test run" — the Skill creates display :99 on the dell peer, starts the run there, and announces it so it appears live on the user's dashboard. ## Quick Start Ask the agent to open a display on a paired peer machine and show it to you, for example: "Open a display on the dell peer, run the app there, and show it on my dashboard."

Frequently Asked Questions about peer-displays

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I open a display on a remote peer machine with Intendant?▼

Run `ctl --peer <id> display create` to create an agent-owned virtual display on the peer, then arrange work on it with `cu actions --target display_<id>` and announce it with `shared show` so it surfaces on the user's dashboard.

Why is my peer display invisible to the user after I created it?▼

Work on a display stays invisible to every user surface until it is announced with `display create` or `shared show`. The `shared show` command raises a shared-view banner on the user's Activity pane with a click-through to the live pane.

Does display create work on macOS or Windows peers?▼

No, `display create` is Xvfb-backed and works on Linux peers only. macOS or Windows peers return a clear error, so target one of their existing advertised displays instead, which you can see with `ctl peer list`.

What peer grants are needed for shared show and display create?▼

The peer's IAM profile decides per step: `shared show`, screenshots, and `cu elements` need display view (read-only-display or better), while `display create` and `cu actions` need display input (peer-operator or peer-root). A denial means the owner has not granted that operation.

What happens to the shared-view banner if the peer connection drops?▼

Federated shared-view announcements are live state, not history, so the banner clears if the peer link drops. Re-run `shared show` after a reconnect if the collaboration is still ongoing.