mrso

Mrs Overall - A CLI tool that detects "AI slop" words in text files and rates their sloppiness.

Named after Mrs Overall from Acorn Antiques, the Victoria Wood comedy series.

Building

zig build

The binary will be at ./zig-out/bin/mrso.

Usage

mrso [OPTIONS] [FILE]

Reads from stdin if FILE is omitted or -.

Options

Score Calculation

The score is calculated as:

score = (sum of lift values for matched words / total words) × 1000

Higher scores indicate more "AI slop" words.

Features

• Case-insensitive matching
• Skips code blocks (fenced and inline)
• Skips links
• Skips frontmatter
• Strips punctuation from word boundaries
• Preserves internal hyphens in words
• Stdin/stdout support for pipeline workflows

Examples

Basic Usage

# Check a file, output to stdout
mrso file.md

# Read from stdin
cat file.md | mrso

# Write to file
mrso -o slopped.md file.md

Pipeline Workflows

# Get just the score for scripting
score=$(mrso --score-only file.md)
if [ "$score" -gt 100 ]; then
  echo "Too much slop!"
fi

# Fail CI if score exceeds threshold
mrso --max-score 100 file.md

# Quiet mode - just the processed text
cat file.md | mrso -q > clean.md

# Process a comment from stdin
echo "This is a genuinely honest response" | mrso

Process a Folder

# Check all markdown files in a folder
for f in docs/*.md; do
  echo "=== $f ==="
  mrso --score-only "$f"
done

# Check all files and fail if any exceed threshold
find . -name "*.md" -type f | while read -r f; do
  mrso --max-score 100 "$f" || echo "FAIL: $f"
done

# Batch process - create .slopped versions of all files
for f in docs/*.md; do
  mrso -o "${f%.md}.slopped.md" "$f"
done

# Find the sloppiest files
find . -name "*.md" -type f -exec sh -c 'echo "$(mrso --score-only "$1") $1"' _ {} \; | sort -rn | head -10

Recording the Demo

To regenerate demo.gif, install vhs and run:

vhs demo.tape

Acknowledgements

The word list is from Load-Bearing Words by Louis Abraham.

Example Output

Input:

This is a genuinely honest test.

Output:

This is a ~~genuinely~~ ~~honest~~ test.

Score: Slop score: 6403.3 (2 slop-words found in 6 words)