# Coding with Beat

码上律动

Interactive Music · Context-Aware · Flow-Boosting

AI Coding in Flow → Mood Managed → Productivity Elevated
WITHOUT MUSIC IN TERMINAL
Break in Flow
$ npm test
PASS src/app.test.ts
PASS src/utils.test.ts
Test Suites: 2 passed
Lose Focus. Lose Momentum. >_ ⇌ ♪
VS
A NEW MUSIC PARADIGM
Stay in Flow
$ cwb vibe: focus
● Deep Focus Playlist
♪ Lofi Essence — Calm Dawn ▓▓▓▓░░
DJ BUDDY: Great progress! Keep it going. ♪

    ╔════╗
    ╱[│♫♪│]╲
     │^‿^│
     ╚════╝
     ▐████▌
     ▐█  █▌
     ╱█  █╲

Stay Focused. Code Better.
Music in Terminal
Control & play music without leaving your flow
Context-Aware
Vibe engine maps your coding state to the right music
Boost Productivity
The right music for the right moment
DJ Buddy
Affective companion that understands you
Native Integration
Built as MCP tools for Claude Code & Codex CLI
works with
Claude Code
Codex CLI
Any Terminal
music sources
Apple Music
QQ Music
Local Files

one-command install

Claude Code bootstrap.sh
$ curl -LsSf https://raw.githubusercontent.com/jaychempan/coding-with-beat/main/bootstrap.sh | sh ▌

Or: manual install →

ask anything

Claude Code / Codex CLI
put on something chill
♪
▶ Playing Quiet Library — FM STAR · Apple Music
what's on right now?
♪
♪ 雨爱 — 杨丞琳 ▓▓▓▓▓░░░░ 2:14 / 3:42
skip this track
♪
⏭ Next: Snowfall — Øneheart · rvsefall
all tests passed! 🎉
♪
🕺 Victory mode! ▶ Eye of the Tiger — Survivor
(•_•) ⚡ ▶ 雨爱 — 杨丞琳 ██████░░░░░░░░ [build] ▃▆█▆▃ │ ♪ 不忍揭曉的劇情

demo

more screenshots

features

- ▸
  MCP Server 38 tools — just say "play some lofi" or "skip this" inside Claude Code.
- ▸
  /cwb Skill Routing brain: mood → smart search, artist → catalog, "play 3" → play_number. No guessing.
- ▸
  Apple Music + Local + QQ AppleScript-driven, no GUI needed. Local afplay fallback. QQ Music 30s preview.
- ▸
  Playlists List and play Apple Music playlists by name — user-created or subscription. Queue syncs to cwb watch.
- ▸
  Play History Recently played tracks from Apple Music's native history. history_search recommends new music based on your listening patterns.
- ▸
  Vibe Engine Hooks track git commits, test runs, and tool calls — buddy reacts in real time.
- ▸
  Karaoke & Live Player Full-screen LRC lyrics, album art in ANSI half-block, GameBoy retro border.
- ▸
  Statusline One line: mood face + track + progress bar + beat wave + current lyric.

smart search scenes

🎧Lofi
lofi · 深夜写代码 · chillhop
🧠Focus
专注 · ambient · flow state
🔥Hype
workout · 充能 · 运动
☕Jazz
jazz · 咖啡馆 · bossa nova
🌆Synthwave
synthwave · 赛博 · 夜驾
🌅Relax
放松 · unwind · 下班
🎹Classical
古典 · 钢琴 · classical
💙Sad
伤感 · heartbreak · 难过
🎉Party
party · edm · 蹦迪
🏮Chinese
国风 · 华语 · 古风
🌙Sleep
助眠 · sleep · 白噪音

music sources

Apple Music
✓ full playback
✓ lyrics / art
✓ like / seek
Local Files
✓ afplay
⚠ no like
⚠ seek via restart
QQ Music
⚠ 30s preview
✓ search
✓ like

user research

    ╔════╗
    ╱[│♫♪│]╲
     │^‿^│
     ╚════╝
     ▐████▌
     ▐█  █▌
     ╱█  █╲

Help Us Improve CWB
Share your experience with DJ Buddy — how music matches your coding mood, whether the companion check-ins feel helpful, and what you'd love to see next.
Music Quality
Flow & Focus
Companion Mode
Overall Rating
Take the Survey → ~8 min · Anonymous · 37 questions
Your Ideas → Acknowledged in Our Technical Report
Submit a feature suggestion or research insight via GitHub Issues. Contributors whose ideas meaningfully shape the study may be named in the acknowledgements of our technical report.
Submit a Suggestion → GitHub Issues · Open to everyone · Technical Report

changelog

2026-05-28
v0.3.8 Music Profile & HTML Report latest

- Get a visual music profile — ask "show my music profile" and a full HTML report opens in your browser
- Dashboard includes daily listening chart, heatmap, word cloud, and a loved tracks wall
- Personality-matched recommendations generated from your actual listening data

release notes ↗
2026-05-25
v0.3.7 Play History & Recommendations

- See your full listening history — including tracks played on your iPhone
- Ask DJ Buddy to recommend music based on what you actually listen to
- Songs you haven't heard in a while get surfaced too

release notes ↗
2026-05-24
v0.3.6 Loved Tracks & User Survey

- Play songs you've liked in Apple Music — just say "play from my favorites"
- DJ Buddy remembers your loved picks and suggests them first
- Added a survey so you can help shape what comes next

release notes ↗
Show older versions ▾
2026-05-24
v0.3.5 DJ Buddy Companion Mode

- DJ Buddy checks in on you — when you start, when tests keep failing, and when you ship
- Stuck on failing tests? DJ suggests music to help you reset and refocus
- Every check-in feels like a message from a bandmate, not a notification

release notes ↗
2026-05-24
v0.3.0 Smart Search & Playlists

- Describe a mood and get music from multiple angles — all in one search
- Just type a vibe like "chill late night" — the AI figures out the rest
- Browse and play your Apple Music playlists by name

release notes ↗
2026-05-23
v0.2.5 Continuous Playback & Queue Navigation

- Skip forward and back within your current playlist or search results
- Music keeps playing automatically — no need to pick the next track
- Pick a track by number and it always plays from the right list

release notes ↗
2026-05-23
v0.2.0 Codex CLI Support

- Works in Codex CLI too — one script installs everything
- Control Apple Music on your Mac from a remote server over SSH
- Built-in Pomodoro timer shows your work sessions right in the statusline

release notes ↗
2026-05-22
v0.1.2 Pixel DJ Animation Upgrade

- DJ Buddy moves with a more natural, flowing walk animation
- Commits a victory dance; failing tests send DJ into a panic — your workflow in motion

release notes ↗
2026-05-22
v0.1.1 Search & Play by Number

- Search your library and Apple Music — get a numbered list, then say "play 3"
- New commands to play by number and list all tracks

release notes ↗
2026-05-21
v0.1.0 Initial Release

- Control music with natural language — play, pause, skip, search, and like, all from your terminal
- Meet DJ Buddy: the pixel character that lives in your statusline
- Works with Apple Music, local files, and QQ Music from day one

release notes ↗

related projects

▸
CCF DDL Tracker Academic deadline tracker for CCF conferences.
↗ ▸
Citation Tracker Monitor citation counts for your papers in real time.
↗