SLOPSHOPPER

done-sound

Plays a sound when Claude finishes answering

newprocess
v0.1.0no licenseupdated 2026-10-15kad1r/claude-mods/done-sound
A shopper browsing a rack in a slop shop
README

claude-mods

English · Türkçe

Small, focused mods for Claude Code, built on its function-hook plugin API. Each folder is one plugin; the repo root is a plugin marketplace, so you install only the mods you want.

Clawd's 17 scenes in the default small band

What's new

  • ask-alert, new: a Windows notification and a sound when Claude waits for you (a permission prompt, AskUserQuestion, an idle prompt).
  • sys-meter, a new status line: CPU, RAM and temperature every 5 s.
  • clawd-spinner, rewritten. 17 scenes, one picked at random for every command and never the same twice in a row (10 new: rain, fishing, music, laptop, ball, rocket, plant, bug, blocks, sleep). The default band is now 16×1 cells, drawn with Unicode 16 block octants (2×4 pixels per cell), a quarter of the old size. size: large in /config brings back the 32×2 half-block band (preview). The large band animates with $.ui.blit, so the rest of the band is not redrawn every frame.
  • clear-reminder is a status line now, styled like usage-meter.
  • usage-meter writes percents as %34; 34% 336k came out garbled in the status line.
  • git-band runs git status with core.fsmonitor off, so a cloned repo's config cannot start a program every 15 s.
  • New mods: todo-pane, agents-pane, git-band, time-tracker, session-journal.

What's inside

See what Claude is doing

ModWhat it does
usage-meterStatus line: context fill bar with tokens/window, a live turn timer, the last turn's tokens, session cost and 5-hour rate-limit usage.
clear-reminderStatus line counting prompts since the last /clear (🟢 mesaj ▰▰▱ 7/20); turns yellow at 17 and red at 20, with a toast.
sys-meterStatus line with CPU load, RAM usage and temperature (🟢 cpu ▰▱▱ %14 · ram ▰▰▰ %78 24.6/31.6G · 🌡 69°C), refreshed every 5 s. Windows only; the temperature is the ACPI thermal zone, readable without admin rights, not the CPU package sensor.
git-bandOne line above the prompt: branch, changed-file count, ahead/behind. Refreshes every 15 s and after each turn.
todo-paneLive pane of Claude's todo list (TodoWrite or TaskCreate/TaskUpdate) with a progress bar. Opens by itself; /todos reopens it.
agents-paneLive pane of subagents with status, elapsed time and a Stop button for each running one. /subagents reopens it.
session-diff/session-diff lists every file changed this session with +/− counts; press a file to read its diff (b back, k/j page).

Status lines and the git band

todo-pane, agents-pane and session-diff

Habits and records

ModWhat it does
prompt-scoreToasts a quality score for every prompt you type (clarity, context, specificity, verifiability) with one hint for the weakest part. Local rules, no API calls. Hints are in Turkish.
time-trackerAdds up how long Claude works per project per day; /zaman shows the last 7 days.
session-journalAppends one line per turn to ~/.claude/journal/<date>.md; /gunluk adds a Haiku-written summary of the session.

Fun

ModWhat it does
clawd-spinnerA tiny 16×1 band under the spinner (block octants; set size to large in /config for a 32×2 half-block band if your font lacks octants) where pixel-art Clawd plays one of 17 scenes, picked at random for every command (UFO, cooking, fishing, rain, music, laptop, rocket, growing plant, falling blocks, sleeping…). Time-of-day backdrop: morning coffee, a night sky, Friday-evening confetti.

Notifications

ModWhat it does
ask-alertWhen Claude waits for you (a permission prompt from an ask rule, an AskUserQuestion, an idle prompt, an MCP input request) it raises a Windows notification, a toast in the terminal and plays Windows Notify System Generic.wav. mode in /plugin configure: both (default), toast or sound. Windows only.
done-soundPlays a random mp3 from its sounds/ folder when Claude finishes answering, never the same twice in a row (Windows, through PowerShell's MediaPlayer).

ask-alert: terminal toast and Windows notification

Install

At a Claude Code prompt:

/plugin install usage-meter --marketplace kad1r/claude-mods

Answer y to add the marketplace, then pick a scope. Repeat with any mod name from the tables above. /reload-plugins picks up updates.

done-sound: no sound files are in the repo. Put one or more mp3s in done-sound/sounds/ inside the installed plugin folder; each finished answer plays a random one, never the same twice in a row.

Notes

  • Function hooks are an early-access API of Claude Code and may change between releases. These mods were written and tested on Claude Code 2.1.296; ask-alert on 2.1.300.
  • session-journal writes the first line of your prompts to disk in plain text. Keep that in mind if you paste secrets into prompts.
  • /gunluk makes one Haiku request each time you run it.
  • ask-alert does not fire in bypassPermissions mode for permission prompts, since none are shown. Where an organization manages Claude Code, its Notification hook runs only if the organization lists the plugin; the AskUserQuestion alert still works.
  • The images above are drawn from the mods' own output (Clawd's frames from scene.ts, the status-line and pane text from each mod's functions), not cropped from a live session. The Windows notification in ask-alert.svg is drawn to look like the real one.

Develop

Each mod is three files: .claude-plugin/plugin.json, hooks/hooks.json and a hooks module in hooks/. Mods that keep values in $.state also have types/index.d.ts.

claude plugin validate ./<mod>
claude plugin test ./<mod>

To run from a local clone, add it as a marketplace (claude plugin marketplace add <path>), install from it, and run /reload-plugins after edits; the plugin is read straight from the folder.

<a id="türkçe"></a>

claude-mods (Türkçe)

English · Türkçe

Claude Code için küçük, tek işe odaklı mod'lar. Hepsi Claude Code'un function-hook plugin API'si ile yazıldı. Her klasör bir plugin; repo kökü bir plugin marketplace'i, yani sadece istediğin mod'ları kurarsın.

Varsayılan küçük bantta Clawd'ın 17 sahnesi

Yenilikler

  • ask-alert, yeni: Claude seni beklediğinde (izin isteği, AskUserQuestion, boşta kalan prompt) Windows bildirimi ve ses.
  • sys-meter, yeni durum satırı: 5 saniyede bir CPU, RAM ve sıcaklık.
  • clawd-spinner baştan yazıldı. 17 sahne var; her komutta biri rastgele seçiliyor ve aynısı art arda gelmiyor (10 yeni: yağmur, balık tutma, müzik, laptop, top, roket, bitki, böcek, bloklar, uyku). Varsayılan bant artık 16×1 hücre, Unicode 16 blok octant karakterleriyle çiziliyor (hücre başına 2×4 piksel), eskisinin dörtte biri. /config içinde size: large seçilirse 32×2'lik yarım-blok bant geri gelir (önizleme). Büyük bant $.ui.blit ile oynuyor, yani her karede bandın geri kalanı yeniden çizilmiyor.
  • clear-reminder artık usage-meter gibi bir durum satırı.
  • usage-meter yüzdeyi %34 biçiminde yazıyor; 34% 336k durum satırında bozuk görünüyordu.
  • git-band git status'u core.fsmonitor kapalı çalıştırıyor; klonlanan bir reponun ayarı 15 saniyede bir program başlatamaz.
  • Yeni mod'lar: todo-pane, agents-pane, git-band, time-tracker, session-journal.

Neler var

Claude ne yapıyor, gör

ModNe yapar
usage-meterDurum satırı: context doluluk çubuğu ve token/pencere, canlı turn sayacı, son turn'ün token'ı, oturum maliyeti, 5 saatlik limit kullanımı.
clear-reminderSon /clear'dan beri yazdığın mesajları sayan durum satırı (🟢 mesaj ▰▰▱ 7/20); 17'de sarı, 20'de kırmızı olur ve toast gösterir.
sys-meterCPU yükü, RAM kullanımı ve sıcaklığı gösteren durum satırı (🟢 cpu ▰▱▱ %14 · ram ▰▰▰ %78 24.6/31.6G · 🌡 69°C), 5 saniyede bir yenilenir. Sadece Windows; sıcaklık admin yetkisi gerektirmeyen ACPI thermal zone değeridir, CPU paket sensörü değil.
git-bandPrompt'un üstünde tek satır: branch, değişen dosya sayısı, ahead/behind. 15 saniyede bir ve her turn sonunda yenilenir.
todo-paneClaude'un yapılacaklar listesini (TodoWrite veya TaskCreate/TaskUpdate) ilerleme çubuğuyla gösteren canlı panel. Kendiliğinden açılır; /todos tekrar açar.
agents-paneSubagent'ları durum ve süreyle gösteren canlı panel; çalışan her birinin yanında Durdur butonu. /subagents tekrar açar.
session-diff/session-diff bu oturumda değişen dosyaları +/− sayılarıyla listeler; bir dosyaya basınca diff'ini gösterir (b geri, k/j sayfa).

Durum satırları ve git bandı

todo-pane, agents-pane ve session-diff

Alışkanlık ve kayıt

ModNe yapar
prompt-scoreYazdığın her prompt'a kalite puanı verir (netlik, bağlam, kapsam, doğrulanabilirlik) ve en zayıf kısım için tek bir ipucu gösterir. Yerel kurallar, API çağrısı yok.
time-trackerClaude'un proje bazında günlük çalıştığı süreyi toplar; /zaman son 7 günü gösterir.
session-journalHer turn için ~/.claude/journal/<tarih>.md dosyasına bir satır ekler; /gunluk oturumun Haiku ile yazılmış özetini ekler.

Eğlence

ModNe yapar
clawd-spinnerSpinner'ın altında 16×1'lik minik bir bant (blok octant karakterleri; fontun bunları çizmiyorsa /config'ten size ayarını large yap, 32×2 yarım-blok bant gelir): piksel Clawd her komutta rastgele seçilen 17 sahneden birini oynar (UFO, yemek, balık tutma, yağmur, müzik, laptop, roket, büyüyen çiçek, düşen bloklar, uyku…). Arka plan saate göre değişir: sabah kahve, gece gökyüzü, cuma akşamı konfeti.

Bildirimler

ModNe yapar
ask-alertClaude seni beklediğinde (ask kuralından gelen izin isteği, AskUserQuestion, boşta kalan prompt, MCP'nin bilgi isteği) Windows bildirimi ve terminal içi toast gösterir, Windows Notify System Generic.wav çalar. /plugin configure içinde mode: both (varsayılan), toast veya sound. Sadece Windows.
done-soundClaude cevabı bitirince sounds/ klasöründen rastgele bir mp3 çalar, aynısı art arda gelmez (Windows, PowerShell MediaPlayer ile).

ask-alert: terminal toast'u ve Windows bildirimi

Kurulum

Claude Code prompt'unda:

/plugin install usage-meter --marketplace kad1r/claude-mods

Marketplace'i eklemek için y de, sonra scope seç. Tablolardaki diğer mod adlarıyla tekrarla. Güncellemeler için /reload-plugins.

done-sound: Ses dosyaları repoda yok. Kurulan plugin klasöründe done-sound/sounds/ altına bir veya daha fazla mp3 koy; her cevap bitiminde rastgele biri çalar, aynısı art arda gelmez.

Notlar

  • Function hook'lar Claude Code'un erken erişim API'si; sürümler arasında değişebilir. Bu mod'lar Claude Code 2.1.296 üzerinde yazılıp test edildi; ask-alert 2.1.300 üzerinde.
  • session-journal, prompt'larının ilk satırını diske düz metin olarak yazar. Prompt'a secret yapıştırıyorsan bunu göz önünde tut.
  • /gunluk her çalıştığında bir Haiku isteği yapar.
  • ask-alert, bypassPermissions modunda izin uyarısı vermez, çünkü izin ekranı çıkmaz. Claude Code'u organizasyon yönetiyorsa Notification hook'u ancak organizasyon plugin'i listelerse çalışır; AskUserQuestion uyarısı yine çalışır.
  • Yukarıdaki görseller mod'ların kendi çıktısından çizildi (Clawd kareleri scene.ts'den, durum satırı ve panel metinleri mod fonksiyonlarından); canlı oturumdan kırpılmadı. ask-alert.svg içindeki Windows bildirimi gerçeğine benzetilerek çizildi.

Geliştirme

Her mod üç dosyadan oluşur: .claude-plugin/plugin.json, hooks/hooks.json ve hooks/ altında bir hooks modülü. $.state kullananlarda ayrıca types/index.d.ts vardır.

claude plugin validate ./<mod>
claude plugin test ./<mod>

Yerel bir klondan çalıştırmak için klonu marketplace olarak ekle (claude plugin marketplace add <yol>), oradan kur ve değişikliklerden sonra /reload-plugins çalıştır; plugin doğrudan klasörden okunur.

Source 1 files
hooks/register.ts 48 lines
1import type { Register } from 'claude-code'
2
3// $.audio.play has no player on a Windows terminal, so PowerShell's MediaPlayer plays the mp3.
4// It picks a random mp3 from the sounds folder, skipping the last one played when it can,
5// prints the chosen name, and waits for the clip's length so the sound is not cut off.
6const PLAY_SCRIPT = [
7  '$all = @(Get-ChildItem -LiteralPath $env:DONE_SOUND_DIR -Filter *.mp3)',
8  'if ($all.Count -eq 0) { exit 0 }',
9  '$pool = @($all | Where-Object { $_.Name -ne $env:DONE_SOUND_LAST })',
10  'if ($pool.Count -eq 0) { $pool = $all }',
11  '$f = $pool | Get-Random',
12  '[Console]::Out.Write($f.Name)',
13  'Add-Type -AssemblyName PresentationCore',
14  '$p = New-Object System.Windows.Media.MediaPlayer',
15  '$p.Open([uri]$f.FullName)',
16  '$i = 0',
17  'while (-not $p.NaturalDuration.HasTimeSpan -and $i -lt 30) { Start-Sleep -Milliseconds 100; $i++ }',
18  '$p.Play()',
19  '$d = if ($p.NaturalDuration.HasTimeSpan) { [int]$p.NaturalDuration.TimeSpan.TotalMilliseconds } else { 6000 }',
20  'Start-Sleep -Milliseconds ($d + 200)',
21  '$p.Close()',
22].join('; ')
23
24export const register: Register = on => {
25  let isPlaying = false
26  let lastSound = ''
27
28  on('turn.complete', ($, e, next) => {
29    // Main loop answers only: subagent runs and interrupted turns stay silent.
30    if (e.agentId === undefined && e.reason === 'answer' && !isPlaying) {
31      isPlaying = true
32      void $.process
33        .run(['powershell.exe', '-NoProfile', '-NonInteractive', '-Command', PLAY_SCRIPT], {
34          env: { DONE_SOUND_DIR: `${$.plugin.root}/sounds`, DONE_SOUND_LAST: lastSound },
35          timeoutMs: 60_000,
36        })
37        .then(r => {
38          if (r.stdout) lastSound = r.stdout.trim()
39        })
40        .catch(() => undefined)
41        .finally(() => {
42          isPlaying = false
43        })
44    }
45    return next(e)
46  })
47}
48