Earwarden
Maker-checker for AI agents, in your ear. Earwarden is a local macOS service that answers Claude Code permission prompts by voice through your AirPods, with confirmation strength set by risk:
- Tier 1: a nod or a "yes".
- Tier 2: a random challenge word plus your voiceprint.
- Tier 3: keyboard only, never by voice.
Everything runs on your Mac: no cloud calls at runtime, and no account or API key of its own.
Install
You need a Mac with Apple Silicon (macOS 14 or later), AirPods or another headset, uv, Claude Code and Xcode's command line tools:
uv tool install 'earwarden[voice]'
earwarden setup # hooks, the helper app, and the voice models
earwarden enroll # your voiceprint, about 3 minutes with the AirPods in
earwarden service install --voice --stem
docs/quickstart.md has the five-minute version with what to expect. Without
[voice], or without a headset, every prompt stays on Claude Code's screen, as it always has.
Status
Earwarden 1.0 passed its test suite, a red-team suite and recorded-audio checks, and has run live on one setup: an M2 MacBook Air with AirPods 4 and one speaker's voice. Other headsets, rooms and voices are untested, and the voiceprint's threshold isn't calibrated on other people. Voice is a convenience check, never identity proof, and tier 3 is never approvable by voice. Read SECURITY.md for what it does and doesn't promise, and docs/redteam.md for the attacks it was tried against. Until P-20 in decisions.md closes after longer use, try voice in a scratch project first.
Documents
- Quick start, how tiers work and privacy
- SECURITY.md, the red-team table and attribution for every model and library
- Technical design and build plan
- Decisions: decisions, proposals and open questions
- Changelog
- Releasing and CLAUDE.md: working rules for maintainers and Claude Code sessions in this repo
Development
Everything Earwarden installs stays inside this folder, in venvs: uv itself, the Python 3.11 it downloads, every library and every model. Nothing goes into your system or shell profile (decisions.md, D-013). In each new terminal, from the repo:
source dev/activate
The first time, this puts uv into a venv in .tools/ using your Mac's python3. Then:
uv sync
uv run ruff check . && uv run ruff format --check . && uv run mypy && uv run pytest
To remove everything, delete .tools/ and .venv/.
The PyPI distribution is earwarden; the import name and commands are earwarden.
License
Apache-2.0. See LICENSE.
Metadata
Release files for earwarden 1.0.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| earwarden-1.0.1.tar.gz | 311.5 kB | With provenance | Details for earwarden-1.0.1.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| earwarden-1.0.1-py3-none-any.whl | Python 3 | none | any | Details for earwarden-1.0.1-py3-none-any.whl |
Total release size: 641.7 kB
Release files / earwarden-1.0.1.tar.gz
| Download URL | earwarden-1.0.1.tar.gz |
|---|---|
| Size | 311.5 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
4c1bb1774dc82d2dab203a1de60f321e2500792e6add722315a16ee1000dcb56
|
|
BLAKE2b-256 checksum How to use checksums |
76dd069ddcb1a02192d75c818547351916ceaa4cd35af248bf830ccb5e248050
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 20, 2026.
Transparency logRelease files / earwarden-1.0.1-py3-none-any.whl
| Download URL | earwarden-1.0.1-py3-none-any.whl |
|---|---|
| Size | 330.1 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
63597a254e3f3686d546f5e03c7234962e727b08bafe4193cf312c2fbaaf37d0
|
|
BLAKE2b-256 checksum How to use checksums |
560eff94c17baac7cdc86f904625c7beaf305b1068db8140bb6871054c9434d9
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 20, 2026.
Transparency logSecurity for earwarden 1.0.1
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
Full provenance
Both files in this release have been uploaded with provenance metadata.
Attestation for earwarden-1.0.1.tar.gz
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 20, 2026.
Transparency logA note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.