Deploy the Tentacles
Clean Your Docs

CLI tool for detecting and cleaning AI artifacts in your documentation. Batch process with parallel "tentacles" to keep your voice authentic and your content polished.

$ slopsquid scan docs/ --threads=8 --interactive
🦑

Why Choose SlopSquid?

🦑

Parallel Tentacles

Deploy multiple worker "tentacles" to process files simultaneously. Batch scan entire directory trees with configurable thread pools.

🔍

AI Pattern Detection

Identify corporate speak, buzzwords, and artificial writing patterns using advanced heuristic analysis and local AI models.

🏠

Local Processing

All AI analysis happens offline using local models. No cloud APIs, no data transmission, complete privacy by design.

🎯

Interactive Cleanup

Review each detection with confidence scoring. Accept, reject, or learn from corrections to improve future scans.

🔗

QRY Integration

Seamlessly integrates with uroboro for decision logging and osmotic for awareness patterns. Part of the QRY ecosystem.

📝

Multi-Format Support

Works with Markdown, HTML, plain text, and code comments. Perfect for documentation, README files, and content creation.

How the Tentacles Work

1

File Discovery

Recursively scan directories, filter by patterns, or target specific files. Git integration for staged file processing.

slopsquid scan docs/ --recursive
2

Deploy Tentacles

Multiple worker threads grab files in parallel and analyze content using local AI models with shared pattern detection.

--threads=8 --model=llama3.2:1b
3

Ink the Slop

Mark AI artifacts with confidence scoring. Interactive review, automated cleanup, or integration with your development workflow.

slopsquid clean --interactive --confidence=0.8

CLI Commands

Basic Scanning Batch Processing
# Scan single file
slopsquid scan README.md

# Parallel directory processing
slopsquid scan docs/ --recursive --threads=8

# Pre-commit integration
slopsquid scan --git-staged
Interactive Cleanup Smart Review
# Interactive mode with confidence filtering
slopsquid clean docs/ --interactive --confidence=0.8

# Auto-fix obvious patterns
slopsquid clean docs/ --auto-fix --safe

# Preview changes only
slopsquid clean docs/ --dry-run
QRY Integration Ecosystem
# Log to uroboro for decision tracking
slopsquid scan --uroboro-project=doc-cleanup

# Stream insights to osmotic
slopsquid scan --osmotic-feed

# Learn from corrections
slopsquid train file.md

Perfect For

👨‍💻 Developers

Clean up AI-assisted documentation, README files, and code comments. Pre-commit hooks for quality assurance.

📝 Technical Writers

Maintain authentic voice across documentation projects. Remove AI artifacts while preserving meaning.

✨ Content Creators

Polish drafts and articles by removing artificial writing patterns. Keep your unique voice consistent.

🔧 QRY Users

Integrate with uroboro, osmotic, and the broader QRY ecosystem for systematic content creation.

Deploy Your Own Tentacles

Coming Soon

SlopSquid CLI is in active development. The core architecture is complete and implementation is underway.

  • ✅ Local-first AI processing
  • ✅ Batch parallel processing
  • ✅ QRY ecosystem integration
  • 🔧 Interactive cleanup interface
  • 🔧 Pattern learning system

Install (Coming Soon)

curl -sSL https://slopsquid.com/install | bash

Build from Source

git clone https://github.com/QRY91/slopsquid
cd slopsquid
go build -o slopsquid ./cmd/slopsquid