---
name: ingest-book
description: >
  Manage book library via Readarr, search for books, and monitor downloads.
  Handles service health checks and API interactions. Part of Horus's learning pipeline.
allowed-tools:
  - run_command
  - read_file
triggers:
  - ingest book
  - book ingest
  - readarr
  - manage books
  - add book
  - search book
metadata:
  short-description: Book ingestion via Readarr library management
---

# ingest-book

**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

```bash
# 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)