docs

// commands and usage

get started

$ npm i -g herziesclick to copy

commands

herzies

Launch the live dashboard — your herzie dances while you listen to music and earns XP in real time.

herzies hatch

Hatch a new herzie with a random appearance. This is the first thing you run.

herzies status

Quick snapshot of your herzie — level, stage, XP, top genres, and friend code.

herzies login

Log in to sync your herzie across devices.

herzies friends

List your friendzies.

herzies friends add <code>

Add a friendzie by their code. Friends give bonus XP.

herzies friends remove <code>

Remove a friendzie.

herzies start

Start background listening — your herzie earns XP without keeping a terminal open.

herzies stop

Stop background listening.

herzies autostart on|off

Auto-start the background daemon when you log in to your Mac.

herzies kill

Permanently delete your herzie and all local data.

requirements

macOS with Apple Music or Spotify. Linux and Windows support is coming.