# Prowlarr CLI

> Manage your Prowlarr indexer hub from the terminal. List and inspect indexers, view query/grab statistics, check health, manage connected *arr applications and download clients, browse search history, and test indexer connectivity. Use when the user mentions Prowlarr, indexers, indexer management, testing indexers, search history, or the indexer hub.

- Skill: `theheavenlyd3mon/prowlarr-cli` (Agent Skill, multi-file: 5 files)
- Install (CLI): `npx skillmds@latest add theheavenlyd3mon/prowlarr-cli`
- Raw SKILL.md: https://api.skillmd.com/api/skills/theheavenlyd3mon/prowlarr-cli/raw
- Safety review: PASS (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- License: MIT
- Author: theheavenlyd3mon (https://skillmd.com/u/theheavenlyd3mon)
- Updated: 2026-08-19
- Page: https://skillmd.com/skills/theheavenlyd3mon/prowlarr-cli

---


# prowlarr-cli — Prowlarr Indexer Management

CLI for Prowlarr, the indexer manager for the *arr stack. Unlike radarr-cli
and sonarr-cli, this manages indexer infrastructure rather than media.

## Quick Setup

```bash
export ARR_SERVER_PROWLARR="http://localhost:9696"
export ARR_KEY_PROWLARR="your-prowlarr-api-key"
```

`--help` and `--dry-run` work without credentials.

## When to Use Which

| User says... | Load... |
|---|---|
| "list my indexers", "what indexers do I have" | `prowlarr-cli indexers` |
| "show me indexer 5", "details on this indexer" | `prowlarr-cli indexer 5` |
| "how are my indexers doing", "query stats" | `prowlarr-cli indexer-stats` |
| "are any indexers down" | `prowlarr-cli indexer-status` |
| "what apps are connected" | `prowlarr-cli applications` |
| "what download clients are configured" | `prowlarr-cli download-clients` |
| "show me search history" | `prowlarr-cli history` |
| "test all my indexers" | `prowlarr-cli test-all` |
| "prowlarr health" | `prowlarr-cli health` |
| "list tags" | `prowlarr-cli tags` |

## Quick Reference

**Global flags:** `--json`, `--dry-run`, `--force`, `--quiet`, `--verbose`

```bash
# System info
prowlarr-cli status

# Indexer management
prowlarr-cli indexers                                # all indexers
prowlarr-cli indexers --limit 10                     # top 10
prowlarr-cli indexer 5                               # single indexer details
prowlarr-cli indexer-stats                           # query/grab stats
prowlarr-cli indexer-status                          # health per indexer

# Infrastructure
prowlarr-cli applications                            # connected *arr apps
prowlarr-cli download-clients                        # configured download clients
prowlarr-cli tags                                    # list tags
prowlarr-cli health                                  # health warnings

# Search and testing
prowlarr-cli history --limit 20                      # search history
prowlarr-cli test-all                                # test all indexers

# JSON output for scripting
prowlarr-cli --json indexers | jq '.indexers[] | {name, protocol, enable, status}'
prowlarr-cli --json health | jq '.[].message'
```

## Reference Files

| File | Contents |
|------|----------|
| `references/prowlarr-commands.md` | Full command reference |
| `references/troubleshooting.md` | Pitfalls and FAQs |

## When NOT to Use

- **Media search** — Prowlarr indexes content but doesn't download it. Use Radarr/Sonarr/Lidarr.
- **First-time Prowlarr setup** — assumes Prowlarr is already installed and configured.