Claude Code mod

idle-ping

When a turn that did real work ends, ping the user out of band (Telegram if a bot token + TELEGRAM_CHAT_ID are set, else email via CLAUDE_PING_EMAIL + a mailer).

Notification & sound modsValidates on Claude Code 2.1.316 Source

Install

From source
git clone https://github.com/theagitist/claude-mods.git
claude --plugin-dir ./claude-mods/idle-ping

The repo has no marketplace file, so load the plugin folder directly with --plugin-dir.

What it can access

Reach
L2Writes or runs: runs processes, reads files, reads env vars, draws
Sees
every tool call
Hooks
turn.starttool.callturn.complete

From a static scan of the mod's code by awesome-claude-code-mods. It shows what the code asks for, not a security review.

How Claude Code mods work

  • A mod is a plugin with a JavaScript or TypeScript module that runs inside Claude Code (version 2.1.287 or later). It can draw panes beside the transcript, a band above the prompt, buttons and toasts, restyle the spinner and tool rows, and watch or rewrite tool calls and prompts.
  • It installs like any plugin: add its marketplace with /plugin marketplace add owner/repo, then /plugin install name@marketplace.
  • Check what a mod can reach before installing: it runs with your permissions. Reach goes from drawing only, to reading files, to writing files or running processes, to the network. Run claude plugin validate on a clone to list its hooks and calls without running it.
  • Turn one off from the Installed tab in /plugin, or start Claude Code with --safe-mode to skip every customization for a session.
Claude Code docs

Details

Repository
theagitist/claude-mods
Folder
idle-ping
Author
theagitist
Type
Notification & sound mods
Last updated
4 October 2026
Listed in
awesome-claude-code-mods

FAQ

What is idle-ping?

When a turn that did real work ends, ping the user out of band (Telegram if a bot token + TELEGRAM_CHAT_ID are set, else email via CLAUDE_PING_EMAIL + a mailer). It is a mod for Claude Code, from theagitist/claude-mods on GitHub.

What can the idle-ping mod access?

Its widest reach is "writes or runs" (runs processes, reads files, reads env vars, draws). It sees every tool call. Like any mod, it runs with your permissions.

How do I install idle-ping?

Clone theagitist/claude-mods and start Claude Code with --plugin-dir pointing at the mod's folder (idle-ping).

More notification & sound mods

done-chime

AhmedNazihX/claude-mods

Plays a chime and shows a toast when a long Claude reply finishes, so you can look away while it works

Notification & sound mods/plugin install

say

whilestevego/claude-mods

Claude Code's voice, through murmur (Kokoro on the Apple Neural Engine): each session in its own voice (/say picks one), /say read and /say tldr, and $.voice.say for other mods; the notify mod decides what gets said

Notification & sound mods/plugin install

checkpoint-watch

Gat0rRex/claude-mods

A band above the prompt saying how old the project's Checkpoint.md is and how many file edits it is behind, with a toast when it falls well behind.

Notification & sound mods/plugin install

sound-board

tylergraydev/cc-mods

Plays a distinct sound for subagent spawn/finish/failure, permission asks, auto-mode denials, finished turns and more; pick, preview and mute per cue

Notification & sound mods

lemo-sound

54

lemomo-ai/lemo-mod

音效：调用工具、一轮结束、限时中止时播放提示音 · 默认关闭，在「安全」页开启 / Sounds: plays sounds on tool calls, turn ends and time-limit stops · off by default, switch on in Safety

Notification & sound mods/plugin install

done-ping

1

lippdev/lippstack

A desktop notification when Claude finishes a long task or is waiting for you (a permission, a question).

Notification & sound mods/plugin install

Browse the most popular Claude Code mods, all notification & sound mods, or the skills and MCP server directories.