jev-code-reviewer README

The project's README from github.com/egma-ai/jev-code-reviewer. As one markdown file: README.md.

Jev-Code-Reviewer

Most PRs that are generated by agents today get YOLO merged because its hard for human mind to comprehend when your agent just suddenly shows up with 230 file changes. This is an attempt to reduce the mental burden by classifying each change in a review to P0, P1, P2. Only P0 are shown by default. The priorities are configurable. The diffs are also show using a natural language. The original code is one toggle away.

It runs on your computer, for reviewing your own coding agent's PRs, and posts nothing to GitHub.

Jev-Code-Reviewer on the demonstration PR

Watch the recording · Open the demo PR. The bundled recording uses real Jev classifications and labeled, prepared explanation copy (provenance).

Quick demo

Needs Node.js 22+.

git clone https://github.com/egma-ai/jev-code-reviewer.git
cd jev-code-reviewer
npm install
npm run demo

Open http://127.0.0.1:4731/demo for the replay, which makes no provider calls, or load the extension (below) and open the demo PR's Files changed page.

Review your own PR

Needs the GitHub CLI signed in (gh auth login) and a local clone whose origin is the PR's repository.

npm link                 # adds the jev-reviewer command
jev-reviewer setup       # stores your TypeSafe and OpenAI keys; run it in your own terminal
jev-reviewer doctor      # checks tools, key sources, the local server, and provider access
jev-reviewer serve       # leave running
jev-reviewer analyze --pr https://github.com/OWNER/REPO/pull/123 --repo /path/to/clone

Then in Chrome:

  1. Open chrome://extensions, turn on Developer mode, click Load unpacked, and pick this repo's extension/ folder.
  2. Run jev-reviewer token | pbcopy. In the extension popup, open Connection, paste, and click Save. It should say Paired.
  3. Open the PR's Files changed page (/pull/<n>/files) and turn on Show logic in place of code.

Optional: uv tool install graphifyy adds a local code graph for better context. To have your coding agent run analyze after it opens a PR, install the agent skill.

Good to know

Development

npm test
node scripts/test-extension.mjs   # needs Chromium and port 4731 free

See architecture, demo guide, and extension details.

MIT.

jev-code-reviewer (egma-ai/jev-code-reviewer)

Searching Database…

Что это?Jev — локальный инструмент ревью кода для пулл-реквестов, открытых кодинг-агентами: он присваивает каждому фрагменту диффа приоритет внимания P0, P1 или P2 и объясняет изменение естественным языком вместо сырого кода.
Это CLI-инструмент, браузерное расширение или и то и другое?Это три части, работающие вместе: локальный CLI на Node.js, который анализирует дифф; расширение для Chrome, накладывающее объяснения на страницу Files changed на GitHub; и агентский скилл, который ваш кодинг-агент может вызвать после открытия PR.
Как отревьюить свой PR с его помощью?Загрузите папку extension/ как распакованное расширение Chrome, выполните 'jev-reviewer token | pbcopy' и вставьте токен во всплывающем окне Connection расширения, затем откройте страницу Files changed пулл-реквеста и включите переключатель 'Show logic in place of code'.
Что нужно установить, прежде чем пробовать?Node.js 22+ и залогиненный GitHub CLI (gh auth login), плюс локальный клон, чей origin совпадает с репозиторием PR; для анализа требуется API-ключ OpenAI.
Он анализирует весь дифф, и работает ли на любой странице PR на GitHub?Нет: по умолчанию анализируются только первые 12 фрагментов диффа (до 100 с --max-units), файлы без анализа сохраняют исходный вид кода на GitHub, и работает это только на классической странице Files changed, а не на новой странице /changes.
Мой код куда-то отправляется?Да, шаг анализа отправляет изменённый код и окружающий контекст в TypeSafe и OpenAI; само расширение Chrome общается только с локальным сервером на 127.0.0.1:4731.
Как определяются приоритеты P0, P1, P2 и можно ли их менять?Они отражают, сколько человеческого внимания заслуживает изменение, а не его корректность. Файлы P0 по умолчанию раскрыты, а P1 и P2 стартуют свёрнутыми; пороги можно перенастроить, скопировав config/policy.json в файл .jev-reviewer.json в ревьюимом репозитории или передав --policy.
Где хранятся мои API-ключи?Ключи лежат в ~/.config/jev-reviewer/credentials.json (доступ только у владельца, без шифрования), а не в экспортируемых переменных шелла, поскольку шелл кодинг-агента часто не видит переменные окружения. Заменить ключ OpenAI можно командой 'node scripts/setup-keys.mjs --replace-openai'.
Можно попробовать без подключения своего PR?Да, в комплекте есть демо-запись с настоящими классификациями Jev и заготовленными текстами объяснений, которая воспроизводится без обращений к провайдерам, плюс открытый демо-PR, на котором можно опробовать расширение.
Что будет, если после запуска analyze в PR появятся новые коммиты?Старые отчёты никогда не показываются автоматически; расширение продолжает показывать исходный код GitHub, пока вы не перезапустите analyze и не нажмёте Refresh report.
Creator
egma-ai
Size
4 MB
Stars
144
Updated
CommitOct 05
Age
28d
Commits · 90 Days