---
title: "attention-sound: A Claude Code mod that plays a sound when Claude needs you, so you can do other things while it works."
url: "https://claudemods.dev/en/builds/attention-sound-a-claude-code-mod-that-plays-a-sound-when-cl-1b7c98"
source: "https://github.com/peeratop02/attention-sounds"
source_type: "github"
repo: "https://github.com/peeratop02/attention-sounds"
author: "Comprehensive_Act158"
author_handle: "Comprehensive_Act158"
stars: 1
category: "Notifications & reminders"
categories: ["notifications"]
tags: ["background-tasks", "hooks", "notifications", "plugin", "sound"]
permission_level: 2
scan_complete: true
install: "claude plugin marketplace add peeratop02/attention-sounds\nclaude plugin install attention-sounds@peeratop02"
added: "2026-10-15T00:41:31.549Z"
updated: "2026-10-15T00:41:31.547Z"
locale: "en"
content_locale: "en"
---

# attention-sound: A Claude Code mod that plays a sound when Claude needs you, so you can do other things while it works.

A Reddit user shares attention-sound, a Claude Code plugin that plays a configurable sound when Claude needs your input, useful when running tasks in the background. Installation is via /plugin install attention-sounds --marketplace peeratop02/attention-sounds, with the repository at https://github.com/peeratop02/attention-sounds.

## Description

The user describes often delegating a task to Claude, backgrounding it, and then forgetting about it for long periods. The mod plays a sound of your choice when Claude requires attention, so you can work on other things meanwhile. It is installed in the Claude app or terminal with /plugin install attention-sounds --marketplace peeratop02/attention-sounds, and the source is on GitHub at https://github.com/peeratop02/attention-sounds.

## Install

```
claude plugin marketplace add peeratop02/attention-sounds
claude plugin install attention-sounds@peeratop02
```

## Original README

# attention-sounds

[![attention-sounds showcase: click to watch with sound](media/showcase.gif)](media/showcase.mp4)

▶ **[Watch the 36-second showcase with sound](media/showcase.mp4)** (the preview above is silent)

A Claude Code mod that plays a sound when Claude needs you, so you can do other things while it works.

| Event | Rings when |
| --- | --- |
| `done` | Claude finished its turn |
| `permission` | Claude waits for a permission answer |
| `question` | Claude asks you a question |
| `attention` | any other notification |

Each event can use its own sound, follow the default sound, or be muted. Picks are kept across sessions.

## Install

At the prompt of a terminal `claude` session:

```
/plugin install attention-sounds --marketplace peeratop02/attention-sounds
```

Answer `y` to add the marketplace, then pick a scope. Installed at the user scope, it also loads in the desktop app's Code tab.

## Use

```
/sound                      open the sound panel (or list picks)
/sound <event> <name>       use that sound for the event
/sound <event> default      follow the default sound
/sound <event> off          mute the event
/sound sound <name>         change the default sound
/sound test <name|event>    hear a sound, or what an event plays now
/sound info                 the manual and every sound name
```

In the desktop app, `/sound` opens a panel: pick an event, pick a library, click a sound to hear it and use it.

In the terminal the panel takes the keyboard:

| Key | Does |
| --- | --- |
| arrows / Tab | move between sounds and buttons |
| Enter | hear the sound and use it |
| `1`-`5` | choose the event to edit (default, done, permission, question, attention) |
| `n` / `b` | next / previous library |
| `t` | test what the event plays now |
| `d` / `m` | follow the default / mute |
| Esc | close |

## Update

```
claude plugin update attention-sounds@peeratop02
```

Then `/reload-plugins` in a running session, or start a new one.

## Sounds

Ships with 18 interface sounds from [Kenney](https://kenney.nl/assets/interface-sounds) (CC0), trimmed and re-encoded.

### Add your own

1. Run `/sound info`. It prints the mod's sounds folder (`Sounds folder: ...`).
2. Make a folder inside it, for example `Mine/`. Each folder shows up as a library in the panel.
3. Drop audio files in: `.m4a`, `.mp3`, `.wav`, `.aiff` or `.caf`. The file name without its extension is the sound's name (`Vine Boom.mp3` becomes `Vine Boom`).
4. Run `/sound` again. No restart needed.

Good sources: `/System/Library/Sounds` on macOS, [Kenney](https://kenney.nl/assets/category:Audio) and [freesound](https://freesound.org) for free packs, any soundboard site for memes.

Short clips that start at once work best. To cut silence from both ends and even out the volume with ffmpeg:

```
ffmpeg -i in.mp3 -af "silenceremove=start_periods=1:start_threshold=-45dB,areverse,silenceremove=start_periods=1:start_threshold=-50dB,areverse,loudnorm" "Mine/My Sound.m4a"
```

A plugin update replaces the installed folder, so keep a copy of your own sounds somewhere else.

## Notes

- Tested on macOS only.
- Subagent turns and aborted turns stay silent.

## Develop

```
claude plugin validate .
claude plugin test .
```

## Licence

Code: MIT. Bundled sounds: CC0, by Kenney.