hyv scan
hyv scan checks a file or folder for ai-writing patterns and voice drift. it runs locally for free.
quick answer
the default first command after welcome.
use this for
- checking a draft before publish
- ci guardrails on markdown repos
- teaching an ai agent to audit text
steps
- run hyv scan draft.md
- read line-level flags and scores.
- fix issues manually or continue to hyv fix with a profile.
- use hyv scan path/ --fail-on-hit in ci when needed.
details to know
- scan does not send full draft text to hyv servers on the free tier.
- output includes pattern names you can grep in ci logs.
limits and edge cases
- binary files and very large trees may be skipped.
- scan is not a grammar checker — it targets voice and ai tells.
ready to install instead of reading about it?
npm i -g @holdyourvoice/hyv