name: readarr-ops
description: >
Manage Readarr library, search for books, and monitor downloads.
Handles service health checks and API interactions.
allowed-tools:
- run_command
- read_file
triggers:
- readarr
- manage books
- add book
- search book
metadata:
short-description: Manage Readarr library and downloads

readarr-ops

Manage Readarr library, search for books, and monitor downloads.

Commands

• search <term>: Search for books/authors in Readarr.
• nzb-search <term>: Direct Usenet search via NZBGeek.
• add <term>: Search and add the first matching book (Auto-Learn).
• health: Check if Readarr is running and healthy.
• ensure-running: Start Readarr if not running.

Usage

# Check health
./run.sh health

# Search for a book
./run.sh search "The Art of Exploitation"

# Add a book
./run.sh add "Hacking: The Art of Exploitation"

Configuration

• Readarr Path: ~/workspace/experiments/Readarr/Readarr
• Data Path: ~/workspace/experiments/Readarr/data
• Port: 8787
• API Key: READARR_API_KEY env var (optional for localhost in some configs)