@privacypillar/pii-shield-opencode
v0.0.1-alpha.6
Published
Privacy-first PII and secret detection plugin for OpenCode. Blocks API keys, passwords, SSNs, credit cards, and 25+ other sensitive data types from reaching any LLM. All detection is local — no data ever leaves your machine.
Readme
@privacypillar/pii-shield-opencode
Privacy-first PII and secret detection plugin for OpenCode.
Blocks API keys, passwords, SSNs, credit cards, and 25+ other sensitive data types from reaching any LLM. All detection is local — no data ever leaves your machine.
Install
npm install -g @privacypillar/pii-shield-opencodeThe postinstall script automatically copies the plugin to ~/.config/opencode/plugins/pii-shield/. OpenCode picks it up on the next session start — no further configuration needed.
What it protects against
| Severity | Examples | |---|---| | CRITICAL | OpenAI / Anthropic / Google API keys, AWS credentials, GitHub tokens, private keys, Stripe live keys, database URLs, SSNs, credit cards | | HIGH | JWTs, Bearer tokens, Slack tokens, SendGrid keys, Twilio SIDs, passport numbers, URLs with embedded credentials | | MEDIUM | Emails, US phone numbers, public IPs, dates of birth, Stripe test keys | | LOW | Private IP addresses |
How it works
- Before every
write/edit/bashtool call: scans content and throws an error to block the call if CRITICAL or HIGH secrets are found - After every
read/bash/webfetch/greptool call: scans output and appends a warning so the LLM does not echo the secret - Session start: initialises a volatile JSONL audit log in
os.tmpdir()
Optional: forbidden terms
Add project-specific sensitive terms (codenames, internal hostnames, etc.) to:
~/.config/opencode/plugins/pii-shield/forbidden.txt— applies to all projects.opencode/forbidden.txtin any project root — project-specific~/.pii-shield/forbidden.txt— user-global
Skills
| Skill | What it does |
|---|---|
| Load pii-shield-scan skill | Scan a file or text for PII and secrets |
| Load pii-shield-report skill | Read the session log and produce a privacy report |
| Load pii-shield-redact skill | Redact secrets from a file in-place |
Deep audit agent
@pii-guardian audit the src/ directoryPerforms a comprehensive multi-file privacy audit, reporting file paths, line numbers, and remediation steps.
Privacy guarantees
- Zero network calls — pure JavaScript regex + Luhn algorithm
- No external npm dependencies
- Session log stores only redacted snippets (never full secret values)
- Log is volatile — destroyed when OS recycles temp files
License
MIT — Copyright © 2025 Privacy Pillar
