← Back to Skills Marketplace
PLEX-CTL
by
akivasolutions
· GitHub ↗
· v1.0.0
717
Downloads
1
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install plex-ctl
Description
Command-line tool for searching, playing, and controlling Plex Media Server and clients via the Plex API on your local network.
Usage Guidance
This package looks coherent with its stated purpose. Before installing, consider: (1) The tool requires you to supply your Plex token and will store it in ~/.plexctl/config.json — treat that file as sensitive. (2) The code may perform local network calls to your Plex server and (as a fallback) may contact Plex cloud services for MyPlex discovery; if you want strictly local-only operation, disable cloud discovery or avoid using cloud fallback. (3) The included verify.sh runs git commands and prints git remote info — review it before running to avoid revealing repository metadata. (4) Install plexapi in a Python virtual environment (pip install -r requirements.txt) and inspect plexctl.py if you want to be certain of behavior. Overall, there are no disproportionate credential or network requests and no other obvious red flags.
Capability Analysis
Type: OpenClaw Skill
Name: plex-ctl
Version: 1.0.0
The OpenClaw AgentSkills bundle for 'plexctl' is benign. The code (`plexctl.py`) is a straightforward CLI wrapper around the `plexapi` library, designed to control a user's local Plex Media Server. It stores configuration (Plex URL and token) locally in `~/.plexctl/config.json` and connects directly to the specified Plex server. There is no evidence of data exfiltration, malicious execution (e.g., `curl|bash`, `eval`), persistence mechanisms, or obfuscation. The `SKILL.md` and `README.md` provide clear, well-defined instructions for the agent and user, explicitly stating local-only operation and no external data sharing. The use of `argparse` in `plexctl.py` mitigates direct shell injection risks into the Python script itself, assuming the agent correctly passes user input as quoted arguments.
Capability Assessment
Purpose & Capability
The code and docs align with the stated purpose: controlling Plex servers and clients via the Plex API. Required dependency (plexapi) is appropriate. No unrelated services, binaries, or credentials are requested that don't match a Plex control tool.
Instruction Scope
SKILL.md and README instruct the user to install plexapi, run an interactive setup that asks for Plex URL/token, and to run normal commands; those instructions are within scope. Two minor notes: (1) the tool uses local GDM discovery first but falls back to Plex cloud (MyPlex) for client discovery — the docs mention this, but it means the code may make outbound calls to Plex cloud only as a fallback; (2) the included verify.sh queries local git metadata and remote URLs (git log, git remote -v) which reads local repo metadata — benign for verification but unnecessary for runtime operation and worth noting before running the script.
Install Mechanism
There is no install spec (instruction-only install); the files included are Python script(s) and a requirements.txt. Installing is limited to pip installing plexapi (expected). No downloads from arbitrary URLs or archive extraction are present.
Credentials
The skill does not request environment variables or external credentials in the registry metadata. It asks the user to provide a Plex token interactively and stores it locally at ~/.plexctl/config.json — this is proportional to its function. There are no demands for unrelated tokens or secrets.
Persistence & Privilege
The skill does not request always:true, does not modify other skills, and only writes its own config to ~/.plexctl/config.json. Autonomous invocation (disable-model-invocation: false) is the platform default and not itself a red flag here.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install plex-ctl - After installation, invoke the skill by name or use
/plex-ctl - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release — standalone Plex Media Server CLI. Play, search, pause, resume, browse libraries, and control any Plex client directly via API.
Metadata
Frequently Asked Questions
What is PLEX-CTL?
Command-line tool for searching, playing, and controlling Plex Media Server and clients via the Plex API on your local network. It is an AI Agent Skill for Claude Code / OpenClaw, with 717 downloads so far.
How do I install PLEX-CTL?
Run "/install plex-ctl" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is PLEX-CTL free?
Yes, PLEX-CTL is completely free (open-source). You can download, install and use it at no cost.
Which platforms does PLEX-CTL support?
PLEX-CTL is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created PLEX-CTL?
It is built and maintained by akivasolutions (@akivasolutions); the current version is v1.0.0.
More Skills