Skip to content
Automation
Skill

/moviepilot-update

Use this skill when you need to check MoviePilot versions, restart MoviePilot, or trigger a MoviePilot upgrade. Prefer the built-in system APIs instead of docker commands or manual file replacement. If auto-update on restart is already enabled, just restart. If it is disabled,

From plugin
moviepilot
12k14 skills
Install
$ npx -y skills add jxxghp/moviepilot --skill moviepilot-update --agent claude-code

How it fires

How this skill gets triggered: by you, by Claude, or both.

  • Fires itselfAuto-invocation. Claude auto-loads it when your prompt matches the work.Auto-invocation is when the right skill fires by itself at the right moment, driven by a FLOW.md router and a hook, instead of you invoking it by name. It is the difference between a skill being installed and a skill actually getting used.Read the full definition →
  • You can call itInvoke it directly when you want it.
  • Slash command/moviepilot-update

Context preview

The summary Claude sees to decide when to auto-load this skill.

Use this skill when you need to check MoviePilot versions, restart MoviePilot, or trigger a MoviePilot upgrade. Prefer the built-in system APIs instead of docker commands or manual file replacement. If auto-update on restart is already enabled, just restart. If it is disabled,

SKILL.md

moviepilot-update.SKILL.md
name: moviepilot-update
version: 3
description: Use this skill when you need to check MoviePilot versions, restart MoviePilot, or trigger a MoviePilot upgrade. Prefer the built-in system APIs instead of docker commands or manual file replacement. If auto-update on restart is already enabled, just restart. If it is disabled, call the upgrade API so MoviePilot performs a one-shot upgrade and restart.

MoviePilot Update

> All script paths are relative to this skill file.

Use this skill for MoviePilot restart and upgrade operations.

Setup

This skill reuses the `moviepilot-api` client. When running inside the MoviePilot project, the API client imports `app.core.config.settings` and reads the local host, port, and API token directly. Do not ask the user for `API_TOKEN`.

Preferred Commands

Check versions

python scripts/mp-update.py versions

This calls `GET /api/v1/system/versions`.

Restart MoviePilot

python scripts/mp-update.py restart

This calls `GET /api/v1/system/restart`.

Upgrade and restart MoviePilot

Release mode:

python scripts/mp-update.py upgrade

Dev mode:

python scripts/mp-update.py upgrade dev

This calls `POST /api/v1/system/upgrade`.

Behavior:

  • If `MOVIEPILOT_AUTO_UPDATE` is already enabled (`release` or `dev`), MoviePilot only triggers a restart and lets the normal startup flow perform the upgrade.
  • If `MOVIEPILOT_AUTO_UPDATE` is disabled, MoviePilot writes a one-shot upgrade flag, restarts itself, performs that single upgrade during startup, and then continues running without changing the persisted auto-update setting.

Direct API Examples

python ../moviepilot-api/scripts/mp-api.py GET /api/v1/system/restart
python ../moviepilot-api/scripts/mp-api.py POST /api/v1/system/upgrade --json '"release"'
python ../moviepilot-api/scripts/mp-api.py POST /api/v1/system/upgrade --json '"dev"'

Notes

  • These operations require administrator authentication.
  • Restart or upgrade will interrupt the current agent session. Do not rely on post-restart follow-up steps in the same run.
  • Prefer the API flow above. Only fall back to manual container commands when the API is unavailable.
Read more
Ships withmoviepilot

基于 NAStool 部分代码重新设计,聚焦自动化核心需求,减少问题同时更易于扩展和维护。

Get the whole plugin
Stats
11,520
Stars
1,451
Forks
Active
Maintenance
Python
Language
GPL-3.0
License
5m ago
Last commit
3y ago
Created

Repo: jxxghp/moviepilot

Other skills on moviepilot.