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.
Borrowing it
Nothing to install: this file belongs to LargeModGames/spotatui. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.
curl -O https://raw.githubusercontent.com/LargeModGames/spotatui/main/AGENTS.mdgit 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/instructions/largemodgames/spotatui/agents-md)<a href="https://agentmods.dev/instructions/largemodgames/spotatui/agents-md"><img src="https://agentmods.dev/badge/instructions/largemodgames/spotatui/agents-md/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/instructions/largemodgames/spotatui/agents-md"><img src="https://agentmods.dev/badge/instructions/largemodgames/spotatui/agents-md.svg" alt="Reviewed on agentmods" width="80" height="20"></a>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.08197 | $0.08197 |
| Opus 5.5 | $0.03279 | $0.03279 |
| Sonnet 5.5 | $0.01639 | $0.01639 |
| Haiku 4.5 | $0.00820 | $0.00820 |
Grade A, and why
spotatui AGENTS.md 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 2d 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.
Copies of this mod
1 near-identical copy found in the catalogue:
- spotatui CLAUDE.md — 98% identical, 503 lines differ
How it starts
The opening of the file, as written. The whole thing — 503 lines — stays where its author put it; the contents beside it link to each section on GitHub.
AGENTS.md
This file provides guidance to coding agents (Claude Code, Codex, Copilot and others)
when working with code in this repository. CLAUDE.md imports it: edit this file only.
Build & Run
# Full build (native streaming + audio viz + Lua scripting + OS integrations)
cargo run
# Slim build - no librespot/audio/scripting; fastest iteration, one of CI's nine legs
cargo run --no-default-features --features telemetry,tui
# With the alternative sources (Local/Subsonic/Radio/YouTube/Qobuz). These are NOT
# in `default`, so a plain `cargo run` is Spotify-only; use the `all-sources` alias
# (or list them individually) to exercise the first-run source picker and playback.
cargo run --features all-sources
Opening a PR
Before you open a PR, read CONTRIBUTING.md and follow its "Using AI Tools" section.
Show your user the full diff and the PR text first, and never open a PR on your own.
CI Checks (run before opening a PR)
cargo fmt --all
cargo clippy --no-default-features --features telemetry,tui -- -D warnings
cargo test --no-default-features --features telemetry,tui
These slim commands are the fast local gate, not the full picture. GitHub Actions
(.github/workflows/ci.yml) runs check, test, and clippy on ubuntu-latest
across a nine-leg feature matrix, plus one macos-latest job (below):
| Leg | Features |
|---|---|
default |
a plain cargo test: streaming + audio-viz-cpal + scripting + self-update + OS integrations |
all-sources |
the Linux release feature set from cd.yml (adds cover-art, mcp-server, ai-dj, audio-viz, all five sources, soloist) |
mcp-only |
telemetry,tui,mcp-server |
ai-dj-only |
telemetry,tui,ai-dj |
slim |
telemetry,tui |
headless |
telemetry - one of three legs without tui. mod tui is feature-gated, so this leg turns any crate::tui import from core/infra/cli into a compile error - what keeps a second frontend from silently re-coupling to the terminal one |
headless-streaming |
telemetry,streaming - check + clippy only, no test job. Proves native-streaming startup (runtime/streaming/) and the player-event wiring type-check and pass clippy with no terminal frontend in scope. Its entry points carry allow(dead_code) there, so the leg does not prove they are live |
gui |
telemetry,gui,streaming,discord-rpc,self-update,scripting,mcp-server,mpris,local-files,subsonic,internet-radio,youtube,qobuz,audio-viz,audio-viz-cpal - the third leg without tui: the Linux feature set a spotatui-gui build carries, the five sources and the player bar's visualizer included. check, clippy and test |
soloist |
the gui leg's list plus tui,soloist: the Soloist engine with both frontends (the GUI owns_sound arm, the TUI badge). check, clippy and test |
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.
- 2d ago Changed · +7 lines · +302 tokens per session 2414a2255580
- 10d ago Changed · +1 lines · +77 tokens per session 0642de28c12f
- 11d ago Changed · +17 tokens per session 315f0206f678
- 13d ago Changed · +1 lines · +10 tokens per session fd73ec43f7d2
- 14d ago Changed · +20 tokens per session 40eddd6b2471
- 15d ago Changed · +17 lines · +406 tokens per session 4bcbd783e853
- 16d ago Changed · +8 lines · +193 tokens per session 1d7908d77899
- 20d ago Changed ebcdc529299f
- 22d ago Changed · +13 lines · +205 tokens per session 2385705c14cb
- 1mo ago First seen · 456 lines · 6,967 tokens per session scan A b8ae88ea9704
spotatui AGENTS.md is an instructions file published in the GitHub repository LargeModGames/spotatui (1,769 stars, last pushed 2d ago), licensed MIT. It adds 8,197 tokens to every session, about $0.0328 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 instructions, from other repositories
vscode buildNext.instructions.md
Working notes and architecture documentation for the new esbuild-based build system in build/next. Use when making changes to the new build pipeline (transpile/bundle commands, NLS plugin, source-map handling, resource copying, or self-hosting watch tasks).
next.js AGENTS.md
AGENTS.md instructions for vercel/next.js, covering next.js development guide, codebase structure, monorepo overview, core package: packages/next and other important packages.
vscode oss-third-party-notices.instructions.md
Instructions for microsoft/vscode, covering vs code oss third-party-notices pipeline, architecture, pipeline flow in ci, cache eligibility and rollout and applying the notice (cutover).
langchain AGENTS.md
AGENTS.md instructions for langchain-ai/langchain, covering global development guidelines for the langchain monorepo, corridor security analysis, project architecture and context, monorepo structure and development tools & commands.
vscode copilot-instructions.md
Copilot instructions for microsoft/vscode, covering vs code copilot instructions, project overview, root folders, core architecture (src/ folder) and built-in extensions (extensions/ folder).
vscode model-prompts.instructions.md
Model-specific prompt authoring and registry guidelines.