Installing the WallRun Copilot Agent Plugin

April 26, 2026 · View on GitHub

The WallRun Copilot agent plugin bundles 14 curated signage skills and 2 specialized agents into a package you can install into any VS Code workspace — no need to clone the full monorepo.

What's included

CategoryContents
Agentssignage-architect (premium signage design), wallrun-deploy (deployment triage)
SkillsLayout system, animation, menu boards, distance legibility, safe layout, state machine, data refresh, content fallbacks, performance budget, placeholder images, BrightSign runtime/packaging/deployment/debugging
HooksAdvisory preflight check (experimental)
MCPBrightSign Player Tools server (discover, probe, list, add, remove players) + BrightDeveloper docs

Prerequisites

  • VS Code Insiders — Copilot agent plugins are a preview feature currently available only in VS Code Insiders. This may change as the feature matures.
  • GitHub Copilot Chat enabled
  • Copilot agent plugin support enabled in settings

Installation methods

Option A: Local path (already have the repo)

If you've cloned WallRun, point VS Code at the plugin directory:

  1. Open VS Code Settings (JSON)
  2. Add:
"chat.pluginLocations": {
  "/absolute/path/to/WallRun/copilot-plugins/wallrun-signage": true
}
  1. Reload VS Code

Option B: Install from repo URL

Use the built-in command to install directly from GitHub:

  1. Open the Command Palette (Ctrl+Shift+P / Cmd+Shift+P)
  2. Run Chat: Install Plugin From Source
  3. Enter the repo URL: https://github.com/CambridgeMonorail/WallRun
  4. VS Code clones the repo and discovers the plugin automatically

Option C: Install portable skills only

If you only want the skills (without agents or hooks), use the open skills CLI:

npx skills add CambridgeMonorail/WallRun

Verifying the installation

After installing, open GitHub Copilot Chat and try:

@signage-architect Build a 3-zone layout for 1080p with a ticker and hero

If the agent responds with signage-specific guidance, the plugin is working.

Updating the plugin

The plugin is regenerated from source skills and agents. After pulling new changes:

pnpm plugin:copilot:build

If you installed via Install Plugin From Source, VS Code manages updates when you pull the repo.

Relationship to workspace agents

MechanismScopeUse when...
Workspace agents (.github/agents/)This repo onlyWorking inside the WallRun monorepo
Copilot plugin (copilot-plugins/wallrun-signage/)Any workspaceBuilding signage in your own project
Portable skills (npx skills add)Any workspaceYou only need the skill workflows

Further reading