sonoscli

Control Sonos speakers on the local network via the sonos CLI.

Updated Mar 7, 2026
One-click install
npx skills add https://github.com/shalevamin/Tau_agent --skill sonoscli-shalevamin
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: sonoscli
Source: https://github.com/shalevamin/Tau_agent/tree/main/tau-agent-main/skills/sonoscli
Command: npx skills add https://github.com/shalevamin/Tau_agent --skill sonoscli-shalevamin

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Managing Sonos speakers typically requires the official mobile app, making it hard to automate playback, grouping, and volume control from scripts or AI-driven workflows. This Skill exposes speaker discovery, playback, grouping, and queue management through the sonos command-line tool. ## Core Features & Use Cases - Speaker Discovery & Status: Find Sonos devices on the LAN via SSDP and inspect their current state with sonos discover and sonos status. - Playback & Volume Control: Play, pause, stop, and set volume on named speakers, plus manage groups with join, unjoin, party, and solo modes. - Favorites, Queue & Spotify Search: List and open favorites, manage the playback queue, and search Spotify tracks through SMAPI. - Use Case: Ask the agent to lower the Kitchen speaker volume and group it with the Living Room speaker for a dinner party, all without opening the Sonos app. ## Quick Start Use the sonos CLI to discover speakers on my network and set the Kitchen speaker volume to 15.

Frequently Asked Questions about sonoscli

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I control Sonos speakers from the command line?

Install the sonos CLI via Go, then run commands like sonos discover to find speakers and sonos play, pause, or volume set with the --name flag to target a specific speaker. Grouping, favorites, and queue commands are also available.

How to group Sonos speakers using a CLI?

Use sonos group commands to manage speaker grouping. Run sonos group status to view current groups, then sonos group join, unjoin, party, or solo to combine or separate speakers on the network.

Can I search Spotify from the Sonos CLI?

Yes, use sonos smapi search with the --service Spotify flag and a category like tracks to search Spotify through SMAPI. Optional Spotify Web API search requires SPOTIFY_CLIENT_ID and SPOTIFY_CLIENT_SECRET environment variables.

Why does sonos discover fail with no route to host?

This SSDP error occurs on macOS when Local Network permission is disabled for the parent process such as node, Terminal, or Visual Studio Code. Enable it in Settings under Privacy & Security, or run inside a Docker sandbox with network access.

What to do when sonos discover says bind operation not permitted?

This error means the process runs inside a sandbox that blocks network access, such as a Codex CLI session with sandboxing enabled. Approve the escalation request or run the command outside the sandboxed environment.