Overview

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

npx @rocksky/cli --help

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

Command	Description
`login`	Authenticate with your Bluesky handle
`whoami`	Show the currently authenticated user
`nowplaying`	Show the currently playing track
`scrobbles`	List recent scrobbles
`scrobble`	Record a track to your profile
`search`	Search tracks, albums, and accounts
`stats`	Listening stats for a user
`artists`	Top artists for a user
`albums`	Top albums for a user
`tracks`	Top tracks for a user
`create apikey`	Generate a new API key
`sync`	Sync local data from the AT Protocol
`mcp`	Start the MCP server for Claude and other LLMs
`scrobble-api`	Run a local Last.fm / ListenBrainz-compatible server
`help`	Show help for any command

Migrating from ListenBrainz login

Getting started

Integrations

Mirroring

Migrating

Rocksky CLI

Install

Common workflow

Commands

​Install

​Common workflow

​Commands

Install

Common workflow

Commands