How do I install the Roku skill?

Run npx skillmds@latest add dvcrn/roku in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: executes scripts, makes network calls, reads secrets. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Roku?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

dvcrn (@dvcrn) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Roku by dvcrn — Agent Skill

Name: Roku
Rating: 4.5 (4 reviews)
Author: dvcrn

File contents

Roku CLI

Fast TypeScript CLI for controlling Roku devices via the ECP API.

Installation

npm install -g roku-ts-cli@latest

Quick Start

# Discover devices and save an alias
roku discover --save livingroom --index 1

# Use the alias
roku --host livingroom device-info
roku --host livingroom apps

Commands

Command	Description
`roku discover`	Find Roku devices on network
`roku --host <ip> device-info`	Get device info
`roku --host <ip> apps`	List installed apps
`roku --host <ip> command <key>`	Send remote key
`roku --host <ip> literal <text>`	Type text
`roku --host <ip> search --title <query>`	Search content
`roku --host <ip> launch <app>`	Launch app
`roku --host <ip> interactive`	Interactive remote mode

Interactive Mode

roku livingroom                    # interactive control
roku --host livingroom interactive # same thing

Use arrow keys, enter, escape for remote-like control.

Bridge Service

Run a persistent HTTP bridge as a native OS service:

# Install and start the service
roku bridge install-service --port 19839 --token secret --host livingroom --user
roku bridge start --user

# Service management
roku bridge status --user
roku bridge stop --user
roku bridge uninstall --user

Send commands via HTTP:

# Send key
curl -X POST http://127.0.0.1:19839/key \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer secret" \
  -d '{"key":"home"}'

# Type text
curl -X POST http://127.0.0.1:19839/text \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer secret" \
  -d '{"text":"hello"}'

# Launch app
curl -X POST http://127.0.0.1:19839/launch \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer secret" \
  -d '{"app":"plex"}'

# Health check
curl http://127.0.0.1:19839/health -H "Authorization: Bearer secret"

Bridge Endpoints

Endpoint	Body
`POST /key`	`{"key": "home"}`
`POST /text`	`{"text": "hello"}`
`POST /search`	`{"title": "Stargate"}`
`POST /launch`	`{"app": "plex"}`
`GET /health`	—
`GET /health?deep=1`	Deep health check (probes Roku)

Aliases

# Save device alias
roku discover --save livingroom --index 1
roku alias set office 192.168.1.20

# Save app alias  
roku alias set plex 13535

# List aliases
roku alias list

# Use aliases
roku --host livingroom launch plex

Remote Keys

home, back, select, up, down, left, right, play, pause, rev, fwd, replay, info, power, volume_up, volume_down, mute

Notes

Roku must be on the same network as the CLI
Bridge service runs as a native launchd (macOS) or systemd (Linux) service
Use --user flag for user-space service (no sudo required)
Use --token for authentication in bridge mode

Source

https://github.com/gumadeiras/roku-cli

---name: rokudescription: Control Roku devices via CLI. Discovery, remote control, app launching, search, and HTTP bridge mode for real-time control.---# Roku CLIFast TypeScript CLI for controlling Roku devices via the ECP API.## Installation```bashnpm install -g roku-ts-cli@latest```## Quick Start```bash# Discover devices and save an aliasroku discover --save livingroom --index 1# Use the aliasroku --host livingroom device-inforoku --host livingroom apps```## Commands| Command | Description ||---------|-------------|| `roku discover` | Find Roku devices on network || `roku --host <ip> device-info` | Get device info || `roku --host <ip> apps` | List installed apps || `roku --host <ip> command <key>` | Send remote key || `roku --host <ip> literal <text>` | Type text || `roku --host <ip> search --title <query>` | Search content || `roku --host <ip> launch <app>` | Launch app || `roku --host <ip> interactive` | Interactive remote mode |## Interactive Mode```bashroku livingroom # interactive controlroku --host livingroom interactive # same thing```Use arrow keys, enter, escape for remote-like control.## Bridge ServiceRun a persistent HTTP bridge as a native OS service:```bash# Install and start the serviceroku bridge install-service --port 19839 --token secret --host livingroom --userroku bridge start --user# Service managementroku bridge status --userroku bridge stop --userroku bridge uninstall --user```Send commands via HTTP:```bash# Send keycurl -X POST http://127.0.0.1:19839/key \ -H "Content-Type: application/json" \ -H "Authorization: Bearer secret" \ -d '{"key":"home"}'# Type textcurl -X POST http://127.0.0.1:19839/text \ -H "Content-Type: application/json" \ -H "Authorization: Bearer secret" \ -d '{"text":"hello"}'# Launch appcurl -X POST http://127.0.0.1:19839/launch \ -H "Content-Type: application/json" \ -H "Authorization: Bearer secret" \ -d '{"app":"plex"}'# Health checkcurl http://127.0.0.1:19839/health -H "Authorization: Bearer secret"```### Bridge Endpoints| Endpoint | Body ||----------|------|| `POST /key` | `{"key": "home"}` || `POST /text` | `{"text": "hello"}` || `POST /search` | `{"title": "Stargate"}` || `POST /launch` | `{"app": "plex"}` || `GET /health` | — || `GET /health?deep=1` | Deep health check (probes Roku) |## Aliases```bash# Save device aliasroku discover --save livingroom --index 1roku alias set office 192.168.1.20# Save app alias roku alias set plex 13535# List aliasesroku alias list# Use aliasesroku --host livingroom launch plex```## Remote Keyshome, back, select, up, down, left, right, play, pause, rev, fwd, replay, info, power, volume_up, volume_down, mute## Notes- Roku must be on the same network as the CLI- Bridge service runs as a native launchd (macOS) or systemd (Linux) service- Use `--user` flag for user-space service (no sudo required)- Use `--token` for authentication in bridge mode## Sourcehttps://github.com/gumadeiras/roku-cli

Frequently asked questions

Roku