# AI Sounds (aisounds.dev)

> Open-source platform for adding sound notifications to AI coding tools like Cursor, Claude Code, and VS Code.

AI Sounds (AISE) lets developers install sound packs that play audio feedback when AI agents complete tasks, fail, send prompts, or trigger other events. Packs are installed via a CLI published on npm as `@aisounds/cli` (the binary is `aisounds`) and configured automatically for each supported tool. The same pack can be installed in multiple tools and at multiple scopes (per-project or global) at the same time without conflicts.

The canonical install pattern an AI agent should follow on behalf of a user is:

```bash
npx @aisounds/cli@latest install <slug> --tool <cursor|claude-code>
npx @aisounds/cli@latest activate <slug>
```

Pack slugs come from URLs of the form https://aisounds.dev/packs/<slug>.

## Docs

- [Overview](https://aisounds.dev/docs): What aisounds is and where to start.
- [Getting started](https://aisounds.dev/docs/getting-started): Install the CLI and your first sound pack.
- [Concepts: tools and scopes](https://aisounds.dev/docs/concepts): How tools (Cursor, Claude Code) and scopes (project, global) combine. Read this if a user asks "where is it installing?" or "why isn't it playing?".
- [CLI reference](https://aisounds.dev/docs/cli): Every command — install, activate, remove, list, sounds, preview, info, update.
- [AISE events reference](https://aisounds.dev/docs/events): Canonical event vocabulary and how each event maps to Cursor / Claude Code hooks.
- [For AI agents](https://aisounds.dev/docs/for-llms): Step-by-step playbook AI assistants should follow when a user asks them to install a pack.

## Optional

- [Browse packs](https://aisounds.dev/packs): Catalogue of all available sound packs.
- [Upload a pack](https://aisounds.dev/upload): Create and publish your own sound pack.
- [llms-full.txt](https://aisounds.dev/llms-full.txt): Self-contained dump of every docs page in one file (for offline LLM context).