avelone123123/slopguard

Stop AI agents from rotting your codebase with unverified slop.
SlopGuard is an ultra-fast, zero-overhead pure Rust firewall and Model Context Protocol (MCP) engine
that catches AI hallucinations, duplicate shadow utilities, type escapes, and dummy placeholders
before they pollute your git history.
cargo install --git https://github.com/avelone123123/slopguard.git --bin slopguard
or from local clone: cargo install --path .
## The Problem: AI Codebase Rot (The "Slop Accumulation" Effect)
When vibe-coding with Cursor, Claude Code, Windsurf, or Antigravity across multiple iterations, AI agents inevitably introduce invisible code decay:
1. Unfinished Placeholders: // TODO: implement later, throw new Error("not implemented"), or empty catch (e) {} blocks that swallow critical runtime exceptions.
2. Shadow Utility Proliferation: The model forgets you already have formatDate() in src/utils/date.ts, so it silently invents a duplicate format_date_str() in another file.
3. Type Safety Degradation: To appease the compiler, the agent replaces concrete domain interfaces with any, Record , @ts-ignore, or double-casts as unknown as any.
4. Ghost Dependencies: The agent imports packages (axios, lodash-es) not declared in your package.json.
5. Agent Scope Drift: You ask the agent to fix a button style, and it silently touches .env, config files, and core types.
6. Conversational Comment Bloat: Code littered with // Here is the updated logic:, // Step 1: Add listener, and duplicate trivial docstrings.
> Traditional linters (ESLint, Ruff, Biome) cannot catch these. They check syntax and formatting, not agentic behavioral degradation.
## Features
100% Native Rust: Single standalone binary without runtime bloat. Instant startup (
SlopGuard comes with an interactive, full-screen native terminal TUI application compiled directly into the binary. Simply double-click slopguard.exe in Windows Explorer or run:
bash
slopguard monitor
# or run without arguments:
slopguard
5 Multi-Function Diagnostic Views:
[1] OVERVIEW: Real-time moving telemetry wave oscilloscope, live MCP activity stream, hygiene gauge, and latency counters.
[2] ISSUES: Interactive findings inspector with ↑/↓ navigation, code snippets, and AI fix recommendations.
[3] MCP STREAM: Deep inspection of incoming MCP tool calls (slopguard_scan_diff, slopguard_check_snippet, slopguard_sanitize_file).
[4] FIREWALLS: Comprehensive 66-firewall active AST matrix with real-time enforcement status.
[5] REPOSITORY: Git diagnostic status, active branch, latest commit, and working tree breakdown.
Real-Time Animated Wave Oscilloscope: Moving multi-level ASCII/ANSI frequency spectrum visualizing MCP agent pulse and latency in real time.
Single-Key Controls:
[1..5] or [Tab] Switch diagnostic views instantly
[↑/↓] or [j/k] Navigate issue and event logs
[S] Instant full repository audit
[F] One-key conversational AI bloat sanitizer
[W] Toggle live file change watcher
[E] Export audit diagnostics report (slopguard-audit-report.json)
[R] Force refresh telemetry log
[Q] Clean exit
## Live Visual Observer Dashboard (slopguard ui)
Observe what your AI agent (Cursor, Claude Code, Windsurf, Antigravity) is doing in real time.