pi-cider

Pi extension for Cider Apple Music client - control playback, queue management, and more via RPC

Package details

← Back
extensionskill

Install pi-cider from npm and Pi will load the resources declared by the package manifest.

npm repohome report
$ pi install npm:pi-cider
Package
pi-cider
Version
1.0.18
Published
Apr 27, 2026
Downloads
2,293/mo · 350/wk
Author
serlismaldonado
License
MIT
Types
extension, skill
Size
141.4 KB
Dependencies
0 dependencies · 3 peers
Pi manifest JSON
{
  "extensions": [
    "./index.ts"
  ],
  "skills": [
    "./skills"
  ]
}

Security note

Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.

README

Pi Cider Extension

Control Apple Music through Cider client from Pi. Shows now playing in status bar.

Status Bar

The extension automatically displays the currently playing song in Pi's status bar footer. Updates every turn end.

Configuration

Set your Cider API token in one of these ways:

Option 1: Environment file (recommended for local development)

# Create .env file in the extension directory
CIDER_API_TOKEN=your-token-here

Option 2: Pi auth.json (simple)

{
  "cider": {
    "type": "api_key",
    "key": "your-cider-api-token"
  }
}

Option 3: Pi auth.json (with env prefix)

{
  "env:CIDER_API_TOKEN": "your-cider-api-token"
}

The env: prefix injects the value as an environment variable, which some setups prefer.

Environment variables (optional):

  • CIDER_HOST - Cider server host (default: localhost)
  • CIDER_PORT - Cider server port (default: 10767)

Tools

Tool Description
cider_status Check if Cider is running
cider_now_playing Get current track info
cider_play Resume/start playback
cider_pause Pause playback
cider_play_pause Toggle play/pause
cider_next Skip to next track
cider_previous Go to previous track
cider_is_playing Check if music is playing
cider_volume Get/set volume (0-1)
cider_seek Seek to position (seconds)
cider_queue View playback queue
cider_play_url Play song by Apple Music URL
cider_toggle_shuffle Toggle shuffle mode
cider_toggle_repeat Toggle repeat mode
cider_search Search Apple Music catalog

Setup Cider RPC

  1. Open Cider → Settings → Connectivity
  2. Click "Manage External Application Access to Cider"
  3. Generate API token
  4. Copy the token for use above

Note: The API uses the apptoken header (not apitoken).

Install

pi install pi-cider