by ctoth
Hook-based audio feedback for Claude Code and OpenAI Codex CLI
# Add to your Claude Code skills
git clone https://github.com/ctoth/claudioGuides for using cli tools skills like claudio.
Last scanned: 6/3/2026
{
"issues": [],
"status": "PASSED",
"scannedAt": "2026-06-03T08:55:37.574Z",
"npmAuditRan": true,
"pipAuditRan": true
}claudio is an open-source cli tools skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by ctoth. Hook-based audio feedback for Claude Code and OpenAI Codex CLI. It has 113 GitHub stars.
Yes. claudio passed SkillsLLM's automated security scan — a dependency vulnerability audit plus prompt-injection heuristics — with no high-severity issues. You can read the full report in the Security Report section on this page.
Clone the repository with "git clone https://github.com/ctoth/claudio" and add it to your Claude Code skills directory (see the Installation section above).
claudio is primarily written in Go. It is open-source under ctoth on GitHub, so you can review or fork the full source.
Yes. SkillsLLM lists many other CLI Tools skills you can browse and compare side by side. Open the CLI Tools category from the badge at the top of this page, or use the Related Skills and comparison links further down to weigh claudio against similar tools.
No comments yet. Be the first to share your thoughts!
Top skills in this category by stars
⚠️ Third-Party Software Notice
This skill is third-party open-source software developed and hosted independently on GitHub. SkillsLLM is an informational directory and does not control or maintain the underlying repository.
Any security checks, ratings, or warnings displayed by SkillsLLM are automated and limited in scope. They do not constitute a security certification or guarantee that the software is safe, error-free, or free from malicious code, vulnerabilities, compromised dependencies, or prompt-injection risks.
Review the source code, permissions, dependencies, and configuration before installing or running any third-party skill. Use is at your own risk. To the maximum extent permitted by applicable law, SkillsLLM is not liable for losses arising from third-party software.
Claudio is a hook-driven audio layer for coding agents. It listens to hook events from Claude Code, OpenAI Codex CLI, Gemini CLI, Qwen Code, and GitHub Copilot CLI, maps the event to a contextual sound, and plays that sound without making the agent wait for playback.
It can play different sounds for tool starts, tool successes, tool failures,
prompts, notifications, completions, compaction, session starts, and subagent
events. Bash commands are parsed, so git commit, npm test, and go build
can each have their own sounds instead of sharing one generic shell sound.
Full documentation starts at docs/index.md.
go install claudio.click/cmd/claudio@latest
Install hooks for detected agents:
claudio install
claudio install uses --agent auto --scope global by default. It detects
Claude Code, Codex CLI, Gemini CLI, Qwen Code, and GitHub Copilot CLI, then
installs hooks for the agents it finds. To force a single agent:
claudio install --agent claude --scope global
claudio install --agent codex --scope global
claudio install --agent gemini --scope global
claudio install --agent qwen --scope global
claudio install --agent copilot --scope global
After Codex hook installation, run /hooks in Codex and trust the Claudio
hook. Use --scope project instead of --scope global when you want hooks only
for the current repository.
claudio status
claudio volume 0.4
claudio mute
claudio unmute
claudio uninstall --agent all --scope global
Optional agent command artifacts:
claudio install-commands --agent claude # /claudio in Claude Code
claudio install-commands --agent codex # $claudio skill in Codex
claudio install-commands --agent antigravity # Antigravity skill and CLI command
Claudio ships platform defaults and supports three custom soundpack forms:
loading/, success/, error/, interactive/,
completion/, and system/claudio soundpack addUseful commands:
claudio soundpack list
claudio soundpack init my-pack --from-platform
claudio soundpack validate ./my-pack.json
claudio soundpack install ./my-pack.json --default
claudio soundpack add gh:owner/repo --name my-pack --default
claudio soundpack update --all
Supported audio formats are WAV, MP3, and AIFF. See docs/soundpacks.md for layout, fallback chains, JSON mappings, validation, and git-backed soundpacks.
Sound tracking is enabled by default. Claudio records resolved sounds and missing fallback candidates in a SQLite database under the XDG cache directory, then exposes that data through:
claudio analyze usage --show-summary --show-chains
claudio analyze missing --preset last-week
Use these reports to decide which sounds your custom pack should add next.
If the agent runs on a remote machine over SSH, that box usually has no audio device and Claudio stays silent. Forward a PulseAudio socket from your local machine (WSLg on Windows already provides one) and point the remote box at it. See docs/remote-audio-ssh.md.
go build ./cmd/claudio
go test ./...