Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.rocksky.app/llms.txt

Use this file to discover all available pages before exploring further.

rocksky is a command-line interface for the Rocksky API. Use it to scrobble plays, inspect listening stats, manage API keys, and run the MCP / local scrobble servers.

​
Install

npm install -g @rocksky/cli

​
Common workflow

rocksky login alice.bsky.social     # one-time auth
rocksky whoami                       # confirm session
rocksky nowplaying                   # what's playing right now
rocksky scrobbles --limit 20         # your recent history
rocksky stats                        # listening stats

​
Commands

CommandDescription
loginAuthenticate with your Bluesky handle
whoamiShow the currently authenticated user
nowplayingShow the currently playing track
scrobblesList recent scrobbles
scrobbleRecord a track to your profile
searchSearch tracks, albums, and accounts
statsListening stats for a user
artistsTop artists for a user
albumsTop albums for a user
tracksTop tracks for a user
create apikeyGenerate a new API key
syncSync local data from the AT Protocol
mcpStart the MCP server for Claude and other LLMs
scrobble-apiRun a local Last.fm / ListenBrainz-compatible server
helpShow help for any command