Spotatui is a Rust terminal music player that can stream Spotify and play music from local files, Subsonic or Navidrome servers, internet radio, YouTube, and Qobuz. It is a standalone, community-maintained successor to spotify-tui with features such as synced lyrics and an audio visualizer.
Getting it into your agent
One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.
npx skills add LargeModGames/spotatui --skill spotatui-djgit clone --depth 1 https://github.com/LargeModGames/spotatuiWrote this? Show the measurements
A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.
[](https://agentmods.dev/skills/largemodgames/spotatui/spotatui-dj)<a href="https://agentmods.dev/skills/largemodgames/spotatui/spotatui-dj"><img src="https://agentmods.dev/badge/skills/largemodgames/spotatui/spotatui-dj/github.svg" alt="Measured on agentmods" height="20"></a>Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.
<a href="https://agentmods.dev/skills/largemodgames/spotatui/spotatui-dj"><img src="https://agentmods.dev/badge/skills/largemodgames/spotatui/spotatui-dj.svg" alt="Reviewed on agentmods" width="80" height="20"></a>- NVIDIA SkillSpector pass
What it costs to keep this loaded
Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5.1 | $0.00063 | $0.01685 |
| Opus 5.5 | $0.00025 | $0.00674 |
| Sonnet 5.5 | $0.00013 | $0.00337 |
| Haiku 4.5 | $0.00006 | $0.00169 |
Grade A, and why
spotatui-dj scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 16d ago.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Nothing flagged
None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.
How it starts
The opening of the file, as written. The whole thing — 138 lines — stays where its author put it; the contents beside it link to each section on GitHub.
DJ for spotatui
You control a music player the user is watching. Every change you make raises a visible status message in their TUI, so act deliberately and report what happened.
Before anything else
The spotatui tools are visible whenever the plugin's server is registered.
In Claude Code a plugin's tools carry the plugin's own prefix, so they read
mcp__plugin_spotatui_spotatui__… here rather than the mcp__spotatui__… a
hand-registered server would give. Whether a call succeeds is a separate
question: that additionally needs spotatui itself running, built with
--features mcp-server, and configured with behavior.mcp_enabled: true.
Otherwise the tools are still listed and every call reports that spotatui is not
available.
If the tools are missing or every call reports spotatui is not available:
spotatui mcp status # safe, returns immediately, exits non-zero on the failing step
Then follow https://raw.githubusercontent.com/LargeModGames/spotatui/main/docs/mcp-setup.md.
Never run spotatui mcp to test anything. That command is the server: it
reads JSON-RPC from stdin and blocks until the stream closes, so it will look like
a hang and teach you nothing. Do not try to start spotatui yourself either; it is a
full-screen terminal app and needs a real terminal. Ask the user to start it.
The tools
| Tool | Use it for |
|---|---|
get_listening_history |
Aggregate taste summary: top artists, tracks, albums, recent plays, current vibe, now playing |
get_now_playing |
Current track, whether playback is active, queue_depth |
get_queue |
Upcoming tracks, in play order |
search_tracks |
Find tracks and their URIs; each result marked owned or new |
queue_tracks |
Add tracks by uri, or by title + artist |
play_now |
Start one track immediately |
skip_track |
Skip to the next track |
set_dj_vibe |
Record a standing direction for the built-in auto-queue DJ |
list_playlists |
Their playlists with URIs, track counts and owned |
get_album |
An album's artists, release year and tracks, each with a URI |
get_artist |
An artist's top tracks and albums, each with a URI |
list_devices |
Their Spotify Connect devices and which one is active |
transfer_playback |
Move playback to another Connect device, by id or name |
create_playlist |
Create a playlist, optionally with tracks |
add_to_playlist |
Add tracks to a playlist they own or collaborate on |
remove_from_playlist |
Remove one track by URI and 0-based position; destructive |
like_tracks |
Add tracks to Liked Songs, or remove them with liked: false |
follow_artist |
Follow an artist, or unfollow with follow: false |
What this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- 16d ago Changed · +12 lines 65fb9592b0ca
- 1mo ago First seen · 126 lines · 63 tokens per session scan A 1cea85f52580
spotatui-dj is a skill published in the GitHub repository LargeModGames/spotatui (1,769 stars, last pushed yesterday), licensed MIT. It adds 63 tokens to every session and 1,685 once invoked, about $0.0003 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.
Other skills, from other repositories
c-music
Control Spotify playback using the spogo CLI. Play, pause, skip, search tracks/albums/playlists, manage the queue, and browse your library.
spotify
Spotify API integration — playback control, playlists, search, recommendations.
social-spotify-card
Spotify Now Playing-style card with album art, progress bar, and playback controls, suited to video overlays or personal homepages.
spotify-player
Terminal Spotify playback/search via spogo (preferred) or spotifyplayer.
codew-release-qa-sweep
Use before claiming Codewhale release work is done: run the full gate sweep and list the manual QA targets.
gh-find-prs
Survey open Codewhale PRs and triage each for mergeability and disposition against the real landing branch.