Initial release

CLAUDE.md

@@ -0,0 +1,41 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+`arrman` is a CLI tool to do minimal management of Sonarr and Radarr
+Targeted to be used by AI agents via SKILL.md
+
+## Build & Test
+
+```bash
+go build -o arrman .
+go test ./...
+go test -run TestName ./pkg/...   # single test
+go vet ./...
+```
+
+## Architecture
+
+- Single self-contained Go binary, no external dependencies
+- Talks HTTPS to Sonarr (TV) and Radarr (films) v3 APIs using API tokens
+- CLI subcommand structure: `arrman [--json] {tv|film|films} {list|add|summary|profiles|rootfolders} [args]`
+- `--json` flag outputs structured JSON (arrays for lists, objects for single items)
+- Sonarr uses TheTVDB IDs for series lookup; Radarr uses IMDB IDs for film lookup
+- Config loaded from `.env` file (SONARR_URL, SONARR_API_KEY, RADARR_URL, RADARR_API_KEY)
+
+## Commands
+
+- arrman tv list
+- arrman tv list "<title>"
+- arrman tv list "<title>" --include-external
+- arrman films list
+- arrman films list "<title>"
+- arrman films list "<title>" --include-external
+- arrman tv add <title>|<thetvdb series ID> --profile <id> --rootfolder <path>
+- arrman film add <title>|<IMDB ID> --profile <id> --rootfolder <path>
+- arrman tv summary <title>|<thetvdb series ID>
+- arrman film summary <title>|<IMDB ID>
+- arrman tv profiles
+- arrman film profiles
+- arrman tv rootfolders
+- arrman film rootfolders