Sonos CLI

SkillDev tools

Lets your agent play music, adjust volume, and group Sonos speakers on your home network.

Available today. Use it from your connected AI after setup.

Connect ahel once, and every AI you use reads what you have installed.

Then ask your AI: use the Sonos CLI skill

About this capability

Control Sonos speakers (discover/status/play/volume/group).

What this skill tells your AI

The instructions your AI receives, as published by bitterbot-ai/bitterbot-desktop in skills/sonoscli/SKILL.md and read by ahel’s review.

Use sonos to control Sonos speakers on the local network.

Quick start

  • sonos discover
  • sonos status --name "Kitchen"
  • sonos play|pause|stop --name "Kitchen"
  • sonos volume set 15 --name "Kitchen"

Common tasks

  • Grouping: sonos group status|join|unjoin|party|solo
  • Favorites: sonos favorites list|open
  • Queue: sonos queue list|play|clear
  • Spotify search (via SMAPI): sonos smapi search --service "Spotify" --category tracks "query"

Notes

  • If SSDP fails, specify --ip <speaker-ip>.
  • Spotify Web API search is optional and requires SPOTIFY_CLIENT_ID/SECRET.

Signals

GitHub stars
2k
Forks
417
Last commit
Sep 2026
Advanced
Catalog kind
skill
Gateway key
sonoscli-bitterbot-ai
Source
github.com/bitterbot-ai/bitterbot-desktop