commentcop

A little CLI that judges your code comments with Jev.

Is the comment accurate? Does it explain something useful? Or is it just "multiply by two" above value * 2?

Commentcop reads your JS/TS comments with the code around them and scores accuracy and usefulness out of 100. The weakest comments show up first. It respects .gitignore and skips generated code and dependencies.

Give it a go

Grab an API key from TypeSafe, then:

bun x commentcop setup
bun x commentcop

setup saves your key so you only have to do it once. You can also use TYPESAFE_API_KEY. Everything works with npx too.

Point it at another repo, or see every rating:

bun x commentcop ~/code/your-project
bun x commentcop --all

Use --dry-run to preview what it finds without calling Jev. Add exclusions with --ignore or a .commentcopignore file. --help has the rest.

What to expect

We checked 159 comments for about $0.008. The CLI shows progress as ratings come back and gives you an estimated cost at the end.

Some comments need context beyond the nearby code. Check the confidence alongside the score, and use the ratings as a starting point for review.

Comments and surrounding code are sent to TypeSafe for rating. Your setup key stays in ~/.config/commentcop/config.json unless you've set XDG_CONFIG_HOME.

Requires Bun, Node 22.18+ on the 22.x line, or Node 24.11+.

Working on it locally

bun install
bun run dev . --all