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 app boots cleanly.

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

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

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

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

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.

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.

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

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

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

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).

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).

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).

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).

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).