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.01461 |
| Opus 5 | $0.00032 | $0.00731 |
| Sonnet 5 | $0.00013 | $0.00292 |
| Haiku 4.5 | $0.00006 | $0.00146 |
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 13d 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 — 126 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 eight 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 |
That is the whole surface. Do not promise the user control beyond it; in particular there is no tool to toggle continuous auto-queue.
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.
- 13d 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,335 stars, last pushed 2d ago), licensed MIT. It adds 63 tokens to every session and 1,461 once invoked, about $0.0003 per session on Opus 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
spotify
Spotify API integration — playback control, playlists, search, recommendations.
c-music
Control Spotify playback using the spogo CLI. Play, pause, skip, search tracks/albums/playlists, manage the queue, and browse your library.
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.
cw-gates
Use before claiming any Codewhale change is done, green, or ready to land: the focused-to-broad verification ladder, the budget checks CI enforces, and the rules for what counts as a passing test.
contributor-onboarding
Help a new contributor get productive on this checkout - inspect sync state against main, build, run the repository's exact verification gate, and produce a local what's-new digest. Never fetches, pulls, or modifies a dirty tree on its own. Explicit-only.