jaychempan/coding-with-beat/cwb

coding-with-beat — Music Control

You have a coding-with-beat MCP server running locally. Use its tools to control music without leaving the coding session.

When to activate

• User says: "play", "pause", "skip", "next", "what's playing", "volume", "lyrics"
• User names a song, artist, or genre: "play some lofi", "put on 周杰伦"
• User types cwb <command> or /cwb <command>
• User asks about DJ Buddy or music status

Available MCP tools

Call these tools directly — do not shell out to cwb unless MCP is unavailable.

Natural language examples

Scene dispatch — mood / vibe / scene requests

Do NOT generate keywords. For any request that isn't a specific song/artist/command, match to a scene below and call smart_search once with queries=[angle1, angle2, angle3]. Do NOT call smart_search three separate times — each call overwrites the queue, corrupting play_number() indices.

Display results grouped by angle with emoji labels (returned by the tool), number globally across groups (1, 2, 3…), end with: 喜欢哪首？说编号我来播。 Do NOT auto-play.

Loved / 喜欢列表

When user says: 从喜欢里 / 收藏里找 / 我喜欢的 / loved only / play from liked / 心动歌单 → call search_loved(query) instead of smart_search()

When user says: 列出收藏 / 我的喜欢 / show liked / list loved / 喜欢列表 → call list_loved()

Normal smart_search() already includes loved tracks (ranked first, tagged [♥ 喜欢]).

Tips / 帮助

When user says: DJ 能做什么 / DJ Buddy 能做什么 / DJ 有什么指令 / DJ 怎么用 / ask DJ / DJ help / what can DJ do → call tips()

Library-only search

When the user explicitly restricts the search to their local library — trigger phrases include:

• 中文: "从资料库找"、"资料库里有没有"、"我已经有这首"、"本地库里"
• English: "in my library", "library only", "do I have", "from my library"

Do this:

1. Call search(query) as normal.
2. From the results, only show entries where `source == "library"`.
3. If none are found, tell the user: "资料库里没找到，要不要搜一下线上？" — do NOT auto-expand to catalog.

Do NOT call list_library for this — search() is more targeted. list_library is only useful when the user wants to browse all tracks without a specific query.

play_number — number parsing

Always parse the user's number expression before calling play_number(N):

Chinese ordinals 第一/第二/第三/第四/第五 map to 1/2/3/4/5. Always resolve before calling.

play_number recovery — index out of bounds

When play_number(N) returns an error containing "only", "had", "items", or "out of range":

1. If the scene queries are visible in the current conversation: immediately call smart_search(queries=[...]) again with the same queries, then call play_number(N).
2. If the scene is not visible: ask once — "队列已被刷新，你想播哪个场景的第 N 首？" — then re-search and play.

Do NOT tell the user to re-search manually. Always recover automatically when context is available.

Setup check — first-time installation

Do not run a shell curl preflight against /mcp. Streamable HTTP MCP endpoints are not plain health-check URLs, and Codex shell sandboxing may block local sockets even when the MCP tools are available.

Use the MCP tools as the source of truth:

1. If mcp__coding_with_beat__ tools are available, call the requested tool directly.
2. If MCP tools are unavailable or the MCP call itself reports the server is unreachable,

fall back to the cwb CLI commands below.

1. If both MCP and CLI are unavailable, tell the user and offer the one-liner:

coding-with-beat 还没安装。运行下面这行来一键安装：
 
curl -LsSf https://raw.githubusercontent.com/jaychempan/coding-with-beat/main/bootstrap_codex.sh | sh
 
安装完重开一个 shell 和 Codex session，状态栏出现 (•_•) 就好了。

CLI fallback

If MCP tools are unavailable, fall back to the cwb CLI:

cwb play "query"        # search and play
cwb play <n>            # play track #n from last search (NOT cwb play-number)
cwb pause               # pause
cwb next                # skip
cwb np                  # now playing
cwb volume 70           # volume
cwb like                # like current
cwb search "query"      # search without playing
cwb loved               # list all loved/hearted tracks
cwb search_loved "q"    # search within loved tracks only

Response style

After any music action, give a one-line confirmation: ▶ Now playing: Midnight City — M83. No extra commentary unless the user asks.