1 files changed, 6 insertions, 4 deletions

diff --git a/README.md b/README.md
index 55ca02d..41ef0c3 100644
--- a/README.md
+++ b/README.md
@@ -66,9 +66,11 @@ servers.
 - `/senator` — chat with the OpenRouter model
 
 ### Music (songbird)
-- `/grajcuj` — play from Copyparty search, a direct URL, or an uploaded file
-- `/stop` — stop playback and leave voice
-- `/join` — join the caller's voice channel
+- `/music grajcuj` — play from Copyparty search, a direct URL, or an uploaded file; optional `position` (`now`, `next`, `last`, default `last`)
+- `/music queue` — show the current track followed by the pending queue
+- `/music skip` — stop the current track and play the next queued one
+- `/music stop` — stop playback, clear the queue, and leave voice
+- `/music join` — join the caller's voice channel
 
 ### TTS
 - `/tts` — local Piper TTS (Polish, Google Translate fallback), sent as a file or played in voice
@@ -112,7 +114,7 @@ servers.
 
 The runtime is organised around a shared `Data` struct (poise `user_data`)
 that holds the DB pool, HTTP client, Copyparty client, voice manager, the
-in-memory trigger cache, autocomplete cache, and per-guild music track handles.
+in-memory trigger cache, autocomplete cache, and per-guild music queue.
 
 - `src/main.rs` — boot: tracing, dotenvy, Config, DB pool, framework, cron task
 - `src/config.rs` — env-driven `Config` + variable validation