Recipes

Recipes are the point of a CLI-first music app. Each one starts with a thing you actually want.

Play something from fuzzy search

spotuify search "luther vandross" --type track --format ids \
  | fzf \
  | xargs spotuify play-uri

What you get: a fast terminal picker that starts the selected track.

Queue a small search set

spotuify search "burial" --type track --limit 5 --format ids \
  | spotuify queue add --format json

What you get: the first five matching track URIs queued through the daemon.

Make a playlist from an agent plan

spotuify playlist plan "songs about exile and returning home" --format json > plan.json
spotuify resolve-tracks --from plan.json --format jsonl > candidates.jsonl
spotuify playlist create "Exile and Return" --from candidates.jsonl --dry-run

What you get: a preview. Commit after approval:

spotuify playlist create "Exile and Return" --from candidates.jsonl --yes --format json

Inspect unresolved candidates

jq -r 'select(.status != "resolved") | [.query, .reason] | @tsv' candidates.jsonl

What you get: rows the agent should fix before a playlist write.

Status line

spotuify status --format json \
  | jq -r 'if .item then .item.name + " - " + .item.subtitle else "not playing" end'

What you get: a now-playing string for tmux or a shell prompt.

Emergency quiet

spotuify pause
spotuify volume 30

Agent prompt that works

I need focused, hopeful music for a long coding session.
Use spotuify search and playlist plan. Show me the candidate list and
the playlist create --dry-run output. Do not run --yes until I approve.