nudgement

Small corrections. Clearer thinking.

A little nudge.
Better judgement.

Jev-based concept linting to nudge your LLM to improve its judgement.

nudgement reviews commit messages, code comments, tests and documentation. Run it yourself or let your coding agent use the findings to revise its work.

See a nudge in actionTry it in your repo

Open source MIT licensed Built on Jev

Error message · before

Encryption key must be of 22 characters. Live collaboration is disabled.

Use plainer words.

This collaboration link is invalid. Ask the sender for a new link.
An Excalidraw error, revised after a UI copy review. See the full nudgement.
A second look at

Commits / Code / Comments / Tests / Writing

01 / The nudgements

Four things
worth catching.

Real evaluator responses, with the edits they prompted.

Name what actually changed.

Source: ansi-regex

Before

Improve performance

The nudgement

The subject is generic. Name what actually changed.
Commit evaluator

After

fix: stop unterminated OSC strings consuming later escapes

Recorded evaluator responses. Proposed edits, not upstream changes. Read the full examples · Source licenses.

02 / Under the hood

What happens
in a review.

Each evaluator sends Jev the relevant context and a set of focused questions. For a commit, that includes checking whether the message matches the diff.

  1. 01

    Give it context.

    A file, a diff, a commit message. nudgement gathers the relevant context and runs exact checks.

    draft + context
  2. 02

    Ask a focused question.

    TypeSafe’s Jev returns structured judgements. Does this message match the diff? Would this test catch a broken implementation?

    questions → judgements
  3. 03

    Make a better call.

    nudgement turns those answers into findings. You or your coding agent decide what to change, then review the next draft.

    findings → revision

A nudge is a reason to take another look. It isn’t proof of correctness, and it doesn’t rewrite your code for you.

03 / Put it to work

Try it on
your next commit.

Run nudgement from your terminal, or give your coding agent the included skill to review its work before committing.

Explore the repositoryRead the agent skill
One more look before you commit 
# From your nudgement checkout
bun evaluate.ts /path/to/your-repo \
  --staged \
  -m "fix(cli): handle --help"
Needs Bun, a clone of the repo, and a Jev API key.
Setup instructions

Reviews send selected text and context to Jev and may incur API charges. The examples on this page use saved responses.