Data

Tools

Indexes

Applications

Experiments

Awesome

An open API service indexing awesome lists of open source software.

https://github.com/maxtechera/admirarr

⚓ Command your *Arr fleet. Zero-dependency CLI for Plex + Radarr + Sonarr + Prowlarr + qBittorrent.
https://github.com/maxtechera/admirarr

agent-skills arr cli devtools diagnostics golang homelab jellyfin media-server plex prowlarr qbittorrent radarr self-hosted sonarr

Last synced: about 2 months ago
JSON representation

⚓ Command your *Arr fleet. Zero-dependency CLI for Plex + Radarr + Sonarr + Prowlarr + qBittorrent.

Awesome Lists containing this project

README 

          


  


  

    

    

    Admirarr

  

  



  Release

   

  Install

   

  Go

   

  Agent Skills

   

  Stars

   

  License

  



  Command your fleet. The unified CLI for your *Arr stack — human and agent operated.








## What is Admirarr?



Deploy, wire, operate, and diagnose your Jellyfin/Plex + *Arr stack from one terminal. One binary, 26 commands, JSON output everywhere. Ships with a [`SKILL.md`](https://agentskills.io) following the Agent Skills open standard — so any AI agent on any platform can command your fleet too.



- **`admirarr setup`** — zero to media server in 15 minutes

- **`admirarr doctor`** — 15 diagnostic categories, 34 checks, AI-powered repair

- **`admirarr status`** — your entire fleet at a glance







## Quick Start



```bash

curl -fsSL https://get.admirarr.dev | sh

admirarr setup      # deploy + wire the stack

admirarr status     # see everything at a glance

```



```

⚓ Fleet Status

──────────────────────────────────────────────

  Services     8/8 online

  Movies       1,247 (1,189 with files)

  Shows        86 (2,341 episodes)

  Downloads    3 active — 42.1 MB/s

  Disk         2.4 TB / 8.0 TB (30%)

  Requests     2 pending

──────────────────────────────────────────────

```



```

⚓ Doctor — 15 categories, 34 checks

──────────────────────────────────────────────

  ✓ Connectivity      All 8 services reachable

  ✓ API Keys          All keys valid

  ✓ Containers        All running

  ✓ Download Clients  qBittorrent connected

  ✗ VPN               Gluetun tunnel down

  ✓ Media Paths       All paths exist

  ...

──────────────────────────────────────────────

  33 passed · 1 failed — run admirarr doctor --fix

```







## Your Agent Already Knows Admirarr



Admirarr ships a `SKILL.md` following the [Agent Skills](https://agentskills.io) open standard — the same spec used by 26+ platforms. Your agent reads it, discovers Admirarr's commands, and operates your stack.



**Works with:** Claude Code, OpenClaw, OpenCode, Codex, Gemini CLI, Cursor, VS Code, Goose, Aider — and any future SKILL.md-compatible platform.



### Install for your agent



PlatformInstall command



Any agent (universal)



```bash

npx skills add maxtechera/admirarr

```



Claude Code



```

/plugin marketplace add maxtechera/admirarr

/plugin install admirarr@admirarr

```



OpenClaw



```bash

clawdhub install admirarr

```



OpenCode



Auto-discovered — clone the repo and OpenCode reads `SKILL.md` and `AGENTS.md` natively.



Cursor / Copilot / Cline



Auto-discovered — `SKILL.md` and `AGENTS.md` at repo root are read natively.



> Already installed Admirarr the CLI? Your agent picks up `SKILL.md` automatically — no extra step needed.



### What ships in the box



| File | What it does | Platforms |

|---|---|---|

| **`SKILL.md`** | Agent Skills standard — full command reference | All 26+ platforms |

| **`AGENTS.md`** | Agent reference — commands, patterns, rules | OpenCode, Codex, Gemini CLI, Cursor, Copilot |

| **3 Claude Code agents** | `doctor-fix` (Sonnet), `fleet-status` (Haiku), `content-search` (Haiku) | Claude Code, OpenCode |

| **`.opencode/opencode.jsonc`** | Agents + commands config for OpenCode | OpenCode |

| **`.claude-plugin/`** | Plugin marketplace for `/plugin install` | Claude Code |



### `doctor --fix` — two-tier AI repair



```

"My downloads seem stuck"

→ agent calls admirarr doctor -o json

→ finds VPN down

→ calls admirarr restart gluetun

→ re-runs admirarr doctor to verify

```



Built-in fixes run first (container restarts, directory creation, VPN detection). Remaining issues get dispatched to whichever AI agent you have installed — auto-detected.



### How it fits together



```

┌─────────────────────────────────────────────┐

│           Any Agent Platform                 │

│  Claude Code · OpenClaw · Codex · Cursor ... │

└──────────────────┬──────────────────────────┘

                   │ reads SKILL.md

                   ▼

┌─────────────────────────────────────────────┐

│            ⚓ admirarr                       │

│  One binary · JSON output · 26 commands     │

└──────────────────┬──────────────────────────┘

                   │

                   ▼

┌─────────────────────────────────────────────┐

│           Your *Arr Stack                    │

│  Jellyfin · Radarr · Sonarr · Prowlarr      │

│  qBittorrent · Gluetun · Seerr · Bazarr     │

└─────────────────────────────────────────────┘

```







## Commands



```bash

admirarr status               # Fleet dashboard — services, libraries, queues, disk

admirarr status --live         # Live-updating TUI

admirarr doctor               # 15 diagnostic categories, 34 checks

admirarr doctor --fix          # AI agent detects + fixes issues automatically

admirarr setup                 # Deploy + wire the entire stack (12 phases)



admirarr add-movie "Dune"     # Search → pick → add → downloading

admirarr add-show "Severance" # Same for Sonarr

admirarr search "4k remux"    # Search all Prowlarr indexers



admirarr downloads            # Active torrents (+ pause/resume/remove)

admirarr queue                # Import queues

admirarr missing              # Monitored but not on disk

admirarr movies / shows       # Library with file status

admirarr recent / history     # Recently added / watch history

admirarr requests             # Seerr requests



admirarr indexers             # Indexer health (+ setup/add/remove/test/sync)

admirarr recyclarr sync       # TRaSH Guide quality profiles

admirarr health               # Service warnings

admirarr disk                 # Storage breakdown

admirarr restart     # Restart a service

admirarr logs        # Tail logs

admirarr scan                 # Library scan

```



Every command supports `-o json` for structured output.







## Diagnostic Engine



15 categories, 34 checks — connectivity, API keys, containers, download clients, disk, media paths, root folders, quality config, indexers, health warnings, VPN, permissions, hardlinks, cross-service wiring, and recyclarr.



```bash

admirarr doctor               # Run all checks

admirarr doctor --fix          # Built-in fixes → AI agent for the rest

```



Every failure includes an actionable fix. `--fix` runs deterministic repairs first (restart containers, create directories, detect VPN credentials), then dispatches remaining issues to your AI agent with full context.







## Setup



```bash

admirarr setup

```



12 phases: detect environment → select services → deploy via Docker Compose → connectivity check → API key discovery → download clients → root folders → Prowlarr wiring → Seerr wiring → Bazarr wiring → quality profiles → write config.



Idempotent — run again anytime to converge. Detects existing services and wires what's missing.







## Supported Services



10 default + 14 optional services.



| Service | Role |

|---|---|

| **Jellyfin** | Media server |

| **Radarr** / **Sonarr** | Movie + TV automation |

| **Prowlarr** | Indexer management |

| **qBittorrent** + **Gluetun** | Downloads behind VPN |

| **Seerr** | Media requests |

| **Bazarr** | Subtitles |

| **FlareSolverr** | Cloudflare bypass |

| **Profilarr** | TRaSH Guide quality profiles (GUI) |

| **Watchtower** | Auto-updates |



Want Plex instead? Setup asks. Don't want something? Skip it.



Optional services



Plex, Lidarr, Readarr, Whisparr, SABnzbd, Autobrr, Unpackerr, Recyclarr, Tdarr, Tautulli, Jellystat, Notifiarr, Maintainerr







## Why CLI + Agent Skills?



- **CLIs compose** — agents call `admirarr status -o json`, not navigate web UIs

- **SKILL.md is portable** — one file makes Admirarr work on 26+ agent platforms, no per-platform integration

- **One binary, zero deps** — works in SSH, tmux, CI, agent sandboxes

- **Already standard** — Agent Skills is the industry spec, adopted by Claude, OpenAI, Google, Microsoft, GitHub, and more. Admirarr uses what's already there.







## Why Another CLI?



Your stack has 10+ services, each with its own API, web UI, and config format. No single tool manages all of them.



### The *Arr ecosystem — what Admirarr manages



| Service | What it does | What Admirarr does with it |

|---------|-------------|---------------------------|

| **Jellyfin** / **Plex** | Media server — streams your library | Libraries, watch history, recently added, library scans |

| **Radarr** | Movie automation — monitors, grabs, imports | Search, add movies, queue, missing, quality profiles, health |

| **Sonarr** | TV automation — same as Radarr for shows | Search, add shows, queue, missing, quality profiles, health |

| **Prowlarr** | Indexer manager — searches torrent/usenet sites | Indexer status, add/remove/test/sync indexers |

| **qBittorrent** | Download client — torrents behind VPN | Active downloads, pause/resume/remove, speed |

| **Gluetun** | VPN container — routes downloads through VPN | VPN status, credential detection, restart |

| **Seerr** | Request system — users request movies/shows | View requests, wiring to Radarr/Sonarr/Jellyfin |

| **Bazarr** | Subtitles — auto-downloads subs for your library | Subtitle status, connectivity |

| **Recyclarr** | Quality profiles — syncs TRaSH Guide configs | Sync, verify, instance management |

| **FlareSolverr** | Cloudflare bypass for indexers | Connectivity check |

| **Watchtower** | Auto-updates containers | Container status |

| **+ 14 optional** | Lidarr (music), Readarr (books), Tdarr (transcoding), Tautulli (stats), etc. | Varies by service |



### How tools compare



| Tool | Services | Deploy | Configure | Diagnose | CLI/JSON | Agent Skills |

|------|----------|--------|-----------|----------|----------|--------------|

| Docker Compose | containers only | yes | — | — | — | — |

| Recyclarr/Profilarr | Radarr, Sonarr | — | quality profiles | — | Recyclarr CLI | — |

| Managarr | Radarr, Sonarr, misc | — | browse | — | — | — |

| **Admirarr** | **all 10 + 14 optional** | yes | yes | 34 checks | yes | SKILL.md + 3 agents |







## Install



```bash

curl -fsSL https://get.admirarr.dev | sh

```



Other methods



```bash

brew install maxtechera/tap/admirarr              # Homebrew

go install github.com/maxtechera/admirarr@latest  # Go

yay -S admirarr-bin                               # Arch AUR

dpkg -i admirarr_*.deb                            # Debian/Ubuntu

irm https://get.admirarr.dev/windows | iex        # Windows PowerShell

```







## Contributing



```bash

git clone https://github.com/maxtechera/admirarr.git

cd admirarr && go build -o admirarr . && go test ./...

```







## License



[MIT](LICENSE)



---





  Built with ⚓ by maxtechera