v0.3.0 makes vivid-clean installable as a normal command-line tool, without asking people to clone the repo first.
Install
pipx install vivid-clean
vivid-clean setup --no-anthropies
vivid-clean doctorNew to the command line? The README now has a copy-paste prompt for an AI assistant that can install it for you and stop cleanly if something goes wrong.
What changed
- Added a packaged
vivid-clean setupflow that fetches the reviewed cleaner at its exact commit and installs the assistant skill. - Kept source checkouts working as before, while packaged installs store runtime files in the user's data directory.
- Added safe skill replacement, off-path backups and rollback when an install can't finish.
- Added a separate statistical-risk-reduction mode with provider-aware writing-backend checks.
- Added PyPI Trusted Publishing, a clean-wheel installation test, CodeQL and OpenSSF Scorecard.
- Moved GitHub Actions to pinned Node 24 releases.
- Added beginner, CLI and source installation routes to the README.
Still honest about the limits
vivid-clean removes deterministic marks its checks can identify. It doesn't promise “undetectable” writing or pretend to know what every private detector will decide. Missing statistical and proprietary checks stay not_checked in the report.
Full details: CHANGELOG.md