ai-tell 0.1.0

Local-first CLI for reviewing AI-edited or AI-written text.

ai-tell

Local-first CLI that flags AI-written or AI-edited passages in your .txt, .md, and .mdx files. It runs entirely on your machine — file content never leaves it.

uv tool install ai-tell
aitell setup        # one-time: pick a model and download
aitell scan docs

Each passage is grouped as likely human, AI-edited, or AI-written — never a percentage, because the score is a severity signal, not a probability of AI authorship. Treat it as an estimate, not proof.

Usage

aitell scan                      # scan the current directory
aitell scan docs report.md       # scan folders and files
cat draft.md | aitell scan -     # scan piped text
aitell scan docs --json          # machine-readable output
aitell scan docs --fail-on high  # CI: exit non-zero if a file looks AI-written

Models

Pick one with aitell setup, or per run with --model:

Model	--model	Size	Access
Greyscope Qwen3.5	greyscope-qwen	4B	none
Pangram EditLens RoBERTa	editlens-roberta	0.4B	account + Pangram approval
Pangram EditLens Llama 3.2	editlens-llama	3B	account + Pangram + Meta Llama

The EditLens models need a free Hugging Face account and owner approval; Greyscope is public, so it needs neither. Larger models are slower and use more memory.