# Moviepilot Update

Use this skill to check MoviePilot versions, inspect Release update state, download a...

- Repository: https://github.com/jxxghp/MoviePilot (12002 stars)
- Category: Engineering
- License: GPL-3.0
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add jxxghp/MoviePilot --skill moviepilot-update -g -a claude-code -y`
Codex: `npx skills add jxxghp/MoviePilot --skill moviepilot-update -g -a codex -y`
Cursor: `npx skills add jxxghp/MoviePilot --skill moviepilot-update -g -a cursor -y`
Gemini CLI: `npx skills add jxxghp/MoviePilot --skill moviepilot-update -g -a gemini-cli -y`

## Description

Use this skill to check MoviePilot versions, inspect Release update state, download a Release update in the background, confirm installation, restart MoviePilot, or retain the existing Dev branch update flow. Prefer the built-in system APIs instead of container commands or manual file replacement.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# MoviePilot Update

Use this skill for MoviePilot restart and upgrade operations.

Use the built-in `moviepilot_api` tool only. The host selects fixed API routes, authenticates with the trusted Agent identity, and applies administrator and confirmation policy. Never request or pass an API token, URL, HTTP method, shell command, or legacy helper script.

## Operations

### Check versions

```json
{"operation_id":"system.versions","path_params":{},"query":{},"body":{}}
```

This read-only operation lists available MoviePilot releases.

### Restart MoviePilot

```json
{"operation_id":"system.restart","path_params":{},"query":{},"body":{}}
```

Restart requires explicit confirmation and interrupts the current Agent session.

### Release update

Check for the highest stable V3 Release and inspect current progress. A manual check may replace an older prepared target with a newer version; failed checks preserve downloaded packages:

```json
{"operation_id":"system.update.check","path_params":{},"query":{},"body":{}}
{"operation_id":"system.update.status","path_params":{},"query":{},"body":{}}
```

When `supports_batch_update=true`, prepare the latest backend, matching frontend, and site resources together. This does not restart MoviePilot:

```json
{"operation_id":"system.update.download","path_params":{},"query":{},"body":{"target":"all"}}
```

After every non-idle item in `updates` reports `state=ready` and no item has a check error, installation requires a separate explicit confirmation:

```json
{"operation_id":"system.update.install","path_params":{},"query":{},"body":{"target":"all"}}
```

`install` writes one verified install intent and restarts MoviePilot once. Do not call it until the user explicitly confirms the restart. Use `target=application` or `target=resources` for a specifically requested single-target update. On older hosts without `supports_batch_update`, retain the single-target flow; an omitted target defaults to `application`.

The rest: https://github.com/jxxghp/MoviePilot/blob/HEAD/skills/moviepilot-update/SKILL.md