Repository navigation
painpoints 0.1.0
First release.
painpoints scores every source file in a repository on six architectural pain dimensions and hands AI coding agents a ranked, self-explaining report.
- Six dimensions with levels written from published guidance: Google eng-practices, Google SRE, web.dev, the Amazon Builders' Library and OWASP. Every finding carries the URL of the standard it was judged against.
- Three entry points sharing one cache:
painpoints <file> --jsonfor one atomic result,painpoints <repo> --jsonfor the whole codebase,painpoints mcpfor an MCP server exposingpainpoints_fileandpainpoints_repo. - The JSON report is the cache. Unchanged files cost no tokens; a fully cached run needs no API key.
- Native viewer (GPUI) with per-dimension distribution, heat cells and a panel that explains which level each score landed on.
- Ships a Claude Code skill under
.claude/skills/painpoints.
Needs a TypeSafe API key (TYPESAFE_API_KEY), or TYPESAFE_BASE_URL pointed at a gateway. Windows x64 binary attached; other platforms build with cargo build --release.