feat!: add CLI interface for TsArr (#81)

* feat: add Bazarr client for subtitle management (#53)

Add complete type-safe BazarrClient to the Tsarr SDK, providing access to Bazarr's subtitle management API with 50+ methods covering series, episodes, movies, providers, and system operations.

Changes:
- Add BazarrClient class with comprehensive subtitle management methods
- Generate Bazarr API types and SDK from OpenAPI spec (v1.5.5)
- Update generation scripts to include Bazarr
- Export BazarrClient and Bazarr namespace from main index
- Add package.json exports for bazarr and bazarr/types

Co-authored-by: Claude Haiku 4.5 <noreply@anthropic.com>

* feat: add CLI interface for TsArr with full Servarr support

Add complete CLI for managing all 6 Servarr apps (Radarr, Sonarr, Lidarr, Readarr, Prowlarr, Bazarr) with interactive configuration, multiple output formats, shell completions, and connection diagnostics.

Fixes:
- Destructive commands now properly fail in non-TTY with --yes flag for automation
- Config init no longer leaks secrets between env/global/local scopes
- Local config read/write paths are consistent (walk up directory tree)
- Config init shows clean error message instead of stack trace in non-interactive mode
- Completions registry synced with actual command tree (removes stale Sonarr queue, adds Bazarr actions)

Features:
- Service command factory (DRY) for easy addition of new Servarr apps
- Config: global (~/.config/tsarr/config.json) + local (.tsarr.json) + env vars
- Output: --json (piped default), --table (TTY default), --quiet (IDs only)
- Commands: doctor (connection test), config init/set/get/show, completions
- All 6 services with list/get/search/delete/status/health actions
- Interactive prompts for missing required args
- Hey-api response unwrapping and paginated response handling

Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>

---------

Co-authored-by: Claude Haiku 4.5 <noreply@anthropic.com>

Author: robbeverhelst

README.md

@@ -7,31 +7,95 @@
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg?style=flat-square)](https://opensource.org/licenses/MIT)
 [![CI](https://github.com/robbeverhelst/Tsarr/workflows/CI/badge.svg)](https://github.com/robbeverhelst/Tsarr/actions)
 
-**Type-safe TypeScript SDK for Servarr APIs (Radarr, Sonarr, etc.)**
+**Type-safe TypeScript SDK and CLI for Servarr APIs (Radarr, Sonarr, etc.)**
 
-Tsarr provides type-safe TypeScript clients for all Servarr APIs, generated from their Swagger/OpenAPI specifications. Perfect for building automation tools, scripts, and applications to manage your media servers.
+Tsarr provides type-safe TypeScript clients and a CLI for all Servarr APIs, generated from their Swagger/OpenAPI specifications. Use it as an SDK in your code or as a standalone CLI tool.
 
 ## Features
 
 - 🛡️ **Type-safe** - Generated from official Swagger/OpenAPI specs
 - ⚡ **Bun-optimized** - Leverages native fetch API
 - 📦 **Modular** - Separate clients for each Servarr app
+- 💻 **CLI included** - Manage all Servarr apps from the terminal
 
 ## Supported Servarr Apps
 
 - **Radarr** - Movie collection manager
-- **Sonarr** - TV series collection manager  
+- **Sonarr** - TV series collection manager
 - **Lidarr** - Music collection manager
 - **Readarr** - Book collection manager
 - **Prowlarr** - Indexer manager
+- **Bazarr** - Subtitle manager
 
 ## Installation
 
 ```bash
+# As a dependency (SDK)
 bun add tsarr
+
+# As a global CLI
+bun add -g tsarr
+```
+
+## CLI
+
+### Setup
+
+```bash
+# Interactive setup wizard
+tsarr config init
+
+# Or configure manually
+tsarr config set services.radarr.baseUrl http://localhost:7878
+tsarr config set services.radarr.apiKey your-api-key
+
+# Or use environment variables
+export TSARR_RADARR_URL=http://localhost:7878
+export TSARR_RADARR_API_KEY=your-api-key
+```
+
+Config is stored in `~/.config/tsarr/config.json` (global) or `.tsarr.json` (local project). Environment variables take priority over config files.
+
+### Usage
+
+```bash
+tsarr <service> <resource> <action> [options]
+
+# Examples
+tsarr radarr movie list
+tsarr radarr movie search --term "Interstellar"
+tsarr sonarr series list
+tsarr prowlarr indexer list
+tsarr lidarr artist search --term "Radiohead"
+
+# Output formats
+tsarr radarr movie list --table    # Table (default in terminal)
+tsarr radarr movie list --json     # JSON (default when piped)
+tsarr radarr movie list --quiet    # IDs only
+
+# Diagnostics
+tsarr doctor                       # Test all configured connections
+
+# Shell completions
+tsarr completions bash >> ~/.bashrc
+tsarr completions zsh >> ~/.zshrc
+tsarr completions fish > ~/.config/fish/completions/tsarr.fish
 ```
 
-## Quick Start
+### Available Commands
+
+| Service | Resources |
+|---------|-----------|
+| `radarr` | movie, profile, tag, queue, rootfolder, system, history, customformat |
+| `sonarr` | series, episode, profile, tag, rootfolder, system |
+| `lidarr` | artist, album, profile, tag, rootfolder, system |
+| `readarr` | author, book, profile, tag, rootfolder, system |
+| `prowlarr` | indexer, search, app, tag, system |
+| `bazarr` | series, movie, episode, provider, language, system |
+
+## SDK
+
+### Quick Start
 
 ```typescript
 import { RadarrClient, SonarrClient, LidarrClient } from 'tsarr';
@@ -46,6 +110,15 @@ const movies = await radarr.getMovies();
 const status = await radarr.getSystemStatus();
 ```
 
+### Modular Imports
+
+```typescript
+// Import only what you need
+import { RadarrClient } from 'tsarr/radarr';
+import { SonarrClient } from 'tsarr/sonarr';
+import type { MovieResource } from 'tsarr/radarr/types';
+```
+
 ## Development
 
 Install dependencies:
@@ -86,7 +159,7 @@ Perfect for building:
 - **Automation scripts** - Bulk movie imports, library maintenance, and media organization
 - **Management tools** - Custom dashboards, backup utilities, and monitoring scripts  
 - **Integration scripts** - Connect Servarr apps with other services and workflows
-- **CLI tools** - Command-line utilities for media server administration
+- **CLI usage** - Manage your media servers directly from the terminal
 
 ## Contributing
 

bun.lock

@@ -6,6 +6,9 @@
     "type": "git",
     "url": "https://github.com/robbeverhelst/tsarr.git"
   },
+  "bin": {
+    "tsarr": "./dist/cli/index.js"
+  },
   "main": "dist/index.js",
   "module": "dist/index.js",
   "devDependencies": {
@@ -86,20 +89,23 @@
     "typescript",
     "sdk",
     "api",
-    "bun"
+    "bun",
+    "cli"
   ],
   "license": "MIT",
   "publishConfig": {
     "access": "public",
     "registry": "https://registry.npmjs.org/"
   },
   "scripts": {
-    "build": "bun run generate && bun run generate:types && bun run build:js && bun run build:types",
+    "build": "bun run generate && bun run generate:types && bun run build:js && bun run build:cli && bun run build:types",
     "build:js": "bun build src/index.ts --outdir dist --target node --minify --splitting && bun build src/clients/radarr.ts --outdir dist/clients --target node --format esm && bun build src/clients/sonarr.ts --outdir dist/clients --target node --format esm && bun build src/clients/lidarr.ts --outdir dist/clients --target node --format esm && bun build src/clients/readarr.ts --outdir dist/clients --target node --format esm && bun build src/clients/prowlarr.ts --outdir dist/clients --target node --format esm && bun build src/clients/bazarr.ts --outdir dist/clients --target node --format esm",
+    "build:cli": "bun build src/cli/index.ts --outdir dist/cli --target bun --format esm && chmod +x dist/cli/index.js",
     "build:types": "tsc --project tsconfig.build.json",
     "prepublishOnly": "bun run build",
     "test": "bun test",
     "dev": "bun run src/index.ts",
+    "cli": "bun run src/cli/index.ts",
     "lint": "biome check .",
     "lint:fix": "biome check . --write",
     "format": "biome format . --write",
@@ -116,5 +122,9 @@
   },
   "sideEffects": false,
   "type": "module",
-  "types": "dist/index.d.ts"
+  "types": "dist/index.d.ts",
+  "dependencies": {
+    "citty": "^0.2.1",
+    "consola": "^3.4.2"
+  }
 }

package.json

@@ -0,0 +1,99 @@
+import { BazarrClient } from '../../clients/bazarr.js';
+import type { ResourceDef } from './service.js';
+import { buildServiceCommand } from './service.js';
+
+const resources: ResourceDef[] = [
+  {
+    name: 'series',
+    description: 'Manage series subtitles',
+    actions: [
+      {
+        name: 'list',
+        description: 'List series with subtitle info',
+        columns: ['sonarrSeriesId', 'title', 'profileId'],
+        run: (c: BazarrClient) => c.getSeries(),
+      },
+    ],
+  },
+  {
+    name: 'movie',
+    description: 'Manage movie subtitles',
+    actions: [
+      {
+        name: 'list',
+        description: 'List movies with subtitle info',
+        columns: ['radarrId', 'title', 'profileId'],
+        run: (c: BazarrClient) => c.getMovies(),
+      },
+    ],
+  },
+  {
+    name: 'episode',
+    description: 'Manage episode subtitles',
+    actions: [
+      {
+        name: 'wanted',
+        description: 'List episodes with wanted subtitles',
+        columns: ['sonarrEpisodeId', 'title', 'seriesTitle'],
+        run: (c: BazarrClient) => c.getEpisodesWanted(),
+      },
+    ],
+  },
+  {
+    name: 'provider',
+    description: 'Manage subtitle providers',
+    actions: [
+      {
+        name: 'list',
+        description: 'List subtitle providers',
+        run: (c: BazarrClient) => c.getProviders(),
+      },
+    ],
+  },
+  {
+    name: 'language',
+    description: 'Manage languages',
+    actions: [
+      {
+        name: 'list',
+        description: 'List available languages',
+        columns: ['code2', 'name', 'enabled'],
+        run: (c: BazarrClient) => c.getLanguages(),
+      },
+      {
+        name: 'profiles',
+        description: 'List language profiles',
+        columns: ['profileId', 'name'],
+        run: (c: BazarrClient) => c.getLanguageProfiles(),
+      },
+    ],
+  },
+  {
+    name: 'system',
+    description: 'System information',
+    actions: [
+      {
+        name: 'status',
+        description: 'Get system status',
+        run: (c: BazarrClient) => c.getSystemStatus(),
+      },
+      {
+        name: 'health',
+        description: 'Get system health',
+        run: (c: BazarrClient) => c.getSystemHealth(),
+      },
+      {
+        name: 'badges',
+        description: 'Get badge counts',
+        run: (c: BazarrClient) => c.getBadges(),
+      },
+    ],
+  },
+];
+
+export const bazarr = buildServiceCommand(
+  'bazarr',
+  'Manage Bazarr (Subtitles)',
+  config => new BazarrClient(config),
+  resources
+);