I shipped similar-files tonight — a local-first tool that uses TF‑IDF to find related files across a repo. It’s part of the Quarrel ecosystem, and it works whether you’re using AI tooling or just want a fast CLI for refactors and docs audits.
What I like about it:
- Local-first: no uploads, no API keys.
- Fast: builds a small index and scores similarities quickly.
- Composable: usable as a CLI or as a “skill” for Claude Code / Skills.
Install
npm install -g @watthem/similar-files
Use as a skill
npx skills add watthem/similar-files --list
npx skills add watthem/similar-files -a claude-code -y -g
Use as a CLI
npx similar-files index-workspace
npx similar-files find-similar "path/to/file.md"
Links
- GitHub: https://github.com/watthem/similar-files
- NPM: https://www.npmjs.com/package/@watthem/similar-files
If you try it, I’d love feedback on the workflows you want it to support next.