# Cuelume — card for AI agents

Fourteen interaction sound cues for web interfaces, synthesized live with Web Audio and bound to elements through data attributes.

Category: Sound effects · maker Daniel Belyi · checked 2026-10-10

## Price
- Price: Free
- Free tier: Free and open source under the MIT license

## License
MIT License — https://github.com/danielwh2/cuelume/blob/HEAD/LICENSE

- commercial: **yes** (Commercial use OK)
  > to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software
- attribution: **no** (No credit needed)
  > The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
- in app: **yes** (Can ship inside your app)
  > Synthesized live with Web Audio, with no audio files and zero runtime dependencies.

## Rules to follow
- Keep the MIT license and copyright notice with any copies of the software you ship.
- Install from npm (npm install cuelume) and import it as an ES module; CommonJS require() is not supported.
- Call bind() once in the browser; playback only runs in the browser, though server-side imports are safe.
- Do not play a cue per streamed token, per tool call, or on hover; play one cue when a run ends.

## How an agent gets files
- npm install cuelume; import as an ES module and call bind() once in the browser. Sounds are synthesized live with Web Audio, so there are no audio files. (sign-in: none)
- Not allowed: Keep the copyright and permission notice in all copies or substantial portions
- Not allowed: ESM only; CommonJS require() is not supported
- Not allowed: Never play a cue per streamed token, per tool call inside an agent run, or on hover; play one cue when the run ends

## How to connect
- Package (npm/PyPI)
- npm: `npm install cuelume`
- Repository: https://github.com/danielwh2/cuelume
- Website: https://github.com/danielwh2/cuelume

## Notes
Added automatically; license read from the official pages.

## Numbers (AgentGid data)
- Gid Score: 33.3
- GitHub stars: 2,013
- Downloads last week: 96,261
- Used in 1 public projects set up for AI coding agents

## Lines to paste into your prompt or AGENTS.md

```
- Cuelume (Sound effects). Fourteen interaction sound cues for web interfaces, synthesized live with Web Audio and bound to elements through data attributes. Price: free; commercial use OK; no credit needed.
  Connect: npm cuelume.
  Get files: npm install cuelume; import as an ES module and call bind() once in the browser. Sounds are synthesized live with Web Audio, so there are no audio files.
  Not allowed: Keep the copyright and permission notice in all copies or substantial portions
  Not allowed: ESM only; CommonJS require() is not supported
  Not allowed: Never play a cue per streamed token, per tool call inside an agent run, or on hover; play one cue when the run ends
  Rule: Keep the MIT license and copyright notice with any copies of the software you ship.
  Rule: Install from npm (npm install cuelume) and import it as an ES module; CommonJS require() is not supported.
  Rule: Call bind() once in the browser; playback only runs in the browser, though server-side imports are safe.
  Rule: Do not play a cue per streamed token, per tool call, or on hover; play one cue when a run ends.
  License: https://github.com/danielwh2/cuelume/blob/HEAD/LICENSE (checked 2026-10-10; details: https://agentgid.com/assets/cuelume/)
```

## Links
- AgentGid page: https://agentgid.com/assets/cuelume/
- Is it free for commercial use? https://agentgid.com/assets/cuelume/commercial-use/
- Source: https://github.com/danielwh2/cuelume/blob/HEAD/LICENSE
- Source: https://github.com/danielwh2/cuelume

---
AgentGid's catalog is curated: every entry was checked against the maker's official pages (registry, repository, license and pricing pages) on the date shown; a license value shows the quote it stands on wherever AgentGid has one. Usage numbers come from AgentGid's own scan of public repositories set up for AI coding agents. Claims by makers are reported, not tested by AgentGid.