io.github.963239327/pasteshield-secret-sanitizer
by 963239327
README.md
<!-- mcp-name: io.github.963239327/pasteshield-secret-sanitizer -->
<div align="center">
<img src="./assets/icon.png" alt="PasteShield Logo" width="88" />
# PasteShield — Reversible AI Prompt & Clipboard Secret Sanitizer
**Redact API keys, `.env` secrets, JWTs, database URIs, cloud connection strings & internal IPs before prompting ChatGPT, Claude, Cursor, or Copilot — and auto-unmask AI code replies in 1 hotkey (`Cmd+Alt+V`).**
[](https://marketplace.visualstudio.com/items?itemName=craftleaf-studio.pasteshield-ai-secret-sanitizer)
[](https://open-vsx.org/extension/craftleaf-studio/pasteshield-ai-secret-sanitizer)
[](https://github.com/963239327/pasteshield-secret-sanitizer/releases/latest/download/pasteshield-ai-secret-sanitizer-1.2.0.vsix)
[](https://963239327.github.io/craftleaf-studio/extensions/pasteshield/)
[](https://stardustdemo.gumroad.com/l/pasteshield-pro)
[](https://registry.modelcontextprotocol.io/v0.1/servers?search=pasteshield)
[](https://glama.ai/mcp/servers/963239327/pasteshield-secret-sanitizer)




[**VS Code Marketplace →**](https://marketplace.visualstudio.com/items?itemName=craftleaf-studio.pasteshield-ai-secret-sanitizer) · [**Open VSX (Cursor / VSCodium) →**](https://open-vsx.org/extension/craftleaf-studio/pasteshield-ai-secret-sanitizer) · [**Live Playground →**](https://963239327.github.io/craftleaf-studio/extensions/pasteshield/) · [**CLI & MCP ↓**](#4-ways-to-use-pasteshield) · [**PasteShield Pro ($9) ↓**](#free-vs-pasteshield-pro-comparison)
</div>
---
## Why Developers Use PasteShield Instead of `***REDACTED***`
Every day, developers paste `.env` configs, Kubernetes manifests, crash logs, and `curl` traces into ChatGPT, Claude, DeepSeek, or Cursor. Manually replacing values with `***REDACTED***` breaks two things:
1. **LLMs lose cross-variable identity** (the model cannot tell if two `***` strings are the same database host or two different tokens).
2. **Pasting the AI's refactored code back breaks your app** until you manually hunt down and re-insert every secret.
**PasteShield solves both in `<1ms` with zero cloud calls:**
- Maps each unique secret to a **deterministic semantic token** (`<OPENAI_KEY_1>`, `<DB_URI_1>`, `<GITHUB_TOKEN_1>`, `<INTERNAL_IP_1>`).
- Identical secrets across multiple lines or files always map to the **exact same placeholder** so the LLM preserves variable relationships.
- **Restores your exact original secrets in 1 click** (`Cmd+Alt+R` in VS Code / Cursor, or `pasteshield restore` in CLI) when you paste the AI's solution back.
<p align="center">
<img src="./assets/screenshot_1_before_after.png" alt="PasteShield Before and After Reversible AI Secret Sanitization in VS Code and Cursor" width="900" />
</p>
---
## Before & After Roundtrip Example
### 1. Raw Local Snippet (Stays on Your Machine)
```dotenv
# Production Checkout Service (.env)
OPENAI_API_KEY=sk-proj-EXAMPLE000000000000000000000001
GITHUB_DEPLOY_TOKEN=ghp_EXAMPLE00000000000000000000000001
DATABASE_URL="postgresql://svc_orders:Pr0dP4ss!@10.24.8.15:5432/orders_db"
ONCALL_EMAIL=secops@acme-fintech.example
```
### 2. Sanitized Prompt Sent to ChatGPT / Claude / Cursor (`Cmd+Alt+C`)
```dotenv
# Production Checkout Service (.env)
OPENAI_API_KEY=<OPENAI_KEY_1>
GITHUB_DEPLOY_TOKEN=<GITHUB_TOKEN_1>
DATABASE_URL="<DB_URI_1>"
ONCALL_EMAIL=<EMAIL_1>
```
### 3. AI Generates Refactored Code -> 1-Click Local Restore (`Cmd+Alt+R`)
```ts
// AI outputs placeholders -> PasteShield restores real credentials locally in <1ms:
export const checkoutEnv = {
openAiKey: "sk-proj-EXAMPLE000000000000000000000001",
databaseUrl: "postgresql://svc_orders:Pr0dP4ss!@10.24.8.15:5432/orders_db",
deployToken: "ghp_EXAMPLE00000000000000000000000001",
alertEmail: "secops@acme-fintech.example",
};
```
---
## 4 Ways to Use PasteShield
### Local MCP Server (Claude Desktop · Cursor · Windsurf · VS Code Copilot)
Run PasteShield as a **zero-dependency local stdio MCP Server** (`sanitize_snippet`, `restore_snippet`, `audit_workspace_secrets`) with zero npm signup required:
```json
{
"mcpServers": {
"pasteshield": {
"command": "npx",
"args": ["-y", "github:963239327/pasteshield-secret-sanitizer", "--mcp"]
}
}
}
```
Also installable in 1 click from the [**Official Visual Studio Marketplace**](https://marketplace.visualstudio.com/items?itemName=craftleaf-studio.pasteshield-ai-secret-sanitizer) and [**Verified Open VSX Registry (Cursor / Windsurf / VSCodium)**](https://open-vsx.org/extension/craftleaf-studio/pasteshield-ai-secret-sanitizer).
### Option A: VS Code, Cursor, Windsurf & VSCodium Extension
1. Install directly from [**VS Code Marketplace**](https://marketplace.visualstudio.com/items?itemName=craftleaf-studio.pasteshield-ai-secret-sanitizer) or [**Open VSX Registry (`verified` publisher `craftleaf-studio`)**](https://open-vsx.org/extension/craftleaf-studio/pasteshield-ai-secret-sanitizer), or download **[`pasteshield-ai-secret-sanitizer-1.2.0.vsix`](https://github.com/963239327/pasteshield-secret-sanitizer/releases/latest/download/pasteshield-ai-secret-sanitizer-1.2.0.vsix)** from [GitHub Releases](https://github.com/963239327/pasteshield-secret-sanitizer/releases/latest).
2. In VS Code or Cursor, open the Command Palette (`Cmd+Shift+P` / `Ctrl+Shift+P`) -> **`Extensions: Install from VSIX...`** -> select the `.vsix` file (or run `code --install-extension pasteshield-ai-secret-sanitizer-1.2.0.vsix`).
3. Highlight any code/log and press:
- **`Cmd+Alt+C`** (`Ctrl+Alt+C`) — **Copy Sanitized Selection for AI**
- **`Cmd+Alt+V`** (`Ctrl+Alt+V`) — **Paste & Auto-Unmask AI Reply at Cursor**
- **`Cmd+Alt+R`** (`Ctrl+Alt+R`) — **Restore Original Values from Clipboard / Selection**
- **`Cmd+Alt+S`** (`Ctrl+Alt+S`) — **Sanitize Current Editor In-Place**
- **Hover any `<CATEGORY_N>` token** — View safe masked preview (`sk-p••••abcd`) from local RAM
- **Team `.pasteshield.json` + Pre-Commit Gate** — Run `pasteshield init-policy --install-hook` to enforce repo-level redaction rules across your team (`$29` 5-Seat Team Policy Pack / `$9` Solo Pro)
### Option B: Instant Zero-Install Browser Playground
Need to scrub a crash log or `.env` snippet right now without installing anything?
👉 **[Open Live PasteShield Browser Playground](https://963239327.github.io/craftleaf-studio/extensions/pasteshield/)** *(100% client-side JS, works offline after page load)*.
### Option C: Quickstart CLI & JavaScript SDK (Node.js / Bun, 0 Dependencies)
```bash
git clone https://github.com/963239327/pasteshield-secret-sanitizer.git
cd pasteshield-secret-sanitizer
# Run interactive roundtrip demo in your terminal:
node bin/pasteshield-cli.js demo
# Sanitize clipboard on macOS before pasting into ChatGPT / Claude:
pbpaste | node bin/pasteshield-cli.js sanitize --vault .pasteshield-vault.json | pbcopy
# Restore real values into the AI's code reply on your clipboard:
pbpaste | node bin/pasteshield-cli.js restore --vault .pasteshield-vault.json | pbcopy
# Scan workspace or uncommitted `git diff` for accidental secret leaks:
node bin/pasteshield-cli.js scan --git-diff
```
Use `sanitizer-core.js` directly as a zero-dependency CommonJS or browser module:
```js
const PasteShieldCore = require('./sanitizer-core');
const vault = PasteShieldCore.createVault();
const { sanitizedText, totalRedactions } = vault.sanitize(process.env.RAW_LOG_SNIPPET || 'OPENAI_API_KEY=sk-proj-1234567890abcdefghijklm');
console.log(sanitizedText); // OPENAI_API_KEY=<OPENAI_KEY_1>
const { restoredText } = vault.restore(`export const key = "${sanitizedText.split('=')[1]}";`);
```
---
## 10 Built-In Secret & PII Detectors (Free Forever)
| Semantic Token | Detected Credentials & Formats |
| :--- | :--- |
| `<OPENAI_KEY_N>` | OpenAI (`sk-...`, `sk-proj-...`, `sk-svcacct-...`) & Anthropic (`sk-ant-...`) LLM keys |
| `<AWS_ACCESS_KEY_N>` | AWS IAM Access Key IDs (`AKIA...`, `ASIA...`, `ABIA...`, `ACCA...`) |
| `<GITHUB_TOKEN_N>` | GitHub Classic PATs (`ghp_`), OAuth/App (`gho_`, `ghu_`, `ghs_`, `ghr_`), Fine-Grained (`github_pat_`) |
| `<BEARER_JWT_N>` | 3-part signed JWTs (`eyJ...`) & HTTP `Authorization: Bearer <token>` headers |
| `<AZURE_CONN_STR_N>` | Azure Storage, Service Bus, Cosmos DB, IoT Hub & Azure SQL connection strings |
| `<DB_URI_N>` | PostgreSQL, MySQL, MariaDB, MongoDB, Redis, AMQP & ClickHouse URIs with embedded credentials |
| `<PRIVATE_KEY_BLOCK_N>` | Multi-line PEM, RSA, EC, OpenSSH & PGP `BEGIN ... PRIVATE KEY` blocks |
| `<INTERNAL_IP_N>` | RFC1918 (`10.x`, `172.16-31.x`, `192.168.x`) & Tailscale/CGNAT (`100.64-127.x`) private IPv4s |
| `<EMAIL_N>` | Internal & customer email addresses |
| `<ENV_SECRET_N>` | `.env` / YAML / JSON assignments (`*_SECRET`, `*_PASSWORD`, `*_TOKEN`, `*_API_KEY`) + Stripe, Slack, Google API, SendGrid, npm & PyPI tokens |
---
## Free vs. PasteShield Pro Comparison
<p align="center">
<img src="./assets/screenshot_2_context_pack.png" alt="PasteShield Pro Multi-File Sanitized AI Markdown Context Pack and Git Diff Audit" width="900" />
</p>
| Feature | Free Community (`$0`) | PasteShield Pro (`$9` One-Time) | Studio All-Access (`$19` One-Time) |
| :--- | :---: | :---: | :---: |
| **10 Built-In Cloud, LLM, DB, JWT & PEM Detectors** | ✅ | ✅ | ✅ |
| **1-Click Reversible Session Vault (`Cmd+Alt+C` / `Cmd+Alt+R`)** | ✅ | ✅ | ✅ |
| **Zero-Dependency Node/Bun CLI & Browser Playground** | ✅ | ✅ | ✅ |
| **100% Offline Air-Gapped Execution (Zero Telemetry)** | ✅ | ✅ | ✅ |
| **Custom Corporate Domain Redaction (`*.corp.acme.internal` -> `<COMPANY_DOMAIN_1>`)** | — | ✅ | ✅ |
| **Custom Regex Rules (Jira/Linear IDs, Customer Keys, Proprietary Tokens)** | — | ✅ | ✅ |
| **Multi-File Sanitized AI Markdown Context Pack Exporter** | — | ✅ | ✅ |
| **Workspace & `git diff` Markdown Security Audit Report** | — | ✅ | ✅ |
| **Also Unlocks 4 Sister CraftLeaf Pro Tools** *(CleanPrint, IDPhoto 4×6, Invoice CRM, CardSheet Duplex)* | — | — | ✅ (Gumroad Master Key) |
👉 **[Get PasteShield Pro ($9 Lifetime Offline Key)](https://963239327.github.io/craftleaf-studio/extensions/pasteshield/#pro)** · **[Get Studio All-Access Pass ($19 — Unlocks All 5 Tools)](https://963239327.github.io/craftleaf-studio/#all-access)**
---
## More Privacy-First Tools by CraftLeaf Studio
All CraftLeaf tools run **100% client-side in your browser or local IDE** with zero file uploads:
- 🖨️ **[CleanPrint & AI-Chat to PDF Extension](https://963239327.github.io/craftleaf-studio/extensions/cleanprint/)** — Strip clutter & dark backgrounds from ChatGPT/Claude/Docs and export eco low-ink vector PDFs.
- 🪪 **[Passport & Visa 4×6" ID Photo Sheet Maker](https://963239327.github.io/craftleaf-studio/tools/id-photo/)** — Biometric US/Schengen/UK/Canada/China visa photo cropper tiled onto a `$0.39` 4×6" print sheet.
- 🧾 **[No-Signup Freelancer Invoice PDF Studio](https://963239327.github.io/craftleaf-studio/tools/invoice/)** — Instant multi-currency client invoices with local CRM memory & payment QR codes.
- 🗂️ **[CardSheet Duplex Flashcard & PnP Print Studio](https://963239327.github.io/craftleaf-studio/cardsheet/)** — Millimeter-accurate front/back duplex offset calibration for flashcards and tabletop cards.
- 🎲 **[Play *Star Chef Showdown* Free in Browser](https://963239327.github.io/craftleaf-studio/play/)** — Original 2-player rondel + blackjack-heat Print-and-Play board game with solo AI opponent.
## License
MIT © [CraftLeaf & Pixel Studio](https://963239327.github.io/craftleaf-studio/)
This server cannot be deployed
Maintenance
ActivityMaintained
ResponsivenessNo recent community issues