Skip to main content

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

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)

Source distribution for earwarden 1.0.1
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)

Table of built distributions (wheels) for earwarden 1.0.1
File Interpreter ABI Platform Actions
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 log

Release 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 log

Security 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.

Select from 2 files

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 log

A 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.

Release history Release notifications | RSS feed

This release

1.0.1 This release

2 release files Full provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page