Skip to content

JonBoyle-Dev/Guardian-AI

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

50 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

GuardianAI 🛡️

Protects sensitive data before you press Enter.

GuardianAI is a Chrome extension that scans every prompt you type into Claude and ChatGPT before it reaches the AI — catching sensitive data like ID numbers, passwords, API keys, and email addresses before you accidentally share them. Everything runs locally in your browser. No cloud, no login, no storage of your prompts. Built in South Africa with POPIA compliance built in from day one.


What it detects

Type Risk POPIA
SA ID numbers 🔴 HIGH §26
AWS access keys 🔴 HIGH §19
JWT tokens 🔴 HIGH §19
Private key blocks 🔴 HIGH §19
Connection strings 🔴 HIGH §19
Email addresses 🟡 MEDIUM §11
SA phone numbers 🟡 MEDIUM §11
Custom keywords 🔴 HIGH
Source code patterns 🟢 LOW (silent)

Screenshots

Settings Keywords Audit Log
Settings Keywords Audit Log

How it works

  1. You type a prompt into Claude or ChatGPT
  2. GuardianAI scans it locally — 9 pattern types + your custom keywords
  3. Risk is assigned — HIGH blocks submission, MEDIUM shows a warning, LOW is silent
  4. You decide — Replace sensitive content in place, send anyway, or cancel
  5. Event logged locally — metadata only, never your prompt text

Privacy

  • ✅ 100% local — nothing leaves your browser
  • ✅ No cloud, no server, no API calls
  • ✅ No prompt text ever stored
  • ✅ Verifiable via Chrome DevTools Network tab — zero outbound requests
  • ✅ Audit log stores metadata only (timestamp, site, risk level, action)

Installation

GuardianAI is currently in private pilot and not yet available on the Chrome Web Store.

To install the pilot build:

  1. Download guardian-ai-0.5.2.zip and unzip to a permanent location
  2. Open Chrome and go to chrome://extensions
  3. Enable Developer mode (top-right toggle)
  4. Click Load unpacked and select the guardian-ai folder
  5. The GuardianAI shield icon appears in your toolbar — pin it
  6. The onboarding guide opens automatically

Do not delete the unzipped folder — Chrome loads the extension from it each time.


Features

  • Unified warning banner — red for HIGH risk, amber for MEDIUM
  • Replace in place — rewrites sensitive content with redaction tokens directly in the input field
  • Ignore & Scan After — pause scanning while you finish typing, then scan the full prompt at once
  • POPIA compliance mode — tags detections with relevant POPIA sections (§11, §19, §26)
  • Compliance mode dropdown — Off / POPIA / UK GDPR (coming soon) / CCPA (coming soon)
  • Custom keywords — add your own sensitive terms via the popup or CSV import
  • Enter/Send blocking — optionally block submission while a warning is active
  • Auto-sanitize silent mode — automatically replace sensitive content with no interruption
  • Local audit log — last 50 events, exportable as CSV
  • Light and dark mode
  • Keyboard shortcutAlt+Shift+S triggers a manual scan

Settings

Setting Options
Extension enabled On / Off
Compliance mode Off / POPIA / UK GDPR (soon) / CCPA (soon)
Block threshold Medium + High / High only
Auto-sanitize Off / Silent
Enter/Send blocking Off / Block on High / Block on Medium+High
Theme Dark / Light

Roadmap

Coming soon — v1 Personal

  • Microsoft Copilot support
  • UK GDPR compliance mode
  • CCPA compliance mode
  • Detection history and insights
  • Chrome Web Store submission

Future — v2 Business

  • Real-time webhook reporting to admin
  • Central policy pack push via MDM
  • Admin dashboard
  • Policy enforcement and lockdown
  • Org-level audit log
  • Claude desktop app support via MCP

Long-term — v3 Education

  • Playful mascot UI for schools
  • Gamification and badges
  • Teacher dashboard
  • SA digital citizenship curriculum alignment

Compliance

GuardianAI includes a POPIA (Protection of Personal Information Act) compliance mode for South African users. When enabled, every detection is tagged with the relevant section of the Act:

  • §11 — Personal Information (emails, phone numbers)
  • §19 — Security Safeguards (credentials, keys, connection strings)
  • §26 — Special Personal Information (SA ID numbers)

POPIA mode helps identify potentially regulated data. It does not guarantee legal compliance. Consult your Information Officer.


Tech stack

  • Chrome Extension Manifest V3
  • Vanilla JavaScript — no framework dependencies
  • Shadow DOM for overlay UI (no CSS conflicts with host pages)
  • chrome.storage.local for all persistence
  • Range-based DOM replacement (no layout shift)
  • MutationObserver for SPA reconnect

Project structure

guardian-ai/
├── manifest.json
├── background/
│   └── service-worker.js
├── content/
│   ├── detector.js        # Detection engine — pure function
│   ├── sanitizer.js       # Redaction logic
│   ├── siteConfig.js      # Per-site selectors
│   ├── auditLog.js        # 50-event ring buffer
│   ├── popia.js           # POPIA section mappings
│   ├── overlay.js         # Unified banner UI
│   ├── overlay.css        # Shadow DOM scoped styles
│   └── content.js         # Orchestrator
├── popup/
│   ├── popup.html
│   ├── popup.js
│   └── popup.css
├── onboarding/
│   ├── onboarding.html
│   ├── onboarding.css
│   └── onboarding.js
├── rules/
│   └── defaultKeywords.json
└── assets/
    ├── icons/
    └── fonts/

Supported platforms

Platform Status
claude.ai ✅ Active
chatgpt.com 🔧 In progress
gemini.google.com 📋 Planned
copilot.microsoft.com 📋 Planned

License

All rights reserved. GuardianAI is proprietary software. The name, logo, and brand identity may not be used without written permission.


Contact


GuardianAI — Protects sensitive data before you press Enter.

About

Scans every prompt you type into Claude, ChatGPT, and Gemini in real time. The moment it detects something sensitive — ID numbers, banking details, credentials, personal data — it stops you before you hit send. Locally. Privately. Zero data ever leaves your machine. Use Alt+Shift+S to trigger a manual scan at any time.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors