explaingit

scourefoure/claude-chime

Analysis updated 2026-07-26

1JavaScriptAudience · vibe coderComplexity · 2/5Setup · easy

TLDR

A Claude Code plugin that plays a sound when Claude finishes responding or needs input, so you don't have to keep watching the screen while it works.

Mindmap

mindmap
  root((repo))
    What it does
      Plays sound on turn end
      Plays sound on input needed
      Different chimes per event
    Tech stack
      JavaScript
      Node.js 18 plus
      Built-in OS audio players
    Configuration
      Custom sound file paths
      Random file selection
      Volume and mute controls
      Dry-run test mode
    Use cases
      Step away while Claude works
      Multitask without missing replies
      Toggle sound via slash command
    Audience
      Claude Code users
      Non-technical friendly
  

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Step away from your desk while Claude Code works and get an audio alert when it needs you.

USE CASE 2

Customize chime sounds with your own audio files to personalize your workflow.

USE CASE 3

Mute and unmute sounds quickly with a slash command during meetings or focused work.

What is it built with?

JavaScriptNode.js 18+

How does it compare?

scourefoure/claude-chime0xmukesh/docusaurus-tutorial1tsmejp/palworld-docker-wine
Stars111
LanguageJavaScriptJavaScriptJavaScript
Last pushed2021-12-27
MaintenanceDormant
Setup difficultyeasyeasymoderate
Complexity2/52/54/5
Audiencevibe coderdeveloperops devops

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

Requires Node.js 18 or higher and Claude Code installed.

In plain English

claude-chime is a small plugin for Claude Code that plays a sound on your computer whenever Claude finishes responding or needs you to type something back. The idea is simple: if you step away or start reading something else while Claude is working, you do not have to keep checking the screen. You hear a chime and know it is time to look again. Installation happens through Claude Code itself using two slash commands. You add the plugin from its GitHub location or a local folder, install it, and reload your plugins. There is no separate app to run. The plugin sits inside Claude Code and listens for two events: when a turn finishes and when input is needed. Each event gets its own sound, with sensible defaults for Windows, macOS, and Linux so it works out of the box. Configuration is done through environment variables. You can point the plugin at your own sound files by giving their full paths. If you list several files separated by semicolons, the plugin picks one at random each time, which is a nice way to avoid hearing the exact same tone over and over. You can set volume as a percentage from 0 to 100, mute everything with a single variable, or use a mute flag file that you create or delete to toggle sound. A built-in slash command lets you turn sounds on and off without editing anything. For testing, a dry-run mode prints what the plugin would play without actually making noise, which helps confirm your setup. Settings that should apply to the real chimes need to go in the env block of a Claude Code settings file, since the hooks that trigger the sounds read from the environment Claude Code was launched with. Changes take effect on the next session or after a reload. The plugin requires Node.js 18 or higher and relies on built-in audio players on Windows, macOS, and Linux. The full README is longer than what was shown.

Copy-paste prompts

Prompt 1
Help me install the claude-chime plugin in Claude Code using the slash commands from the GitHub repo SCoureFoure/claude-chime.
Prompt 2
I want to set up custom sound files for claude-chime using environment variables. Generate the config for two sound files picked randomly, with volume at 80 percent.
Prompt 3
Create a mute flag file script for claude-chime that toggles sound on and off from the terminal.
Prompt 4
Show me how to use claude-chime dry-run mode to test my sound setup without making noise.

Frequently asked questions

What is claude-chime?

A Claude Code plugin that plays a sound when Claude finishes responding or needs input, so you don't have to keep watching the screen while it works.

What language is claude-chime written in?

Mainly JavaScript. The stack also includes JavaScript, Node.js 18+.

How hard is claude-chime to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is claude-chime for?

Mainly vibe coder.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.