Agent skill · magnus919
transistor
Manage Transistor.fm podcast hosting from the terminal: view shows,
What it needs
About 2k tokens when loaded.
What this skill does
transistor-cli — Transistor.fm Podcast Hosting Manage your Transistor.fm podcast shows, episodes, subscribers, and analytics from the terminal. Uses the Transistor.fm v1 REST API. Setup 1. Get your API key from Transistor.fm: Settings → API Keys (bottom of the page) 2. Set the environment variable: --help and --dry-run work without credentials. Essential Commands user — Current user info shows — List all shows Shows title, episode count, subscriber count, and ID. episodes — List episodes Get show IDs from transistor-cli shows --json. Shows season/episode numbers, title, status, duration, and publish date. analytics — Download and play analytics Shows total downloads and plays (when available). Global Flags All flags work in any position: Extra flag vs other CLIs: --force overrides internal safety checks (e.g. large limits). Known Gotchas API key from Settings → API Keys — Not from the user profile or account page. Navigate to Settings → API Keys at the bottom of the Transistor.fm dashboard. JSON:API format — Transistor uses the JSON:API spec. All responses are nested under a data key, and attributes are under data[].attributes. The CLI unwraps these for display, but raw JSON output shows the full JSON:API structure. Show IDs are required for filtered queries — Use transistor-cli shows --json to get show IDs first, then pass them to --show for episodes and analytics. Pagination uses cursor-based pagination — The --limit flag controls the page size. Default is 20 for episodes. The API returns meta with pagination info. Analytics are totals only — The analytics endpoint returns aggregate totals (downloads, plays). Per-episode analytics are not available via this CLI. Transistor API is append-only via this CLI — The CLI implements GET endpoints for reading. Creating/updating shows or episodes is not covered here. Rate limits — Transistor.fm has rate limits. The CLI does not auto-retry on 429 responses. References scripts/transistor-cli — The CLI binary. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills magnus919/transistor