earshotlisted
Install: claude install-skill ychampion/ystack
# earshot: ears for an agent
> From [Leonxlnx/earshot](https://github.com/Leonxlnx/earshot) by Leon Lin, MIT licence (see `LICENSE`).
> This skill drives the earshot Python package, which is not bundled: get it with
> `git clone https://github.com/Leonxlnx/earshot` and install it as below. `/path/to/earshot` is that clone.
You cannot hear. Never say how audio sounds, or that a sound "fits", without an earshot reading behind it, and quote
the number when you report ("strong match, z +3.9; p_real 0.96; -14.2 LUFS"). earshot runs locally on CPU (audio
never leaves the machine, except with the optional `llm` command) and caches every embedding and result on disk.
Cost: each CLI call is a new process that loads the models first (~20-40 s on a busy laptop, even for a cached file);
inside the MCP server or one Python script the models load once and repeat calls take seconds. For more than a
handful of calls, use MCP or a short script (`from earshot import api; api.find(...); api.realness(...)`).
## Setup (once)
```
pip install -e "/path/to/earshot[mcp,llm]" # or the repo venv: /path/to/earshot/.venv/bin/python -m earshot ...
earshot doctor # packages, ffmpeg, models (pinned revision, cache state); --load times them
```
Two ways in, same functions:
- **CLI**: `earshot <command> ... [--json] [--out result.json]`. Text output starts with a plain summary; times are
m:ss.ss in text and seconds in JSON.
- **MCP** (models stay loaded between calls): `claude