keyfence

Python 3.12+

A local proxy that stops secrets from reaching LLM APIs. It checks every request to an AI provider before it leaves your machine and blocks, redacts or placeholder-swaps API keys, passwords and other secrets. Works with Claude Code, Cursor, Codex, Aider, curl and anything else that speaks HTTP.

How keyfence sits between your tools and the provider

Install

pip install keyfence

Python 3.12 or newer. mitmproxy comes as a dependency.

Use

keyfence import              # register your secrets from .env and credential files (hashes only)
keyfence exec -- claude      # run a tool through the proxy
keyfence canary .env         # plant a fake secret; if a tool ever sends it, you will know
keyfence install-hooks claude-code   # stop Claude Code from reading secret files at all

On first run mitmproxy creates a CA certificate in ~/.mitmproxy/. Trust it once so HTTPS can be inspected (macOS shown, other systems in the setup guide):

sudo security add-trusted-cert -d -p ssl \
  -k /Library/Keychains/System.keychain ~/.mitmproxy/mitmproxy-ca-cert.pem

Modes

mode	behaviour
`block`	request gets a 403 and is not sent
`redact` (default)	secret becomes `[REDACTED:<kind>]`
`placeholder`	secret becomes `<<SECRET_id>>` and the real value is restored in the response, streaming included

Documentation

Setup: CA certificate, manual proxy setup, Docker, all commands.
Detection: the vault, pattern rules, entropy check, what is excluded, the audit log.
Configuration: every option, environment variables, the system prompt notice.
Benchmark: recall by secret format and false positive rate by content type, against gitleaks, reproducible with python bench/run.py.
Limitations: what keyfence does not cover and what to combine it with.
Development: tests, coverage gate, integration script, releasing.
Changelog

License

MIT. Bundled detection rules come from gitleaks, also MIT.

Development Status
- 3 - Alpha
Environment
- Console
Intended Audience
- Developers
Programming Language
- Python :: 3
- Python :: 3 :: Only
Topic
- Security

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

keyfence-0.3.1.tar.gz (68.3 kB view details)

Uploaded Sep 8, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

keyfence-0.3.1-py3-none-any.whl (51.5 kB view details)

Uploaded Sep 8, 2026 Python 3

File details

Details for the file keyfence-0.3.1.tar.gz.

File metadata

Download URL: keyfence-0.3.1.tar.gz
Upload date: Sep 8, 2026
Size: 68.3 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for keyfence-0.3.1.tar.gz
Algorithm	Hash digest
SHA256	`53f5360d83ac6beb0d4ba6dcf4a5895caf457973190c315155311bd80f33e36a`
MD5	`9fb06cfec4cd06477f993c4c7a6b08b9`
BLAKE2b-256	`c2892dc5e856960a525e6d32b77078da5a46be1598ffc7187c5e8aa4e0cf90eb`

See more details on using hashes here.

Provenance

The following attestation bundles were made for keyfence-0.3.1.tar.gz:

Publisher: release.yml on aminueza/Keyfence

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: keyfence-0.3.1.tar.gz
- Subject digest: 53f5360d83ac6beb0d4ba6dcf4a5895caf457973190c315155311bd80f33e36a
- Sigstore transparency entry: 2762055839
- Sigstore integration time: Sep 8, 2026
Source repository:
- Permalink: aminueza/Keyfence@541fca0ccb423cff4fa6c54e69104eba24e8af99
- Branch / Tag: refs/tags/v0.3.1
- Owner: https://github.com/aminueza
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release.yml@541fca0ccb423cff4fa6c54e69104eba24e8af99
- Trigger Event: push