EnvWizard is an intent-based local runtime guardian and port unjammer extension for VS Code, Cursor, and Antigravity. It sits alongside GitWizard as part of the DrOpenSource Calm Dev Suite.
⚡ Why EnvWizard?
Vibe coders iterate conversationally: asking AI models to generate entire features, spin up servers, and configure environment variables. But local dev environments break constantly:
Port Traffic Jams (EADDRINUSE): A forgotten background server hogs port 3000 or 5173.
Missing Secrets: AI introduces process.env.STRIPE_KEY into code, but your local .env doesn't have it, causing unhandled runtime crashes.
Ghost Servers: Forgotten Node/Python child processes eat 25% CPU silently.
EnvWizard translates terrifying operating system errors into calm, plain-English intent cards with 1-click healing.
🌟 Core Features
1. 🚦 Real-Time Port Radar & 1-Click Unjammer
Live radar in your Status Bar: 🔌 Dev: All Clear or 🚨 Busy: :3000.
1-Click to safely evict the background process and free the door in < 100ms.
Safe Process Shield: Protected PIDs (system processes, Docker daemon, IDE itself) can never be accidentally killed.
Detects missing variables and template drift against .env.example.
1-click appends starter placeholder variables with # Added by EnvWizard comments.
3. 🧹 1-Click Clean Slate
One click terminates all orphaned Node, Python, Vite, and dev servers running in the background.
4. 🏷️ $9.99 One-Time Lifetime License
No Subscriptions: Developers prefer simple, pay-once pricing.
Free tier gives you manual 1-click port unjamming forever.
$9.99 Pro tier unlocks automatic background daemon, AST file-save watchers, and multi-project routing.
🛠️ Development & Testing
# Run isolated unit & integration tests (Vitest)
npm test
# Typecheck TypeScript codebase
npm run compile
# Build extension bundle with esbuild
npm run build
