Save To Spotify

Save to Spotify

A command-line tool for saving audio content to Spotify. Built for agents and automation, generate a daily briefing, language lesson, or meeting recap, then push it to Spotify where it's available alongside your other listening.

What you can make

Point your agent at content you have, and get a finished episode on Spotify:

• Morning briefing — your calendar, tasks, and overnight repo activity as a 3-minute daily brief
• Deep dive — turn a topic, article, or PDF into a personalized audio explainer
• Meeting recap — drop in a transcript, get a 2-minute summary with action items
• Travel guide — a private audio itinerary for your next trip
• News roundup — a daily roundup from the newsletters, feeds, and sites you follow
• Bedtime story — a custom story using your kid's name and favorite setting

Describe what you want in plain English; the agent sources, scripts, narrates, and saves it.

Making the audio

This CLI saves audio to Spotify — it does not generate speech itself. You bring a voice engine:

• Kokoro (recommended) — free, local, no API key, no limits (~340 MB)
• OpenAI TTS — high quality, needs OPENAI_API_KEY
• ElevenLabs — most natural, needs ELEVENLABS_API_KEY

No key? Kokoro is the default. Already have an OpenAI or ElevenLabs key? The agent detects it and offers to use it — no extra setup.

Run save-to-spotify tts status to see what's available, or save-to-spotify tts add to register any other engine.

Quick Start

Prompt your agent to install:

> Install Save to Spotify by running https://saveto.spotify.com/install.sh

Installs the CLI and exposes the skill to Claude Code, Cursor, Codex, and any agent that reads .agents/skills/.

Once installed, invoke with /save-to-spotify (Claude Code) or $save-to-spotify (Codex), or just describe what you want in plain English.

Install

Curl-bash

Same script the Quick Start prompt runs:

curl -fsSL https://saveto.spotify.com/install.sh | bash

Common options:

# Pin a specific version
curl -fsSL https://saveto.spotify.com/install.sh | bash -s -- --version 0.2.0

# Custom install directory
curl -fsSL https://saveto.spotify.com/install.sh | bash -s -- --dir ~/.local/bin