ahembree/librariarr

tracearr-api

Reference for the Tracearr public REST API (self-hosted Plex/Jellyfin/Emby playback monitoring). Use when adding, debugging, or extending Tracearr API calls (watch history, active streams, users, libraries, response schemas).

run-librariarr

Launch, build, run, start, screenshot, or smoke-test the Librariarr Next.js webapp end-to-end. Use when asked to run librariarr, bring up the dev stack, take a screenshot of the dashboard or any UI page, verify a change in the running app, or check that the…

api-route

Generate a new Next.js API route with project boilerplate (auth, validation, sanitize, Prisma). Use when creating new API endpoints.

api-test

Generate an integration test for an API route with all required mocks and boilerplate. Use when creating tests for API endpoints.

conventions

Quick reference for all Librariarr project conventions and patterns. Consult when writing or reviewing code to verify correct patterns.

prisma-migration

Create a Prisma migration file for schema changes. Required for production — db push only works in dev. Use after modifying schema.prisma.

scaffold-feature

Scaffold a complete new feature end-to-end (Prisma model, migration, schemas, API routes, tests). Use for new CRUD resources or features that span multiple layers.

zod-schema

Add a new Zod validation schema to src/lib/validation.ts. All schemas MUST live in this file using zod/v4. Use when creating validation for new API endpoints.

doc-feature

Create or update feature documentation in the Astro Starlight docs site. Use when adding new features or updating existing documentation.

emby-api

Reference for the Emby REST API. Use when adding, debugging, or extending Emby API calls (server queries, library/item lookups, playback control, response schemas).

jellyfin-api

Reference for the Jellyfin REST API. Use when adding, debugging, or extending Jellyfin API calls (server queries, library/item lookups, playback control, response schemas).

lidarr-api

Reference for the Lidarr v1 REST API. Use when adding, debugging, or extending Lidarr API calls (new endpoints on LidarrClient, query/command payloads, response schemas).

plex-api

Reference for the Plex Media Server REST API. Use when adding, debugging, or extending Plex API calls (library/section queries, sessions, playback, collections, server identity, response schemas).

radarr-api

Reference for the Radarr v3 REST API. Use when adding, debugging, or extending Radarr API calls (new endpoints on RadarrClient, query/command payloads, response schemas).

seerr-api

Reference for the Seerr REST API (the project that merges Overseerr and Jellyseerr). Use when adding, debugging, or extending Seerr API calls (requests, search, settings, user/session control, response schemas).

sonarr-api

Reference for the Sonarr v3 REST API. Use when adding, debugging, or extending Sonarr API calls (new endpoints on SonarrClient, query/command payloads, response schemas).