Pp Movie Goat

<!-- GENERATED FILE — DO NOT EDIT. This file is a verbatim mirror of library/media-and-entertainment/movie-goat/SKILL.md, regenerated post-merge by tools/generate-skills/. Hand-edits here are silently overwritten on the next regen. Edit the library/ source instead. See the repository agent guide, section "Generated artifacts: registry.json, cli-skills/". -->

Movie Goat — Printing Press CLI

Prerequisites: Install the CLI

This skill drives the movie-goat-pp-cli binary. You must verify the CLI is installed before invoking any command from this skill. If it is missing, install it first:

1. Install via the Printing Press installer. It defaults binaries to $HOME/.local/bin on macOS/Linux and %LOCALAPPDATA%\Programs\PrintingPress\bin on Windows: ``bash npx -y @mvanhorn/printing-press-library install movie-goat --cli-only ``
2. Verify: movie-goat-pp-cli --version
3. Ensure the reported install directory is on $PATH for the agent/runtime that will invoke this skill.

If the npx install fails (no Node, offline, etc.), fall back to a direct Go install (requires Go 1.26.6 or newer):

go install github.com/mvanhorn/printing-press-library/library/media-and-entertainment/movie-goat/cmd/movie-goat-pp-cli@latest

If --version reports "command not found" after install, the runtime cannot see the binary directory on $PATH. Do not proceed with skill commands until verification succeeds.

When to Use This CLI

Use Movie Goat when an agent needs to answer cinephile questions that require combining streaming availability with multi-source ratings. It is the right choice for tonight-picker scenarios, franchise marathon planning, and rated career timelines. It is not the right choice for box-office tracking, review sentiment analysis, or any workflow that needs LLM-style summaries of plot or reviews.

When Not to Use This CLI

Do not activate this CLI for requests that require creating, updating, deleting, publishing, commenting, upvoting, inviting, ordering, sending messages, booking, purchasing, or changing remote state. This printed CLI exposes read-only commands for inspection, export, sync, and analysis.

Unique Capabilities

These capabilities aren't available in any other tool for this API.

Cinephile rituals

• `tonight` — Pick what to watch tonight from trending titles actually streaming on your services.

_Use this when an agent needs a streaming-filtered shortlist; one call replaces tab-bouncing across TMDb/RT/JustWatch._

  movie-goat-pp-cli tonight --mood thriller --max-runtime 120 --providers netflix,max --region US --json

• `ratings` — TMDb + IMDb + Rotten Tomatoes + Metacritic ratings for any title in one card.

_Use when an agent needs the canonical multi-source rating for a title; degrades gracefully to TMDb-only if OMDB_API_KEY is unset._

  movie-goat-pp-cli ratings 550 --json

• Remake-aware title resolution — Every command that accepts a title instead of a TMDb id says so out loud when the title is shared.

_TMDb's search ranks by a proprietary relevance score, so "Sabrina" resolves to the 1995 remake even though the 1954 Wilder original is better rated. When a title has more than one well-rated match, the CLI reports it on both channels: a human notice on stderr, and a meta.ambiguous record in the JSON on stdout for consumers that never read stderr. Pin the one you meant with --year, a "Title (YYYY)" suffix, or the id._

  movie-goat-pp-cli ratings "Sabrina" --year 1954 --json

• `marathon` — Plan a franchise marathon with watch order, total runtime, and suggested breaks.

_Use when planning an event watch; agent can dump the schedule to share with a group._

  movie-goat-pp-cli marathon "The Avengers" --order release --breaks-every 240 --json

• `career` — Explore any actor or director's full filmography with ratings and chronology.

_Use when an agent needs a rated chronological filmography; replaces flat IMDb lists with cross-source ratings._

  movie-goat-pp-cli career "Christopher Nolan" --since 2010 --role director --json

• `versus` — Compare two movies or shows side-by-side across ratings, cast, runtime, and streaming.

_Use when an agent has to pick between two finalists; one command shows where they differ on every axis._

  movie-goat-pp-cli versus 550 27205 --region US --json

• `collaborators` — List people who appear in 2+ of a person's credits, with count and titles.

_Use when an agent is researching a filmmaker's circle; surfaces recurring DPs/composers/actors mechanically._

  movie-goat-pp-cli collaborators "Christopher Nolan" --min-count 3 --role crew --json

Local state that compounds

• `watchlist list` — Local SQLite watchlist; flag rows that are streamable on your services.

_Use weekly to surface streamable items from a saved list; eliminates ad-hoc JustWatch checks per title._

  movie-goat-pp-cli watchlist list --available --providers netflix,max --region US --json

• `queue` — Suggest next-watch picks derived from your watchlist's recommendations and similars.

_Use when an agent needs a fresh queue derived from saved interests; combines local state with API recommendations._

  movie-goat-pp-cli queue --limit 20 --providers netflix,max --region US --json

Command Reference

auth — Manage TMDB_API_KEY and OMDB_API_KEY credentials

• movie-goat-pp-cli auth status — Show authentication status for both the TMDb and OMDb credentials
• movie-goat-pp-cli auth set-token — Save the TMDb API token to the config file
• movie-goat-pp-cli auth set-omdb-token — Save the optional OMDb API token to the config file
• movie-goat-pp-cli auth logout — Clear stored credentials

discover — Discover movies and TV shows with rich filters

• movie-goat-pp-cli discover movies — Discover movies by genre, year, rating, certification, cast, crew, streaming provider, and more
• movie-goat-pp-cli discover tv — Discover TV shows by genre, year, rating, network, and streaming provider

genres — Get genre lists for movies and TV

• movie-goat-pp-cli genres movies — Get the list of movie genres
• movie-goat-pp-cli genres tv — Get the list of TV genres

movies — Search and browse movies

• movie-goat-pp-cli movies get — Get detailed info about a movie including cast, ratings, and streaming availability
• movie-goat-pp-cli movies now-playing — Get movies currently in theaters
• movie-goat-pp-cli movies popular — Get current popular movies
• movie-goat-pp-cli movies search — Search for movies by title
• movie-goat-pp-cli movies top-rated — Get the highest rated movies
• movie-goat-pp-cli movies upcoming — Get movies coming soon to theaters

multi — Multi-search across movies, TV shows, and people

• movie-goat-pp-cli multi <query> — Search for movies, TV shows, and people in a single query

people — Search and browse people (actors, directors, crew)

• movie-goat-pp-cli people get — Get detailed info about a person including their filmography
• movie-goat-pp-cli people popular — Get popular people in entertainment
• movie-goat-pp-cli people search — Search for people by name

trending — Get trending movies, TV shows, and people

• movie-goat-pp-cli trending all — Get trending movies, TV, and people
• movie-goat-pp-cli trending movies — Get trending movies
• movie-goat-pp-cli trending people — Get trending people
• movie-goat-pp-cli trending tv — Get trending TV shows

tv — Search and browse TV shows

• movie-goat-pp-cli tv airing-today — Get TV shows with episodes airing today
• movie-goat-pp-cli tv get — Get detailed info about a TV show
• movie-goat-pp-cli tv on-the-air — Get TV shows currently on the air
• movie-goat-pp-cli tv popular — Get current popular TV shows