---
title: "now-playing"
url: "https://claudemods.dev/zh-cn/builds/now-playing-7dfef7"
source: "https://github.com/hamzafer/claude-code-mods/tree/main/mods/now-playing"
source_type: "github"
repo: "https://github.com/hamzafer/claude-code-mods/tree/main/mods/now-playing"
author: "hamzafer"
author_handle: "hamzafer"
stars: 164
category: "其他"
categories: ["other"]
tags: []
permission_level: 3
scan_complete: true
install: "claude plugin marketplace add hamzafer/claude-code-mods\nclaude plugin install now-playing"
added: "2026-10-09T05:21:51.930Z"
updated: "2026-10-08T13:27:14Z"
locale: "zh-cn"
content_locale: "zh-cn"
---

# now-playing

Spotify 正在播放的内容，显示在提示符上方一行：曲目、进度和正在演唱的歌词，带有 ⏮ ⏸ ⏭ 按钮。/music 也能控制它。macOS。

## Description

<p align="center"><img src="images/claude-wave.gif" alt="" width="40"></p>

<h1 align="center">Claude Code 模组</h1>

<p align="center"><b>让 Claude Code 显示它正在做什么。</b><br>适用于 Claude Code 的插件，基于函数钩子构建：提示符上方的实时行、守卫、窗格和游戏。只安装你想要的。</p>

<p align="center">
  <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue.svg" alt="MIT"></a>
  <a href="https://github.com/hamzafer/claude-code-mods/actions/workflows/ci.yml"><img src="https://github.com/hamzafer/claude-code-mods/actions/workflows/ci.yml/badge.svg?branch=main" alt="CI"></a>
</p>

<p align="center">
  <a href="#-install">安装</a> · <a href="#-the-mods">所有模组</a> · <a href="docs/mods.md">文档</a> · <a href="https://claude.dev/blog/getting-started-with-claude-code-mods/">什么是模组？</a>
</p>

<table>
  <tr>
    <td align="center" width="33%"><a href="docs/mods.md#-context-bar"><img src="images/context-bar.png" alt="context-bar：Claude Code 上下文窗口用量以堆叠条形图显示，每个类别一种颜色" width="260"></a><br>📊 <b>context-bar</b><br>你的上下文被什么填满</td>
    <td align="center" width="33%"><a href="docs/mods.md#-review-watch"><img src="images/review-watch.png" alt="review-watch：在 Claude Code 中实时显示正在运行的 Codex 和子代理代码审查行" width="260"></a><br>🔍 <b>review-watch</b><br>正在运行的代码审查，实时显示</td>
    <td align="center" width="33%"><a href="docs/mods.md#-md-preview"><img src="images/md-preview.png" alt="md-preview：Claude Code 编辑的 Markdown，在 diff 旁边像 GitHub 一样渲染" width="260"></a><br>📝 <b>md-preview</b><br>像 GitHub 一样渲染的 Markdown</td>
  </tr>
  <tr>
    <td align="center" width="33%"><a href="docs/mods.md#-blast-radius"><img src="images/gallery/blast-radius.png" alt="blast-radius：一个 Claude Code 钩子拦住 rm -rf 并列出它将要删除的文件" width="260"></a><br>💥 <b>blast-radius</b><br>看看 <code>rm -rf</code> 会删除什么</td>
    <td align="center" width="33%"><a href="docs/mods.md#-now-playing"><img src="images/now-playing.png" alt="now-playing：Claude Code 内的 Spotify 曲目、进度条和同步歌词" width="260"></a><br>🎵 <b>now-playing</b><br>Spotify 及其歌词，实时显示</td>
    <td align="center" width="33%"><a href="docs/mods.md#-reels-and-snake"><img src="images/reels-demo.gif" alt="reels：Claude Code 工作时在窗格中播放 YouTube Shorts" width="260"></a><br>📱 <b>reels</b><br>Claude 工作时看 Shorts</td>
  </tr>
  <tr>

    <td align="center" width="33%"><a href="docs/mods.md#-where-am-i"><img src="images/gallery/where-am-i.png" alt="where-am-i：会话目标、当前步骤以及等待你处理的事项，位于 Claude Code 提示上方" width="260"></a><br>📍 <b>where-am-i</b><br>目标、现在、等待你处理</td>
    <td align="center" width="33%"><a href="docs/mods.md#-lines-above-the-prompt"><img src="images/gallery/lines.png" alt="token-weather、usage-meter 及其他 Claude Code 状态行堆叠在提示上方" width="260"></a><br>🌦️ <b>token-weather 及伙伴们</b><br>提示上方的行</td>
    <td align="center" width="33%"><a href="#mission-control"><img src="images/gallery/mission-control.png" alt="mission-control：Claude Code 子代理、工具调用及它们触及的文件，实时" width="260"></a><br>🛰️ <b>mission-control</b><br>代理与它们触及的代码</td>
  </tr>
</table>

## 🚀 安装

一次性添加市场，然后按名称安装任意 mod：

```sh
claude plugin marketplace add hamzafer/claude-code-mods
claude plugin install context-bar@claude-code-mods
```

或一次性安装通用套装：

```sh
for m in context-bar token-weather usage-meter where-am-i next-steps agent-radar review-watch replay-theater md-preview blast-radius mission-control; do
  claude plugin install "$m@claude-code-mods"
done
```

安装后重启 Claude Code。若想不安装就试用某个 mod：

```sh
git clone https://github.com/hamzafer/claude-code-mods && cd claude-code-mods
claude --plugin-dir mods/context-bar
```

> **需要** Claude Code 2.1.287+。少数 mod 需要更多（Chrome、`gh`、一个连接器）；表格中已注明是哪些。

## 🧩 这些 mod

### 👀 看看正在发生什么

| | Mod | 它做什么 | 命令 |
| --- | --- | --- | --- |
| 🛰️ | **mission-control** | 实时地图：agents、工具调用及它们触及的代码 | `/mission` |
| 📊 | **context-bar** | 你的上下文窗口以一条堆叠条形展示，每个类别一种颜色，带 token 计数及压缩发生的位置 | `/context-bar` |
| 🌦️ | **token-weather** | 上下文占用从 Clear 到 Compact soon，外加提示缓存倒计时 | |
| ⏱️ | **cache-clock** | 状态栏下方的一条提示缓存线，数据来自 Claude Code 自身：剩余时间、命中率与未命中，以及缓存变冷后你下一条消息会重新缓存的 token。需要 Node 和 Claude Code 2.1.251+ | `/cache-clock setup` |
| 📍 | **where-am-i** | 目标、当前在做、等你处理、下一步 | `/where` |
| ➡️ | **next-steps** | 每轮之后 2 或 3 个可能的下一步提示词，一键起草一个 | `1` `2` `3`，`0` 隐藏 |
| 💰 | **usage-meter** | 5 小时和 7 天套餐用量、重置倒计时和本次会话的花费 | |
| 💳 | **openai-balance** | 你的 OpenAI API 额度：带仪表盘的估算余额、今日花费、钱主要花在哪，以及最近一次调用。需要一个 OpenAI 组织 Admin 密钥 | `/openai-balance` |
| 📡 | **agent-radar** | 每个正在运行的子 agent 一条实时行 | `/radar` |
| 🔍 | **review-watch** | 每个正在运行的代码审查（Codex 或审查子 agent）一条实时行，带模型、目标、已用时间和 Codex 的最新输出。结束时用 toast 列出发现项 | |
| 🌐 | **browser-lanes** | 本次会话是否有浏览器，以及谁在用 | `/browser` |
| 🕌 | **prayer-times** | 当前拜功及剩余时间、下一次拜功，以及 zawal。在你的电脑上计算，哈乃斐或标准 Asr | `/prayers` |
| 🎬 | **replay-theater** | 逐帧回放上一轮的编辑，一次一个 diff | `/replay` |
| 📝 | **md-preview** | 像 GitHub 那样渲染 Claude 编辑的 Markdown 文件，前后并排。需要 Chrome 和能显示图片的终端 | `/md` |

### 🛡️ 保护你的仓库

| | 模块 | 功能 | 命令 |
| --- | --- | --- | --- |
| 💥 | **blast-radius** | 拦截 `rm -r`、强制推送和迁移，显示它们会删除什么，60 秒无应答后取消 | |

### 💸 少花钱

| | 模块 | 功能 | 命令 |
| --- | --- | --- | --- |
| 🔀 | **switchboard** | 为每个未指定模型的子代理挑选模型，仅根据其短标签，使用 [OpenAI 的 Decisions API](https://developers.openai.com/api/docs/guides/decisions) 或 [Jev](https://docs.typesafe.ai)。显示每个子代理的成本 | `/route` |

### 🔧 我的设置（分叉并调整）

这些是围绕我自己的工具和规则构建的。分叉它们，并将规则改为你的。

| | 模块 | 功能 | 命令 |
| --- | --- | --- | --- |
| 👀 | **glance** | 一行显示需要你处理的事项：下一个会议、PR、Linear 问题、Slack 私信。需要 `gh` 以及 Google Calendar、Linear 和 Slack 连接器 | `/glance` |
| 🚦 | **merge-gate** | 拦截 `gh pr merge`，直到 CI 通过且 Codex 审查过一次。需要 `gh` 和 Codex CLI。审查使用一个固定模型运行；把它改成你的 | `/gate` |
| 📏 | **rulebook-guard** | 强制执行我的写作和 git 规则：重写 em dash，在 `--amend`、未格式化的推送、笔记中的电子邮件和电话号码之前询问 | |
| 💾 | **session-saver** | 保存你上次离开的位置，在恢复时显示。需要 [unpause](https://github.com/hamzafer/unpause) | `/park [note]` |

### 🎮 娱乐（可选加入）

| | 模块 | 功能 | 命令 |
| --- | --- | --- | --- |
| 📱 | **reels** | Claude 工作时播放 YouTube Shorts，完成后暂停 | `/reels` |
| 🐍 | **snake** | Claude 工作时玩贪吃蛇 | `/snake` |
| 🎵 | **now-playing** | Spotify 正在播放什么，带进度条、正在唱的歌词以及 ⏮ ⏸ ⏭ 按钮。需要 macOS 和 Spotify 应用 | `/music` |

<a id="mission-control"></a>

## 🛰️ 旗舰功能：mission-control

每个子代理、每次工具调用以及它们接触的每个文件，都显示在聊天旁边的窗格中。以 4 倍速展示：两个子代理在四个文件中构建登出功能。

![mission-control 4 倍速：两个子代理和登出功能横跨四个文件落地](images/mission-control.gif)

像安装任何模组一样安装它，重启，然后输入 `/mission`（或 `/mission code` 打开代码地图）。`q` 关闭它。

- 🤖 `w` 实时显示代理和每次工具调用
- 🗺️ `c` 显示代码地图，附带导入箭头
- 🔵 **蓝色** 表示代理正在读取文件
- 🟠 **橙色** 表示正在写入
- 🟢 **绿色** 表示完成，并附一行说明改了什么

> 代码视图还需要 macOS、Google Chrome 以及能显示图片的终端（Ghostty、kitty、iTerm2）。Who 视图在所有环境都能用。

## 📚 更多

- 📖 [**docs/mods.md**](docs/mods.md)：它们如何运作、设置说明以及构建你自己的模组
- 🎥 [**docs/demo.md**](docs/demo.md)：视频和截图
- ⭐ 早期项目：[**cursor-commands**](https://github.com/hamzafer/cursor-commands) [![stars](https://img.shields.io/github/stars/hamzafer/cursor-commands?style=social)](https://github.com/hamzafer/cursor-commands)，为 Cursor 斜杠命令获得 600+ 星标
- 🤝 [**CONTRIBUTING.md**](CONTRIBUTING.md)：添加你自己的模组

## Install

```
claude plugin marketplace add hamzafer/claude-code-mods
claude plugin install now-playing
```

## Original README

<p align="center"><img src="images/claude-wave.gif" alt="" width="40"></p>

<h1 align="center">Claude Code mods</h1>

<p align="center"><b>Make Claude Code show what it's doing.</b><br>Plugins for Claude Code, built on function hooks: live lines above the prompt, guards, panes and games. Install only the ones you want.</p>

<p align="center">
  <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue.svg" alt="MIT"></a>
  <a href="https://github.com/hamzafer/claude-code-mods/actions/workflows/ci.yml"><img src="https://github.com/hamzafer/claude-code-mods/actions/workflows/ci.yml/badge.svg?branch=main" alt="CI"></a>
</p>

<p align="center">
  <a href="#-install">Install</a> · <a href="#-the-mods">All mods</a> · <a href="docs/mods.md">Docs</a> · <a href="https://claude.dev/blog/getting-started-with-claude-code-mods/">What are mods?</a>
</p>

<table>
  <tr>
    <td align="center" width="33%"><a href="docs/mods.md#-context-bar"><img src="images/context-bar.png" alt="context-bar: Claude Code context window usage as a stacked bar, a color per category" width="260"></a><br>📊 <b>context-bar</b><br>what fills your context</td>
    <td align="center" width="33%"><a href="docs/mods.md#-review-watch"><img src="images/review-watch.png" alt="review-watch: live lines for running Codex and subagent code reviews in Claude Code" width="260"></a><br>🔍 <b>review-watch</b><br>running code reviews, live</td>
    <td align="center" width="33%"><a href="docs/mods.md#-md-preview"><img src="images/md-preview.png" alt="md-preview: Markdown that Claude Code edits, rendered like GitHub next to the diff" width="260"></a><br>📝 <b>md-preview</b><br>Markdown rendered like GitHub</td>
  </tr>
  <tr>
    <td align="center" width="33%"><a href="docs/mods.md#-blast-radius"><img src="images/gallery/blast-radius.png" alt="blast-radius: a Claude Code hook holds rm -rf and lists the files it would delete" width="260"></a><br>💥 <b>blast-radius</b><br>see what <code>rm -rf</code> would delete</td>
    <td align="center" width="33%"><a href="docs/mods.md#-now-playing"><img src="images/now-playing.png" alt="now-playing: Spotify track, progress bar and synced lyrics inside Claude Code" width="260"></a><br>🎵 <b>now-playing</b><br>Spotify and its lyrics, live</td>
    <td align="center" width="33%"><a href="docs/mods.md#-reels-and-snake"><img src="images/reels-demo.gif" alt="reels: YouTube Shorts in a Claude Code pane while it works" width="260"></a><br>📱 <b>reels</b><br>Shorts while Claude works</td>
  </tr>
  <tr>
    <td align="center" width="33%"><a href="docs/mods.md#-where-am-i"><img src="images/gallery/where-am-i.png" alt="where-am-i: the session goal, current step and what waits on you, above the Claude Code prompt" width="260"></a><br>📍 <b>where-am-i</b><br>goal, now, waiting on you</td>
    <td align="center" width="33%"><a href="docs/mods.md#-lines-above-the-prompt"><img src="images/gallery/lines.png" alt="token-weather, usage-meter and other Claude Code status lines stacked above the prompt" width="260"></a><br>🌦️ <b>token-weather and friends</b><br>lines above the prompt</td>
    <td align="center" width="33%"><a href="#mission-control"><img src="images/gallery/mission-control.png" alt="mission-control: Claude Code subagents, tool calls and the files they touch, live" width="260"></a><br>🛰️ <b>mission-control</b><br>agents and the code they touch</td>
  </tr>
</table>

## 🚀 Install

Add the marketplace once, then install any mod by name:

```sh
claude plugin marketplace add hamzafer/claude-code-mods
claude plugin install context-bar@claude-code-mods
```

Or install the general-purpose set in one go:

```sh
for m in context-bar token-weather usage-meter where-am-i next-steps agent-radar review-watch replay-theater md-preview blast-radius mission-control; do
  claude plugin install "$m@claude-code-mods"
done
```

Restart Claude Code after installing. To try one without installing:

```sh
git clone https://github.com/hamzafer/claude-code-mods && cd claude-code-mods
claude --plugin-dir mods/context-bar
```

> **Needs** Claude Code 2.1.287+. A few mods need more (Chrome, `gh`, a connector); the tables say which.

## 🧩 The mods

### 👀 See what's happening

| | Mod | What it does | Command |
| --- | --- | --- | --- |
| 🛰️ | **mission-control** | Live map of agents, tool calls and the code they touch | `/mission` |
| 📊 | **context-bar** | Your context window as one stacked bar, a color per category, with token counts and where it compacts | `/context-bar` |
| 🌦️ | **token-weather** | Context fill from Clear to Compact soon, plus a prompt-cache countdown | |
| ⏱️ | **cache-clock** | A prompt-cache line under your status line, from Claude Code's own figures: time left, hit rate and misses, and the tokens your next message re-caches once it goes cold. Needs Node and Claude Code 2.1.251+ | `/cache-clock setup` |
| 📍 | **where-am-i** | Goal, doing now, waiting on you, next step | `/where` |
| ➡️ | **next-steps** | 2 or 3 likely next prompts after each turn, one key to draft one | `1` `2` `3`, `0` hides |
| 💰 | **usage-meter** | 5-hour and 7-day plan usage, the reset countdown and the session's cost | |
| 💳 | **openai-balance** | Your OpenAI API credit: an estimated balance with a gauge, today's spend, where the money mostly went, and the last call. Needs an OpenAI organization Admin key | `/openai-balance` |
| 📡 | **agent-radar** | One live line per running subagent | `/radar` |
| 🔍 | **review-watch** | One live line per running code review (Codex or a review subagent) with the model, target, elapsed time and Codex's latest output. A toast lists the findings when it ends | |
| 🌐 | **browser-lanes** | Whether this session has a browser, and who holds it | `/browser` |
| 🕌 | **prayer-times** | The current prayer and how long is left, the next one, and zawal. Computed on your computer, Hanafi or standard Asr | `/prayers` |
| 🎬 | **replay-theater** | Steps through the last turn's edits, one diff at a time | `/replay` |
| 📝 | **md-preview** | Renders the Markdown files Claude edits like GitHub does, with before and after side by side. Needs Chrome and a terminal that shows images | `/md` |

### 🛡️ Guard your repo

| | Mod | What it does | Command |
| --- | --- | --- | --- |
| 💥 | **blast-radius** | Holds `rm -r`, force pushes and migrations, shows what they'd delete, cancels after 60 s with no answer | |

### 💸 Spend less

| | Mod | What it does | Command |
| --- | --- | --- | --- |
| 🔀 | **switchboard** | Picks the model for each subagent that doesn't name one, with [OpenAI's Decisions API](https://developers.openai.com/api/docs/guides/decisions) or [Jev](https://docs.typesafe.ai), from its short label only. Shows what every subagent cost | `/route` |

### 🔧 My setup (fork and adapt)

These are built around my own tools and rules. Fork them and change the rules to yours.

| | Mod | What it does | Command |
| --- | --- | --- | --- |
| 👀 | **glance** | One line with what needs you: next meeting, PRs, Linear issues, Slack DMs. Needs `gh` and the Google Calendar, Linear and Slack connectors | `/glance` |
| 🚦 | **merge-gate** | Holds `gh pr merge` until CI is green and Codex reviewed once. Needs `gh` and the Codex CLI. Reviews run on one fixed model; change it to yours | `/gate` |
| 📏 | **rulebook-guard** | Enforces my writing and git rules: rewrites em dashes, asks before `--amend`, unformatted pushes, emails and phone numbers in notes | |
| 💾 | **session-saver** | Saves where you left off, shows it on resume. Needs [unpause](https://github.com/hamzafer/unpause) | `/park [note]` |

### 🎮 For fun (opt-in)

| | Mod | What it does | Command |
| --- | --- | --- | --- |
| 📱 | **reels** | YouTube Shorts while Claude works, pauses when it's done | `/reels` |
| 🐍 | **snake** | Snake while Claude works | `/snake` |
| 🎵 | **now-playing** | What Spotify is playing, with a progress bar, the lyric being sung, and ⏮ ⏸ ⏭ buttons. Needs macOS and the Spotify app | `/music` |

<a id="mission-control"></a>

## 🛰️ Flagship: mission-control

Every subagent, every tool call and every file they touch, in a pane next to the chat. Shown at 4x: two subagents building a logout feature across four files.

![mission-control at 4x: two subagents and a logout feature landing across four files](images/mission-control.gif)

Install it like any mod, restart, and type `/mission` (or `/mission code` to open the code map). `q` closes it.

- 🤖 `w` shows the agents and every tool call, live
- 🗺️ `c` shows the code map, with import arrows
- 🔵 **Blue** while the agent reads a file
- 🟠 **Orange** while it writes
- 🟢 **Green** when done, with one line on what changed

> The Code view also needs macOS, Google Chrome and a terminal that shows images (Ghostty, kitty, iTerm2). The Who view works everywhere.

## 📚 More

- 📖 [**docs/mods.md**](docs/mods.md): how they behave, setup notes and build your own
- 🎥 [**docs/demo.md**](docs/demo.md): videos and screenshots
- ⭐ Earlier project: [**cursor-commands**](https://github.com/hamzafer/cursor-commands) [![stars](https://img.shields.io/github/stars/hamzafer/cursor-commands?style=social)](https://github.com/hamzafer/cursor-commands), 600+ stars for Cursor slash commands
- 🤝 [**CONTRIBUTING.md**](CONTRIBUTING.md): add your own mod