On-device checks in Terminal

AI Content Detector CLI for Claude, Codex, and Cursor

The slop CLI runs Slop or Not's AI text detector, AI image detector, raw OmniAID image scoring, readability analyzer, and cleanup tool from your Mac terminal. It returns JSON for Claude, Codex, Hermes Agent, OpenClaw, Cursor, scripts, and editors.

Moving from a cloud detector like ZeroGPT or GPTZero? Pipe in a draft, a screenshot, or a local file. Slop or Not scores it locally and never uploads it.

Runs locally: Text, image, readability, and cleanup checks stay on your Mac.
Outputs JSON: Use --json when scripts or agents need stable results.
Unlimited local checks: Pro removes the daily cap, so scripts and agents can run repeated text, image, readability, and cleanup checks locally.

Setup

How do I install the Slop or Not CLI?

Open Slop or Not for Mac once, activate Pro, then go to Settings > Command Line and let the app install the CLI. After that, verify it from Terminal with the app-bundle binary path.

# In Slop or Not: Settings > Command Line > Install
"/Applications/Slop Or Not.app/Contents/MacOS/slop" status --json

Command reference

What can the Slop or Not CLI do?

The command surface is small on purpose: status, text, image, score-image, readability, cleanup, and MCP.

slop status

Check your install

Confirms the CLI can find the app bundle and reports whether Pro is active.

View command and response

Run

"/Applications/Slop Or Not.app/Contents/MacOS/slop" status --json

Returns

{
  "localCachePro" : true,
  "pro" : true,
  "version" : "1.0.9"
}

slop text

Score AI text

Reads UTF-8 text from stdin and returns the same on-device AI probability used by the Mac app, plus readability metrics.

View command and response

Run

pbpaste | "/Applications/Slop Or Not.app/Contents/MacOS/slop" text --json

Returns

{
  "detectedLanguage" : "en",
  "detection" : {
    "result" : {
      "_0" : 0,
      "_1" : { "real" : {} }
    }
  },
  "readability" : {
    "detectedLanguage" : "en",
    "languageConfidence" : 0.9996,
    "scores" : [
      { "kind" : "fleschReadingEase", "direction" : "higherIsEasier", "label" : "<label>", "value" : 75.17 },
      { "kind" : "fleschKincaidGradeLevel", "direction" : "gradeLevel", "value" : 5.51 }
    ],
    "selectedLanguage" : "en",
    "stats" : { "wordCount" : 66, "sentenceCount" : 6, "syllableCount" : 94 },
    "warnings" : []
  },
  "sentenceCount" : 6
}

slop readability

Analyze readability

Returns Flesch scores in English and the supported language-specific formula for six other languages.

View command and response

Run

cat draft.md | "/Applications/Slop Or Not.app/Contents/MacOS/slop" readability --json

Returns

{
  "readability" : {
    "detectedLanguage" : "en",
    "languageConfidence" : 0.9996,
    "scores" : [
      { "kind" : "fleschReadingEase", "direction" : "higherIsEasier", "label" : "<label>", "value" : 88.54 },
      { "kind" : "fleschKincaidGradeLevel", "direction" : "gradeLevel", "value" : 2.65 }
    ],
    "selectedLanguage" : "en",
    "stats" : { "wordCount" : 35, "sentenceCount" : 5, "syllableCount" : 46 },
    "warnings" : []
  }
}

slop cleanup

Clean hidden text tricks

Removes zero-width spaces, homoglyphs, fancy punctuation, and other formatting tells before another check.

View command and response

Run

pbpaste | "/Applications/Slop Or Not.app/Contents/MacOS/slop" cleanup --json

Returns

{
  "cleanedText" : "<cleaned_text>",
  "detectedLanguage" : "en",
  "invisibleCounts" : [
    { "count" : 1, "kind" : "<invisible_character>" }
  ],
  "punctuationCounts" : [
    { "count" : 1, "kind" : "<punctuation_replacement>" }
  ],
  "homoglyphCounts" : [],
  "britishMappings" : []
}

slop image

Detect AI images

Checks piped JPEG, PNG, HEIC, or WebP image bytes locally, with optional OCR for screenshots.

View command and response

Run

"/Applications/Slop Or Not.app/Contents/MacOS/slop" image --json < ~/Desktop/screenshot.png

Returns

{
  "detection" : {
    "result" : {
      "_0" : 0.80,
      "_1" : { "most_likely_ai_slop" : {} }
    }
  }
}

slop score-image

Score images with OmniAID

Returns the raw OmniAID model score for a piped image when you need direct model feedback instead of the full image-detection response.

View command and response

Run

"/Applications/Slop Or Not.app/Contents/MacOS/slop" score-image --json < ~/Desktop/generated.png

Returns

{
  "rawSlopScore" : 0.690673828125
}

slop mcp

Start the MCP server

Exposes Slop or Not tools to Claude, Codex, Hermes Agent, OpenClaw, Cursor, and other MCP clients over stdio.

View command and response

Run

"/Applications/Slop Or Not.app/Contents/MacOS/slop" mcp --print-config

Returns

{
  "clients": [
    "Claude Desktop",
    "Claude Code",
    "Codex CLI",
    "Hermes Agent",
    "OpenClaw",
    "Cursor"
  ],
  "tools": [
    "detect_text",
    "analyze_readability",
    "clean_text",
    "detect_image",
    "score_image",
    "slop_status"
  ]
}

Fast paths

Common terminal workflows

These are the commands most people reach for first. Each one reads local input and prints a local result.

How do I score AI text from Terminal?

Copy a draft, pipe it into slop text, and read the JSON verdict. Add --json when another tool needs stable output.

pbpaste | "/Applications/Slop Or Not.app/Contents/MacOS/slop" text --json

How do I check readability?

Readability is separate from AI detection. Use it when you need a reading-level check without sending text to a web tool.

cat draft.md | "/Applications/Slop Or Not.app/Contents/MacOS/slop" readability --json

How do I clean hidden AI fingerprints?

Text Cleanup strips invisible characters, homoglyphs, and spacing tricks. It does not rewrite the text.

pbpaste | "/Applications/Slop Or Not.app/Contents/MacOS/slop" cleanup --json

How do I get a raw OmniAID image score?

Use score-image when an image-generation workflow needs the raw model signal, not the provenance-aware image detection result.

"/Applications/Slop Or Not.app/Contents/MacOS/slop" score-image --json < ~/Desktop/generated.png

How do I check an image file?

Use the app-bundle CLI command for screenshots, product shots, dating profile photos, and other files you want checked locally.

"/Applications/Slop Or Not.app/Contents/MacOS/slop" image --json < ~/Desktop/screenshot.png

Local AI detector API

Can I use the CLI as a local AI detector API?

For local automation, yes. The CLI reads stdin or local files and returns JSON, so scripts and editors can treat it like a local AI detector API without uploading text or images to a cloud endpoint. It is not a hosted HTTP API; the Mac app runs the check on the machine that calls the command.

pbpaste | "/Applications/Slop Or Not.app/Contents/MacOS/slop" text --json
"/Applications/Slop Or Not.app/Contents/MacOS/slop" image --json < ~/Desktop/source-photo.png
"/Applications/Slop Or Not.app/Contents/MacOS/slop" score-image --json < ~/Desktop/generated.png

MCP from CLI

How do I start MCP from the CLI?

The MCP server is a CLI subcommand. Run it directly when your MCP client asks for a command, or when you are debugging setup.

"/Applications/Slop Or Not.app/Contents/MacOS/slop" mcp

Set up MCP for Claude, Codex, Hermes Agent, OpenClaw, and Cursor Read the launch post agentic AI Humanizer guide