# Roku CLI

> Roku CLI Skill

- Skill: `gumadeiras/roku-cli` (Agent Skill, multi-file: 9 files)
- Install (CLI): `npx skillmds@latest add gumadeiras/roku-cli`
- Raw SKILL.md: https://api.skillmd.com/api/skills/gumadeiras/roku-cli/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: gumadeiras (https://skillmd.com/u/gumadeiras)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/gumadeiras/roku-cli

---

## Roku CLI Skill

Purpose: Provide concise guidance for using the Roku CLI and bridge.

### Core Commands
- `roku discover --save <alias> --index <n>`: find devices and save an alias
- `roku <host|alias>`: interactive mode (fast, no SSDP)
- `roku --host <host|alias> command <name>`: send a key
- `roku --host <host|alias> search --app <name>`: search installed apps
- `roku --host <host|alias> launch <appId|alias>`: launch an app

### Bridge
- Start: `roku --host <host|alias> bridge --listen 19839 --token secret`
- Send: `POST /key`, `POST /text`, `POST /search`, `POST /launch`, `GET /health`
- Auth: `Authorization: Bearer <token>` or `x-roku-token: <token>`
- Service: `roku bridge install-service --port 19839 --token secret --host <host|alias> --user`
- Control: `roku bridge start|stop|restart --user`
- Status: `roku bridge status --user` (adds PID/logs; add `--port/--token` for health probe)
- Diagnose: `roku bridge diagnose --user`
- Uninstall: `roku bridge uninstall --user`