@yagyeshvyas/vibeguard 0.1.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +600 -0
- package/bin/cli.js +1640 -0
- package/ci/vibeguard.yml +41 -0
- package/ci-templates/Jenkinsfile +26 -0
- package/ci-templates/azure-pipelines.yml +29 -0
- package/ci-templates/circleci.yml +24 -0
- package/ci-templates/gitlab.yml +19 -0
- package/hooks/pre-commit +31 -0
- package/package.json +94 -0
- package/src/ai-guard.js +205 -0
- package/src/ast.js +319 -0
- package/src/audit-trail.js +154 -0
- package/src/autofix.js +524 -0
- package/src/badge.js +42 -0
- package/src/behavior.js +205 -0
- package/src/compliance.js +151 -0
- package/src/crosstaint.js +324 -0
- package/src/cve-intel.js +136 -0
- package/src/dashboard.js +279 -0
- package/src/deps.js +159 -0
- package/src/doctor.js +111 -0
- package/src/engine.js +234 -0
- package/src/external.js +160 -0
- package/src/firewall.js +517 -0
- package/src/history.js +87 -0
- package/src/hook.js +151 -0
- package/src/install.js +248 -0
- package/src/interceptor.js +476 -0
- package/src/mcp-server.js +1804 -0
- package/src/net-audit.js +208 -0
- package/src/pii.js +212 -0
- package/src/plugin.js +80 -0
- package/src/policy-gen.js +288 -0
- package/src/pre-deploy.js +282 -0
- package/src/presets.js +113 -0
- package/src/privacy-audit.js +273 -0
- package/src/repl.js +150 -0
- package/src/report.js +312 -0
- package/src/rules-pack.js +2753 -0
- package/src/rules.js +1446 -0
- package/src/sandbox.js +139 -0
- package/src/scanner.js +651 -0
- package/src/secure-prompt.js +140 -0
- package/src/slopsquat.js +144 -0
- package/src/supply-firewall.js +243 -0
- package/src/suppress.js +89 -0
- package/src/taint.js +168 -0
- package/src/trace.js +220 -0
- package/src/urlscan.js +142 -0
- package/src/vault.js +145 -0
- package/src/verify.js +98 -0
- package/src/verifykeys.js +87 -0
package/README.md
ADDED
|
@@ -0,0 +1,600 @@
|
|
|
1
|
+
<div align="center">
|
|
2
|
+
|
|
3
|
+
<!-- Animated Banner -->
|
|
4
|
+
<img src="https://readme-typing-svg.herokuapp.com?font=Fira+Code&weight=600&size=28&pause=1000&color=2E75B6¢er=true&vCenter=true&random=false&width=600&lines=VibeGuard;Security+%26+Privacy+for+AI-Coded+Apps;699+Rules+%7C+76+MCP+Tools;13+Defense+Layers;Zero+Telemetry+%7C+%240+Cost" alt="VibeGuard Animated Banner" />
|
|
5
|
+
|
|
6
|
+
<br/>
|
|
7
|
+
|
|
8
|
+
<!-- Badges -->
|
|
9
|
+

|
|
10
|
+

|
|
11
|
+

|
|
12
|
+

|
|
13
|
+

|
|
14
|
+

|
|
15
|
+

|
|
16
|
+

|
|
17
|
+

|
|
18
|
+

|
|
19
|
+

|
|
20
|
+
|
|
21
|
+
<br/>
|
|
22
|
+
|
|
23
|
+
<!-- Tagline -->
|
|
24
|
+
<h3>The Security & Privacy Platform Built for Vibe Coders</h3>
|
|
25
|
+
|
|
26
|
+
<p>AI coding tools (Claude Code, Cursor, Windsurf, Lovable, Bolt) ship fast — and often ship hardcoded secrets, open databases, injection holes, and privacy violations. <b>VibeGuard catches all of it.</b></p>
|
|
27
|
+
|
|
28
|
+
<p><b>699 rules</b> · <b>76 MCP tools</b> · <b>58 CLI commands</b> · <b>13 defense layers</b> · <b>43 auto-fixes</b> · <b>12 AI clients</b> · <b>14 languages</b> · <b>20+ frameworks</b> · <b>$0 cost</b> · <b>zero telemetry</b></p>
|
|
29
|
+
|
|
30
|
+
<br/>
|
|
31
|
+
|
|
32
|
+
<!-- Install -->
|
|
33
|
+
## 📦 Install
|
|
34
|
+
|
|
35
|
+
### Option 1: From npm (when published)
|
|
36
|
+
```bash
|
|
37
|
+
npx @yagyeshvyas/vibeguard install
|
|
38
|
+
```
|
|
39
|
+
|
|
40
|
+
### Option 2: From GitHub (works now!)
|
|
41
|
+
|
|
42
|
+
```bash
|
|
43
|
+
git clone https://github.com/yagyeshVyas/VibeGuard.git
|
|
44
|
+
cd VibeGuard
|
|
45
|
+
npm install
|
|
46
|
+
npm link # makes 'vibeguard' available globally
|
|
47
|
+
```
|
|
48
|
+
|
|
49
|
+
Then use it:
|
|
50
|
+
```bash
|
|
51
|
+
vibeguard scan # scan your project
|
|
52
|
+
vibeguard dashboard # beautiful terminal dashboard
|
|
53
|
+
vibeguard fix # auto-fix 43 rule types
|
|
54
|
+
vibeguard pre-deploy # 13-gate deployment check
|
|
55
|
+
vibeguard firewall "your prompt here" # AI firewall
|
|
56
|
+
```
|
|
57
|
+
|
|
58
|
+
### Wire into Claude Code (from GitHub clone)
|
|
59
|
+
|
|
60
|
+
```bash
|
|
61
|
+
# In your project directory:
|
|
62
|
+
echo '{ "mcpServers": { "vibeguard": { "command": "node", "args": ["/path/to/VibeGuard/bin/cli.js", "mcp"] } } }' > .mcp.json
|
|
63
|
+
```
|
|
64
|
+
|
|
65
|
+
Or use the global Claude Code command:
|
|
66
|
+
```bash
|
|
67
|
+
claude mcp add vibeguard -- node /path/to/VibeGuard/bin/cli.js mcp
|
|
68
|
+
```
|
|
69
|
+
|
|
70
|
+
### Wire into Cursor / Windsurf / other MCP clients
|
|
71
|
+
|
|
72
|
+
Add to your MCP config file:
|
|
73
|
+
```json
|
|
74
|
+
{
|
|
75
|
+
"mcpServers": {
|
|
76
|
+
"vibeguard": {
|
|
77
|
+
"command": "node",
|
|
78
|
+
"args": ["/path/to/VibeGuard/bin/cli.js", "mcp"]
|
|
79
|
+
}
|
|
80
|
+
}
|
|
81
|
+
}
|
|
82
|
+
```
|
|
83
|
+
|
|
84
|
+
### Wire into Codex CLI
|
|
85
|
+
|
|
86
|
+
```bash
|
|
87
|
+
# Add to ~/.codex/config.toml:
|
|
88
|
+
[mcp_servers.vibeguard]
|
|
89
|
+
command = "node"
|
|
90
|
+
args = ["/path/to/VibeGuard/bin/cli.js", "mcp"]
|
|
91
|
+
```
|
|
92
|
+
|
|
93
|
+
<p>Auto-detects 12 AI coding clients: <b>Claude Code, Cursor, Windsurf, Codex CLI, Antigravity, Gemini CLI, Continue, Cline, Roo Code, OpenHands, Aider, VS Code</b></p>
|
|
94
|
+
|
|
95
|
+
<!-- AI Client Logos -->
|
|
96
|
+
<table>
|
|
97
|
+
<tr>
|
|
98
|
+
<td align="center">🔵</td>
|
|
99
|
+
<td align="center">🟣</td>
|
|
100
|
+
<td align="center">🟢</td>
|
|
101
|
+
<td align="center">🟡</td>
|
|
102
|
+
<td align="center">🔴</td>
|
|
103
|
+
<td align="center">🟠</td>
|
|
104
|
+
<td align="center">⚫</td>
|
|
105
|
+
</tr>
|
|
106
|
+
<tr>
|
|
107
|
+
<td align="center"><sub>Claude Code</sub></td>
|
|
108
|
+
<td align="center"><sub>Cursor</sub></td>
|
|
109
|
+
<td align="center"><sub>Windsurf</sub></td>
|
|
110
|
+
<td align="center"><sub>Codex CLI</sub></td>
|
|
111
|
+
<td align="center"><sub>Antigravity</sub></td>
|
|
112
|
+
<td align="center"><sub>Gemini CLI</sub></td>
|
|
113
|
+
<td align="center"><sub>Continue</sub></td>
|
|
114
|
+
</tr>
|
|
115
|
+
<tr>
|
|
116
|
+
<td align="center"><sub>Cline</sub></td>
|
|
117
|
+
<td align="center"><sub>Roo Code</sub></td>
|
|
118
|
+
<td align="center"><sub>OpenHands</sub></td>
|
|
119
|
+
<td align="center"><sub>Aider</sub></td>
|
|
120
|
+
<td align="center"><sub>VS Code</sub></td>
|
|
121
|
+
<td align="center"><sub>+ more</sub></td>
|
|
122
|
+
<td align="center"></td>
|
|
123
|
+
</tr>
|
|
124
|
+
</table>
|
|
125
|
+
|
|
126
|
+
<br/>
|
|
127
|
+
|
|
128
|
+
```bash
|
|
129
|
+
vibeguard scan # scan your project
|
|
130
|
+
vibeguard dashboard # beautiful terminal dashboard
|
|
131
|
+
vibeguard fix # auto-fix 43 rule types
|
|
132
|
+
vibeguard pre-deploy # 13-gate deployment check
|
|
133
|
+
```
|
|
134
|
+
|
|
135
|
+
</div>
|
|
136
|
+
|
|
137
|
+
---
|
|
138
|
+
|
|
139
|
+
<!-- Table of Contents -->
|
|
140
|
+
<div align="center">
|
|
141
|
+
<h2>📖 What is VibeGuard?</h2>
|
|
142
|
+
</div>
|
|
143
|
+
|
|
144
|
+
VibeGuard is a **free, zero-dependency security and privacy scanner** that runs entirely on your machine. It reads your code files locally, checks them against 699 security rules, and tells you exactly what's wrong and how to fix it — all without sending a single byte to any server.
|
|
145
|
+
|
|
146
|
+
It's built specifically for the problems AI coding tools create:
|
|
147
|
+
- Hardcoded API keys visible in browser dev tools
|
|
148
|
+
- Supabase/Firebase databases open to the world (no RLS)
|
|
149
|
+
- Admin endpoints with no authentication
|
|
150
|
+
- SQL injection, command injection, XSS
|
|
151
|
+
- Secrets committed to git history
|
|
152
|
+
- Hallucinated npm packages that don't exist
|
|
153
|
+
- User data sent to AI APIs without redaction
|
|
154
|
+
- Analytics tracking without consent (GDPR violation)
|
|
155
|
+
- WebRTC IP leaks, clipboard theft, geolocation without consent
|
|
156
|
+
|
|
157
|
+
---
|
|
158
|
+
|
|
159
|
+
<div align="center">
|
|
160
|
+
<h2>🛡️ 13-Layer Defense Architecture</h2>
|
|
161
|
+
</div>
|
|
162
|
+
|
|
163
|
+
Even if an AI is **fully jailbroken**, it cannot leak data. Each layer runs automatically when the MCP server starts.
|
|
164
|
+
|
|
165
|
+
<table>
|
|
166
|
+
<tr>
|
|
167
|
+
<th>#</th>
|
|
168
|
+
<th>Layer</th>
|
|
169
|
+
<th>Module</th>
|
|
170
|
+
<th>What It Catches</th>
|
|
171
|
+
<th>When</th>
|
|
172
|
+
</tr>
|
|
173
|
+
<tr>
|
|
174
|
+
<td align="center">1</td>
|
|
175
|
+
<td><b>Static Scanner</b></td>
|
|
176
|
+
<td><code>scanner.js</code></td>
|
|
177
|
+
<td>699 security rules across 14 languages</td>
|
|
178
|
+
<td>Before deploy</td>
|
|
179
|
+
</tr>
|
|
180
|
+
<tr>
|
|
181
|
+
<td align="center">2</td>
|
|
182
|
+
<td><b>AI Firewall</b></td>
|
|
183
|
+
<td><code>firewall.js</code></td>
|
|
184
|
+
<td>Prompt injection, jailbreaks, secret access</td>
|
|
185
|
+
<td>Before LLM call</td>
|
|
186
|
+
</tr>
|
|
187
|
+
<tr>
|
|
188
|
+
<td align="center">3</td>
|
|
189
|
+
<td><b>Agent Guard</b></td>
|
|
190
|
+
<td><code>firewall.js</code></td>
|
|
191
|
+
<td>Dangerous file/command/network access</td>
|
|
192
|
+
<td>Before agent action</td>
|
|
193
|
+
</tr>
|
|
194
|
+
<tr>
|
|
195
|
+
<td align="center">4</td>
|
|
196
|
+
<td><b>Runtime Interceptor</b></td>
|
|
197
|
+
<td><code>interceptor.js</code></td>
|
|
198
|
+
<td>Wraps fetch/http/exec/fs at runtime level</td>
|
|
199
|
+
<td>During execution</td>
|
|
200
|
+
</tr>
|
|
201
|
+
<tr>
|
|
202
|
+
<td align="center">5</td>
|
|
203
|
+
<td><b>Output Guard</b></td>
|
|
204
|
+
<td><code>interceptor.js</code></td>
|
|
205
|
+
<td>Secrets/PII in AI responses → redacted</td>
|
|
206
|
+
<td>After LLM response</td>
|
|
207
|
+
</tr>
|
|
208
|
+
<tr>
|
|
209
|
+
<td align="center">6</td>
|
|
210
|
+
<td><b>Exfil Firewall</b></td>
|
|
211
|
+
<td><code>firewall.js</code></td>
|
|
212
|
+
<td>PII/secrets in outbound data → blocked</td>
|
|
213
|
+
<td>Before any request</td>
|
|
214
|
+
</tr>
|
|
215
|
+
<tr>
|
|
216
|
+
<td align="center">7</td>
|
|
217
|
+
<td><b>Env Lock</b></td>
|
|
218
|
+
<td><code>interceptor.js</code></td>
|
|
219
|
+
<td>Hides sensitive env vars from AI</td>
|
|
220
|
+
<td>At process start</td>
|
|
221
|
+
</tr>
|
|
222
|
+
<tr>
|
|
223
|
+
<td align="center">8</td>
|
|
224
|
+
<td><b>Self-Protection</b></td>
|
|
225
|
+
<td><code>interceptor.js</code></td>
|
|
226
|
+
<td>Detects tampering with VibeGuard itself</td>
|
|
227
|
+
<td>Continuous</td>
|
|
228
|
+
</tr>
|
|
229
|
+
<tr>
|
|
230
|
+
<td align="center">9</td>
|
|
231
|
+
<td><b>Zero-Trust Sandbox</b></td>
|
|
232
|
+
<td><code>sandbox.js</code></td>
|
|
233
|
+
<td>Locked VM: no fs, no exec, no network</td>
|
|
234
|
+
<td>Code execution</td>
|
|
235
|
+
</tr>
|
|
236
|
+
<tr>
|
|
237
|
+
<td align="center">10</td>
|
|
238
|
+
<td><b>Behavioral Analysis</b></td>
|
|
239
|
+
<td><code>behavior.js</code></td>
|
|
240
|
+
<td>Trust building, data gathering, slow exfil</td>
|
|
241
|
+
<td>Over session</td>
|
|
242
|
+
</tr>
|
|
243
|
+
<tr>
|
|
244
|
+
<td align="center">11</td>
|
|
245
|
+
<td><b>Supply Chain Firewall</b></td>
|
|
246
|
+
<td><code>supply-firewall.js</code></td>
|
|
247
|
+
<td>Malware, typosquats, dangerous scripts</td>
|
|
248
|
+
<td>Before npm install</td>
|
|
249
|
+
</tr>
|
|
250
|
+
<tr>
|
|
251
|
+
<td align="center">12</td>
|
|
252
|
+
<td><b>Secret Vault</b></td>
|
|
253
|
+
<td><code>vault.js</code></td>
|
|
254
|
+
<td>AES-256-GCM encrypted in-memory storage</td>
|
|
255
|
+
<td>Secret access</td>
|
|
256
|
+
</tr>
|
|
257
|
+
<tr>
|
|
258
|
+
<td align="center">13</td>
|
|
259
|
+
<td><b>Audit Trail</b></td>
|
|
260
|
+
<td><code>audit-trail.js</code></td>
|
|
261
|
+
<td>SHA-256 chained tamper-proof log</td>
|
|
262
|
+
<td>All actions</td>
|
|
263
|
+
</tr>
|
|
264
|
+
</table>
|
|
265
|
+
|
|
266
|
+
---
|
|
267
|
+
|
|
268
|
+
<div align="center">
|
|
269
|
+
<h2>🔥 What VibeGuard Catches</h2>
|
|
270
|
+
</div>
|
|
271
|
+
|
|
272
|
+
<details>
|
|
273
|
+
<summary><b>🔓 The #1 r/vibecoding Issue: Open Databases</b></summary>
|
|
274
|
+
|
|
275
|
+
If you use Supabase, Firebase, or Convex, VibeGuard checks:
|
|
276
|
+
- **RLS missing** — table created but row-level security never enabled
|
|
277
|
+
- **RLS fake policy** — `USING (true)` — looks enabled in dashboard, protects nothing
|
|
278
|
+
- **PERMISSIVE policy** — allows access unless another policy blocks it
|
|
279
|
+
- **Service role key in client** — bypasses RLS entirely
|
|
280
|
+
- **Firebase rules open** — `.read: true` or `.write: true`
|
|
281
|
+
- **Firebase rules any-auth** — `auth != null` means ANY logged-in user sees ALL data
|
|
282
|
+
- **Convex public query** — exported query with no auth check
|
|
283
|
+
</details>
|
|
284
|
+
|
|
285
|
+
<details>
|
|
286
|
+
<summary><b>🔑 Secrets (50+ types)</b></summary>
|
|
287
|
+
|
|
288
|
+
OpenAI, Anthropic, Stripe (live + restricted), AWS, GitHub, Slack, GitLab, Twilio, SendGrid, Mailgun, Telegram, npm, Resend, GCP, Azure, Cloudflare, Datadog, Sentry, Algolia, Vercel, Netlify, Heroku, DigitalOcean, Notion, Linear, Contentful, PlanetScale, Vault, Doppler, Grafana, Jira, PagerDuty, New Relic, Splunk, Braintree, Square, Paddle, MUX, Mailchimp, Postmark, Sendinblue, Twitch, Patreon, Discord, Bitbucket, JFrog, LaunchDarkly, Rollbar, Mapbox, Twilio SID, and more.
|
|
289
|
+
|
|
290
|
+
Plus: connection strings with passwords, `.env` not in `.gitignore`, secrets in localStorage/sessionStorage, secrets in URL params, secrets in client-side config files.
|
|
291
|
+
</details>
|
|
292
|
+
|
|
293
|
+
<details>
|
|
294
|
+
<summary><b>💉 Injection (30+ rules)</b></summary>
|
|
295
|
+
|
|
296
|
+
- **SQL injection** — string concat, template literals, f-strings, format(), % formatting, raw queries across Prisma, Drizzle, Sequelize, TypeORM, Kysely, MikroORM, Turso, Hono, Go, Python, PHP, C#, Kotlin, Rust
|
|
297
|
+
- **Command injection** — exec/spawn with user input, template literals, backtick interpolation
|
|
298
|
+
- **Code injection** — eval, new Function, setTimeout/setInterval with strings, vm.runInContext
|
|
299
|
+
- **XSS** — dangerouslySetInnerHTML, v-html, innerHTML, outerHTML, document.write, insertAdjacentHTML, Angular DomSanitizer bypass, Rails html_safe, Laravel `{!! !!}`
|
|
300
|
+
- **SSTI** — template render with user input (EJS, Pug, Handlebars, Mustache)
|
|
301
|
+
- **LDAP, XPath, NoSQL $where, header injection, log injection, CSV formula injection, PDF injection**
|
|
302
|
+
- **SSRF** — fetch to internal IPs, cloud metadata service (169.254.169.254), DNS rebinding
|
|
303
|
+
</details>
|
|
304
|
+
|
|
305
|
+
<details>
|
|
306
|
+
<summary><b>🔐 Auth (20+ rules)</b></summary>
|
|
307
|
+
|
|
308
|
+
- JWT alg:none, weak JWT secret, JWT decoded without verify
|
|
309
|
+
- Hardcoded admin credentials
|
|
310
|
+
- Password compared with `==` (plaintext)
|
|
311
|
+
- Session fixation (no regenerate after login)
|
|
312
|
+
- No rate limiting on login/register
|
|
313
|
+
- Password in query string
|
|
314
|
+
- Missing MFA enforcement
|
|
315
|
+
- OAuth state parameter empty/static
|
|
316
|
+
- Token in URL
|
|
317
|
+
- No logout endpoint
|
|
318
|
+
</details>
|
|
319
|
+
|
|
320
|
+
<details>
|
|
321
|
+
<summary><b>🤖 AI/LLM Security (35+ rules)</b></summary>
|
|
322
|
+
|
|
323
|
+
- Prompt injection in tool descriptions
|
|
324
|
+
- AI agent can execute code, deploy, install packages, access secrets, modify auth
|
|
325
|
+
- LLM output used as SQL, shell, DOM, file path
|
|
326
|
+
- Data exfiltration via agent
|
|
327
|
+
- Memory poisoning
|
|
328
|
+
- Training data leakage
|
|
329
|
+
- Agent loop without iteration cap
|
|
330
|
+
- Tool result injection
|
|
331
|
+
- Missing max_tokens, temperature too high
|
|
332
|
+
- Browser API key exposure
|
|
333
|
+
- **Secure prompt analysis** — analyzes your prompt BEFORE code generation
|
|
334
|
+
</details>
|
|
335
|
+
|
|
336
|
+
<details>
|
|
337
|
+
<summary><b>📦 Supply Chain (15+ rules)</b></summary>
|
|
338
|
+
|
|
339
|
+
- **Slopsquat detection** — hallucinated npm packages that don't exist
|
|
340
|
+
- Typosquat detection
|
|
341
|
+
- Postinstall scripts with curl/wget/eval
|
|
342
|
+
- Unpinned Docker images (:latest)
|
|
343
|
+
- GPL/AGPL license risk
|
|
344
|
+
- Missing integrity hashes
|
|
345
|
+
- git+http dependencies
|
|
346
|
+
- Crypto miners in dependencies
|
|
347
|
+
- Missing .npmrc
|
|
348
|
+
</details>
|
|
349
|
+
|
|
350
|
+
<details>
|
|
351
|
+
<summary><b>🏗️ Infrastructure (40+ rules)</b></summary>
|
|
352
|
+
|
|
353
|
+
- **Terraform**: S3 public, IAM wildcard, SG 0.0.0.0/0, RDS public, no encryption, no KMS rotation, hardcoded keys, no backup, no CloudTrail
|
|
354
|
+
- **Kubernetes**: run-as-root, no readOnly FS, hostPath, hostPID/IPC, no NetworkPolicy, privileged, SYS_ADMIN, no seccomp, no probes, no security context
|
|
355
|
+
- **Docker**: no USER directive, no HEALTHCHECK, privileged, no resource limits, secrets in env, :latest
|
|
356
|
+
- **Docker Compose**: no resource limits, secrets in environment, privileged, host network, weak restart policy
|
|
357
|
+
- **GitHub Actions**: script injection, write-all permissions, unpinned actions
|
|
358
|
+
- **CI/CD**: GitLab secrets in YAML, Jenkins credentials, CircleCI context, AWS CDK secrets, CloudFormation, Helm, Ansible, Pulumi
|
|
359
|
+
</details>
|
|
360
|
+
|
|
361
|
+
<details>
|
|
362
|
+
<summary><b>🔒 Privacy Protection (50+ rules)</b></summary>
|
|
363
|
+
|
|
364
|
+
VibeGuard is the only scanner that protects user **privacy**, not just security:
|
|
365
|
+
- WebRTC IP leak, clipboard reads, geolocation, camera/microphone
|
|
366
|
+
- Canvas fingerprinting, device fingerprinting, Bluetooth scanning
|
|
367
|
+
- Analytics without consent (Google Analytics, Mixpanel, Segment, PostHog, Amplitude, Facebook Pixel, Hotjar, FullStory)
|
|
368
|
+
- Cookies without banner (ePrivacy/GDPR)
|
|
369
|
+
- Sentry with PII, PII in logs, health data access, biometric data
|
|
370
|
+
- Background location, contacts/photos/SMS/call log access
|
|
371
|
+
- EXIF location leak, keystroke listeners, SRI missing
|
|
372
|
+
</details>
|
|
373
|
+
|
|
374
|
+
---
|
|
375
|
+
|
|
376
|
+
<div align="center">
|
|
377
|
+
<h2>⚡ Privacy Commands</h2>
|
|
378
|
+
</div>
|
|
379
|
+
|
|
380
|
+
```bash
|
|
381
|
+
vibeguard privacy-audit # inventory all PII collection, storage, transmission
|
|
382
|
+
vibeguard net-audit # map every outbound HTTP call (where does data go?)
|
|
383
|
+
vibeguard ai-guard # detect user data sent to AI APIs without redaction
|
|
384
|
+
vibeguard privacy-policy # auto-generate a privacy policy from code analysis
|
|
385
|
+
vibeguard csp-generate # auto-generate Content-Security-Policy from code
|
|
386
|
+
vibeguard firewall <prompt> # AI firewall — inspect prompt before sending to LLM
|
|
387
|
+
vibeguard agent-guard # show blocked paths, commands, domains
|
|
388
|
+
vibeguard exfil-check <data> # check data for PII/secrets before sending externally
|
|
389
|
+
vibeguard dep-firewall <pkg> # check package name before npm install
|
|
390
|
+
vibeguard sandbox <code> # execute code in zero-trust sandbox
|
|
391
|
+
vibeguard output-guard <text> # sanitize AI response for secrets/PII
|
|
392
|
+
vibeguard env-lock # lock environment variables — hide secrets from AI
|
|
393
|
+
vibeguard self-check # verify VibeGuard hasn't been tampered with
|
|
394
|
+
vibeguard pre-deploy # run all 13 security gates before deployment
|
|
395
|
+
```
|
|
396
|
+
|
|
397
|
+
### PII Detection & Redaction
|
|
398
|
+
|
|
399
|
+
```js
|
|
400
|
+
const { detectPII, redactText } = require('vibeguard/pii');
|
|
401
|
+
|
|
402
|
+
const text = 'Contact john@example.com or 555-123-4567. Card: 4242424242424242';
|
|
403
|
+
const detected = detectPII(text); // [{ type: 'email', ... }, { type: 'credit-card', ... }]
|
|
404
|
+
const safe = redactText(text); // 'Contact [REDACTED_EMAIL] or [REDACTED_PHONE]. Card: ****4242'
|
|
405
|
+
```
|
|
406
|
+
|
|
407
|
+
Detected types: email, phone, SSN, credit card (Luhn-validated), AWS keys, JWTs, private keys, IP addresses, IBANs, MAC addresses.
|
|
408
|
+
|
|
409
|
+
---
|
|
410
|
+
|
|
411
|
+
<div align="center">
|
|
412
|
+
<h2>🚀 Pre-Deploy Gate (13 Gates)</h2>
|
|
413
|
+
</div>
|
|
414
|
+
|
|
415
|
+
Run all 13 security gates before deployment. If ANY gate fails, deployment is blocked.
|
|
416
|
+
|
|
417
|
+
```bash
|
|
418
|
+
vibeguard pre-deploy # run all gates
|
|
419
|
+
vibeguard pre-deploy --strict # fail on warnings too
|
|
420
|
+
vibeguard pre-deploy --json # JSON output for CI/CD
|
|
421
|
+
```
|
|
422
|
+
|
|
423
|
+
| # | Gate | What It Checks |
|
|
424
|
+
|---|------|------|
|
|
425
|
+
| 1 | Static Scan | 699 rules — any critical? |
|
|
426
|
+
| 2 | Secret Scan | Secrets exposed in code? |
|
|
427
|
+
| 3 | Git History | .env tracked in git? |
|
|
428
|
+
| 4 | Dependency Audit | Slopsquat/typosquat? |
|
|
429
|
+
| 5 | Supply Chain | Lockfile, scripts, licenses? |
|
|
430
|
+
| 6 | Privacy Audit | PII collection/storage/transmission? |
|
|
431
|
+
| 7 | Network Audit | Suspicious outbound domains? |
|
|
432
|
+
| 8 | AI Data Guard | User data to AI APIs without redaction? |
|
|
433
|
+
| 9 | Compliance | SOC2/PCI/HIPAA/GDPR? |
|
|
434
|
+
| 10 | Config Check | .env in .gitignore? MCP installed? |
|
|
435
|
+
| 11 | Self-Check | All VibeGuard modules intact? |
|
|
436
|
+
| 12 | Tamper Check | No tampering with VibeGuard? |
|
|
437
|
+
| 13 | Behavioral Check | No suspicious patterns? |
|
|
438
|
+
|
|
439
|
+
---
|
|
440
|
+
|
|
441
|
+
<div align="center">
|
|
442
|
+
<h2>📊 Numbers</h2>
|
|
443
|
+
</div>
|
|
444
|
+
|
|
445
|
+
<table>
|
|
446
|
+
<tr><th>Metric</th><th>Value</th><th></th></tr>
|
|
447
|
+
<tr><td>Rules</td><td><b>699</b></td><td>🔒</td></tr>
|
|
448
|
+
<tr><td>MCP tools</td><td><b>76</b></td><td>🤖</td></tr>
|
|
449
|
+
<tr><td>CLI commands</td><td><b>58</b></td><td>💻</td></tr>
|
|
450
|
+
<tr><td>Auto-fixable rules</td><td><b>43</b></td><td>🔧</td></tr>
|
|
451
|
+
<tr><td>Defense layers</td><td><b>13</b></td><td>🛡️</td></tr>
|
|
452
|
+
<tr><td>Pre-deploy gates</td><td><b>13</b></td><td>🚀</td></tr>
|
|
453
|
+
<tr><td>AI clients</td><td><b>12</b></td><td>🧠</td></tr>
|
|
454
|
+
<tr><td>Languages</td><td><b>14</b></td><td>🌐</td></tr>
|
|
455
|
+
<tr><td>Frameworks</td><td><b>20+</b></td><td>⚡</td></tr>
|
|
456
|
+
<tr><td>Presets</td><td><b>12</b></td><td>⚙️</td></tr>
|
|
457
|
+
<tr><td>Privacy rules</td><td><b>50+</b></td><td>🔒</td></tr>
|
|
458
|
+
<tr><td>Firewall rules</td><td><b>30+</b></td><td>🔥</td></tr>
|
|
459
|
+
<tr><td>AI Firewall threats</td><td><b>20+</b></td><td>🧱</td></tr>
|
|
460
|
+
<tr><td>PII types detected</td><td><b>10+</b></td><td>👁️</td></tr>
|
|
461
|
+
<tr><td>Source modules</td><td><b>43</b></td><td>📦</td></tr>
|
|
462
|
+
<tr><td>Tests</td><td><b>236</b></td><td>✅</td></tr>
|
|
463
|
+
<tr><td>Lint errors</td><td><b>0</b></td><td>✨</td></tr>
|
|
464
|
+
<tr><td>Dependencies</td><td><b>1</b> (MCP SDK)</td><td>📦</td></tr>
|
|
465
|
+
<tr><td>Cost</td><td><b>$0</b></td><td>💚</td></tr>
|
|
466
|
+
<tr><td>Telemetry</td><td><b>None</b></td><td>🔒</td></tr>
|
|
467
|
+
<tr><td>Data sent to servers</td><td><b>None</b></td><td>🔒</td></tr>
|
|
468
|
+
</table>
|
|
469
|
+
|
|
470
|
+
---
|
|
471
|
+
|
|
472
|
+
<div align="center">
|
|
473
|
+
<h2>🔒 Privacy Guarantee</h2>
|
|
474
|
+
</div>
|
|
475
|
+
|
|
476
|
+
**VibeGuard never sends your code, secrets, API keys, or personal information anywhere.**
|
|
477
|
+
|
|
478
|
+
| What | Network? | When |
|
|
479
|
+
|------|----------|------|
|
|
480
|
+
| `vibeguard scan` | **Never** | Local file read + regex match |
|
|
481
|
+
| `vibeguard fix` | **Never** | Local file edit |
|
|
482
|
+
| `vibeguard install` | **Never** | Local config write |
|
|
483
|
+
| `vibeguard mcp` | **Never** | stdio transport only |
|
|
484
|
+
| `vibeguard cve` | Opt-in | Package name → OSV.dev (free API) |
|
|
485
|
+
| `vibeguard url` | Opt-in | URL you type → fetch headers |
|
|
486
|
+
| `--verify-keys` | Opt-in | Key → provider that owns it |
|
|
487
|
+
|
|
488
|
+
**No telemetry. No analytics. No tracking. No data collection. No uploads.**
|
|
489
|
+
|
|
490
|
+
---
|
|
491
|
+
|
|
492
|
+
<div align="center">
|
|
493
|
+
<h2>⚙️ Presets</h2>
|
|
494
|
+
</div>
|
|
495
|
+
|
|
496
|
+
```bash
|
|
497
|
+
vibeguard preset nextjs # Next.js + React
|
|
498
|
+
vibeguard preset django # Django + Python
|
|
499
|
+
vibeguard preset rails # Ruby on Rails
|
|
500
|
+
vibeguard preset spring # Spring Boot + Java
|
|
501
|
+
vibeguard preset aws # AWS / Terraform
|
|
502
|
+
vibeguard preset gcp # Google Cloud
|
|
503
|
+
vibeguard preset azure # Azure
|
|
504
|
+
vibeguard preset api # REST / GraphQL API
|
|
505
|
+
vibeguard preset mobile # React Native / mobile
|
|
506
|
+
vibeguard preset fullstack # all rules (maximum coverage)
|
|
507
|
+
```
|
|
508
|
+
|
|
509
|
+
---
|
|
510
|
+
|
|
511
|
+
<div align="center">
|
|
512
|
+
<h2>🔧 CI/CD</h2>
|
|
513
|
+
</div>
|
|
514
|
+
|
|
515
|
+
```bash
|
|
516
|
+
vibeguard init-ci # GitHub Actions (SARIF + fail on CRITICAL)
|
|
517
|
+
vibeguard install-hook # git pre-commit hook (blocks on critical)
|
|
518
|
+
vibeguard install-hook-post # PostToolUse hook (auto-scan after AI edits)
|
|
519
|
+
vibeguard pr-comment # GitHub PR comment format (markdown)
|
|
520
|
+
```
|
|
521
|
+
|
|
522
|
+
Templates included for: **GitLab CI**, **Jenkins**, **CircleCI**, **Azure Pipelines**.
|
|
523
|
+
|
|
524
|
+
---
|
|
525
|
+
|
|
526
|
+
<div align="center">
|
|
527
|
+
<h2>💻 Languages & Frameworks</h2>
|
|
528
|
+
</div>
|
|
529
|
+
|
|
530
|
+
**Languages (14):** JavaScript, TypeScript, Python, Go, Java, Ruby, PHP, C#, Rust, Kotlin, Swift, Bash, SQL, YAML
|
|
531
|
+
|
|
532
|
+
**Frameworks (20+):** Next.js, React, Remix, Astro, SolidStart, SvelteKit, Nuxt, Django, Flask, Rails, Laravel, Spring Boot, NestJS, Fastify, Express, Hono, tRPC, Gin, Echo, Drizzle, Prisma, Sequelize, TypeORM, Kysely, MikroORM, Convex, Turso, Clerk, Auth.js, Supabase, Firebase, Stripe, Polar, LemonSqueezy, Resend, Upstash, Pinecone, PostHog, Uploadthing
|
|
533
|
+
|
|
534
|
+
**Compliance:** SOC 2, PCI-DSS, HIPAA, GDPR, ISO 27001, EU AI Act
|
|
535
|
+
|
|
536
|
+
---
|
|
537
|
+
|
|
538
|
+
<div align="center">
|
|
539
|
+
<h2>🛠️ Development</h2>
|
|
540
|
+
</div>
|
|
541
|
+
|
|
542
|
+
```bash
|
|
543
|
+
npm install
|
|
544
|
+
npm test # 236 tests
|
|
545
|
+
npm run lint # 0 errors
|
|
546
|
+
npm run coverage # coverage report
|
|
547
|
+
```
|
|
548
|
+
|
|
549
|
+
---
|
|
550
|
+
|
|
551
|
+
<div align="center">
|
|
552
|
+
<h2>📖 Honest Scope</h2>
|
|
553
|
+
</div>
|
|
554
|
+
|
|
555
|
+
VibeGuard catches the **mechanical** security holes that AI tools leave behind. It does NOT:
|
|
556
|
+
- Prove your app is safe or leak-proof
|
|
557
|
+
- Track personal data end-to-end through your app automatically
|
|
558
|
+
- Judge business logic flaws
|
|
559
|
+
- Replace a real security review for anything touching money, auth, or personal data
|
|
560
|
+
|
|
561
|
+
It **raises the floor fast** — catching the holes that AI tools create by default.
|
|
562
|
+
|
|
563
|
+
---
|
|
564
|
+
|
|
565
|
+
<div align="center">
|
|
566
|
+
<h2>📄 License</h2>
|
|
567
|
+
|
|
568
|
+
MIT — Free forever. No ads. No tracking. No data collection.
|
|
569
|
+
|
|
570
|
+
</div>
|
|
571
|
+
|
|
572
|
+
---
|
|
573
|
+
|
|
574
|
+
<div align="center">
|
|
575
|
+
|
|
576
|
+
<!-- Author Section -->
|
|
577
|
+
<img src="https://readme-typing-svg.herokuapp.com?font=Fira+Code&weight=600&size=22&pause=1000&color=2E75B6¢er=true&vCenter=true&random=false&width=400&lines=Made+with+%E2%9D%A4%EF%B8%8F+by;Yagyesh+Vyas" alt="Made by Yagyesh Vyas" />
|
|
578
|
+
|
|
579
|
+
<br/>
|
|
580
|
+
|
|
581
|
+
<a href="https://www.linkedin.com/in/yagyeshvyas/">
|
|
582
|
+
<img src="https://img.shields.io/badge/LinkedIn-0077B5?style=for-the-badge&logo=linkedin&logoColor=white" alt="LinkedIn" />
|
|
583
|
+
</a>
|
|
584
|
+
<a href="https://github.com/yagyeshVyas">
|
|
585
|
+
<img src="https://img.shields.io/badge/GitHub-100000?style=for-the-badge&logo=github&logoColor=white" alt="GitHub" />
|
|
586
|
+
</a>
|
|
587
|
+
|
|
588
|
+
<br/>
|
|
589
|
+
<br/>
|
|
590
|
+
|
|
591
|
+
<p><b>⭐ If VibeGuard helped you, star the repo!</b></p>
|
|
592
|
+
|
|
593
|
+
<p>Found a bug? <a href="https://github.com/yagyeshVyas/VibeGuard/issues">Open an issue</a></p>
|
|
594
|
+
<p>Want to contribute? <a href="https://github.com/yagyeshVyas/VibeGuard/pulls">Submit a PR</a></p>
|
|
595
|
+
|
|
596
|
+
<br/>
|
|
597
|
+
|
|
598
|
+
<p><sub>VibeGuard v0.1.0 · MIT License · 699 rules · 76 MCP tools · 13 defense layers · $0 cost · zero telemetry</sub></p>
|
|
599
|
+
|
|
600
|
+
</div>
|