CLI
The sounday command line tool - check files for AI tells offline and rewrite them through the API.
Run it with npx (Node 18 or newer), no install needed:
alias sounday='npx -y --package=https://sounday.ai/dl/sounday.tgz sounday'
Check (free, offline)
sounday check README.md content/ # files or directories (.md, .mdx, .txt, .html)
sounday check content/ --min-score 60 # exit code 1 if any file scores below 60
sounday check post.md --format json # machine-readable
cat draft.txt | sounday check - # stdin
Code blocks, inline code, HTML tags and front matter are ignored, so only your prose is scored.
Rewrite (API)
export SOUNDAY_API_KEY=sd_...
sounday rewrite post.md # prints the rewrite
sounday rewrite post.md --write # updates the file in place
sounday rewrite post.md --strength light --keep "flat feet,Acme Run 3"
sounday rewrite - --json < draft.md # full API response
A summary goes to stderr: style score before and after, whether facts were verified, chunks kept as original, and your monthly usage.
Other commands
sounday usage # plan and words used this month
sounday signup --email you@example.com
sounday mcp # MCP server on stdio