ScopeOfAi is a VS Code extension designed to protect critical codebase files and directories from unauthorized or accidental modifications by external AI coding agents (such as Gemini, Claude, Cursor, Copilot, ChatGPT, or custom autonomous tools).
✨ Features
🔒 1-Click Interactive File Locking: View your entire workspace tree in the ScopeOfAi sidebar with interactive toggle switches. Ticking a file locks it instantly.
🛡️ Real-Time Save Interceptor: Intercepts file save events on locked files and blocks unauthorized write access.
🔑 Secret File Guardian: Automatically detect and lock .env, credentials, and security keys with 1-click.
📊 Protection Status Bar Item: Always see how many files are currently protected right in your VS Code status bar.
⚡ ScopeLock CLI Integration: Run npx scopelock check <filepath> or npx scopelock status to verify scope boundaries in terminal scripts or CI.
📜 Live Protection Log Stream: Monitor firewall activity and blocked edit attempts in real-time.
🚀 How It Works
Open the ScopeOfAi icon in the VS Code Activity Bar.
Browse your project files in the Workspace File Locks panel.
Toggle the switch next to any file or folder to LOCK it (🔒).
ScopeOfAi creates a .scopelock configuration file in your workspace root.
If an AI agent or process attempts to modify or save a locked file, ScopeOfAi blocks the edit and alerts you!
⚡ Extension Commands
Command
Title
Description
scopofai.toggleLockCurrentFile
ScopeOfAi: Lock/Unlock Current File
Toggle protection for the file open in active editor
scopofai.lockSecrets
ScopeOfAi: Lock Secret Files
Automatically find and lock .env, keys, credentials
scopofai.unlockAll
ScopeOfAi: Unlock All Files
Remove protection locks from all workspace files
scopofai.openSidebar
ScopeOfAi: Open Sidebar
Focus the ScopeOfAi firewall panel
🛠️ CLI Usage
# Check if a file is protected by ScopeOfAi
npx scopelock check src/config/auth.ts
# Check overall ScopeLock status
npx scopelock status
