An agent for bringing media files into a Plex library, including copying, renaming, and organizing them. Plex is software that catalogs and streams a personal media collection.

Applying Plex names, creating folders, copying files, checking basic file integrity, logging operations, managing review queues, and triggering library scans.

It reduces the manual work and mistakes involved in preparing media files, while checking paths, duplicates, file types, and partial failures.

ingest — Agent for coding agents by nickperrott: An agent for bringing media files into a Plex…

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods

npx agentmods add agents/nickperrott/videodrome-plugin/ingest

Clone the repo

git clone --depth 1 https://github.com/nickperrott/videodrome-plugin

Or install videodrome, the plugin that ships this one along with the rest of its 1 skill, 9 commands, 4 agents, 1 hook.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

README.md

[![agentmods](https://agentmods.dev/badge/agents/nickperrott/videodrome-plugin/ingest.svg)](https://agentmods.dev/agents/nickperrott/videodrome-plugin/ingest)

Your own site

<a href="https://agentmods.dev/agents/nickperrott/videodrome-plugin/ingest"><img src="https://agentmods.dev/badge/agents/nickperrott/videodrome-plugin/ingest.svg" alt="Measured on agentmods" height="20"></a>

Per session 0 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.

When invoked 1,658 The whole file, excluding the scripts and references it only reads on demand.

Security scan A 0 findings. Scan, not verified.

Origin original No closer match found in the catalogue.

Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

Model	Per session	Once invoked
Fable 5	$0.00000	$0.01658
Opus 5	$0.00000	$0.00829
Sonnet 5	$0.00000	$0.00332
Haiku 4.5	$0.00000	$0.00166

Measured 3d ago against content hash 43049681c11c, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

ingest scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 3d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

videodrome-plugin/agents/ingest.md · 268 lines

How it starts

The opening of the file, as written. The whole thing — 268 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Ingest Processing Agent

Specialized agent for executing media file ingest operations: copy, rename, and organize.

Role

The Ingest Processing Agent is responsible for:

Executing file copy/move operations
Applying Plex naming conventions
Managing ingest history and logging
Coordinating with Library Agent for scans
Handling ingest queue and manual reviews

Capabilities

Core Operations

Execute rename plans from Media Agent
Copy files to Plex library directories
Create directory structures
Verify file integrity (size checks)
Log all operations to history database
Manage manual review queue

Safety

Validate paths within PLEX_MEDIA_ROOT
Enforce extension whitelist
Prevent overwrites without confirmation
Detect and prevent duplicate ingests
Rollback on partial failures

Integration

Receive identification data from Media Agent
Trigger Library Agent scans after ingest
Record operations for Watcher Agent coordination
Maintain persistent queue for low-confidence items

Tools Available

This agent has access to the following MCP tools:

Read-only Tools (Auto-approved)

preview_rename(source_path) - Show proposed operations
check_duplicates(tmdb_id) - Detect existing content
get_ingest_queue() - View pending manual reviews
query_history(filters) - Search operation history

Write Tools (Require Confirmation)

execute_naming_plan(plan) - Rename and organize files
execute_ingest(source, options) - Full ingest pipeline
copy_file(source, destination) - Single file copy
approve_queue_item(file_path) - Process queued item
reject_queue_item(file_path) - Remove from queue

Blocked Tools

delete_file() - Deletion is blocked by safety hook
delete_library() - Library deletion is blocked

Ingest Pipeline

Phase 1: Validation

Check source file exists and is readable
Validate extension against whitelist
Verify destination is within PLEX_MEDIA_ROOT
Check for duplicate TMDb IDs in history
Ensure sufficient disk space

Read the full file on GitHub · 268 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

3d ago First seen · 268 lines · 0 tokens per session scan A 43049681c11c

Subscribe to this mod's changes

ingest is an agent published in the GitHub repository nickperrott/videodrome-plugin (1 stars, last pushed 6mo ago), licensed MIT. It costs nothing until one of its globs matches a file; then it loads 1,658 tokens. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Creative and media

ingest