Jev Review — плагин
Плагин с локальным MCP-сервером: агент оценивает качество своего кода по ряду критериев через Jev и улучшает его по баллам
- 247 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Отправляет задачу, diff и выбранные файлы в удаленный API Jev на домене typesafe.ai, поэтому закрытый код покидает машину
- Читает ключ JEV_API_KEY из окружения и передает его в заголовке запроса к Jev
- Сам код не меняет, все правки вносит основной агент
Установка
- Работает в
Ручная установка
export JEV_API_KEY="your-key"Ключ получают в консоли TypeSafe. Задайте его до запуска агента.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Отправляет задачу, diff и выбранные файлы в удаленный API Jev на домене typesafe.ai, поэтому закрытый код покидает машину
- Читает ключ JEV_API_KEY из окружения и передает его в заголовке запроса к Jev
- Сам код не меняет, все правки вносит основной агент
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Jev Review добавляет агенту один инструмент `jev_review`, который отправляет задачу, diff и выбранные файлы в сервис Jev компании TypeSafe и возвращает структурированные оценки качества. Агент остается автором правок. Плагин дает только числовой сигнал: баллы по измерениям вроде читаемости, безопасности, тестируемости, обработки ошибок, дублирования и структуры проекта, а также уровень уверенности и грубые подсказки по рубрике. Вместе с MCP-сервером в плагин входит скилл `jev-review`, который задает цикл работы. Агент делает связный кусок реализации и проверки, получает первую оценку как базу, сам разбирает слабые важные места и вносит минимальное оправданное улучшение. После этого он оценивает код снова, передавая `previousEvaluation`, и видит, что выросло, а что просело. Общего балла вроде «82 из 100» нет намеренно: видна динамика по измерениям, например читаемость с 6,3 до 8,1. Скилл требует остановиться, когда требования и проверки выполнены, а дальнейшая погоня за баллом почти не добавляет пользы. Корректность и требования пользователя всегда важнее оценки. Сервер работает локально по stdio на Node.js, а плагин ставится для Claude Code, Codex и Cursor, для OpenCode есть ручная настройка.
Для кого. Для разработчиков, которые поручают крупные правки Claude Code, Codex, Cursor или OpenCode и хотят внешний числовой контроль качества результата.
Подходит, если
- Агент закончил нетривиальную правку, и перед передачей вам нужна объективная оценка читаемости, дублирования и обработки ошибок
- Вы хотите увидеть динамику после рефакторинга: баллы по измерениям до и после, а не общее впечатление
- Нужно поймать слабые места в безопасности и тестируемости свежего кода до ревью коллег
- Вы используете несколько агентов и хотите одинаковый критерий качества для всех через один MCP-инструмент
- Ключ Jev API уже есть, а код нельзя отправлять через посредника: запросы идут напрямую в Jev с вашей машины
Не подходит, если
- Код нельзя отправлять во внешний сервис: выбранные задача, diff и файлы уходят в API Jev
- Нужен письменный разбор причин, почему оценка низкая: Jev возвращает типизированные решения, а не объяснение прозой
- Нужна замена сканерам уязвимостей: плагин дополняет специальные инструменты безопасности и не заменяет их
- У вас нет ключа Jev API из консоли TypeSafe: без него инструмент не запустится
Пример запроса к агенту
Закончи реализацию экспорта в CSV, прогони через jev-review результат и улучшай слабые измерения, пока оценки не перестанут заметно растиОграничения
- Нужны Node.js 20 или новее и ключ Jev API из консоли TypeSafe в переменной окружения JEV_API_KEY.
- Данные из аргументов `task`, `diff`, `files` и `repositoryContext` отправляются в удаленный API Jev. Секреты и посторонний закрытый код в них передавать нельзя.
- Плагин распространяется только из репозитория на GitHub, пакета в npm нет.
- Для OpenCode нет установки плагином, только ручная настройка MCP.
- Jev не объясняет оценку прозой: возвращает баллы, уровни уверенности и грубые подсказки по рубрике.
Как отключить. В Claude Code отключите или удалите плагин через /plugin либо выполните `claude mcp remove jev-review`, если подключали MCP вручную. Для Codex и Cursor уберите блок jev-review из `~/.codex/config.toml` или `~/.cursor/mcp.json`. Ключ JEV_API_KEY можно отозвать в консоли TypeSafe.
Частые вопросы
Как поставить Jev Review в Claude Code?
Задайте ключ командой `export JEV_API_KEY="your-key"`, затем выполните `npx plugins add NiazMorshed2007/jev-review --target claude-code`. После перезапуска проверьте подключение командой /mcp. Для Codex и Cursor меняется только значение --target.
Куда уходит мой код при вызове jev_review?
Только в API Jev по адресу api.typesafe.ai: передаются аргументы task, diff, files и repositoryContext, которые агент указал явно. Файлы репозитория автоматически не ищутся и не выгружаются. Размещенного бэкенда и телеметрии у плагина нет.
Какие измерения качества оценивает Jev Review?
Изменяемость, абстракции и API, структуру проекта, дублирование, сопровождаемость, тестируемость, надежность и обработку ошибок, безопасность, согласованность и документацию. Если в коде есть данные для этого, добавляются производительность, масштабируемость, совместимость и наблюдаемость.
Почему нет одного итогового балла?
Автор решил, что динамика отдельных измерений полезнее общей цифры. Например, читаемость выросла с 6,3 до 8,1, а безопасность осталась 8,2.
Как повторно оценить код после правки?
Вызовите `jev_review` снова с параметром `previousEvaluation`. Предыдущая оценка сравнивается локально и в запрос к Jev не попадает.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
ПлагиныОфициальный MCP-сервер CodeScene оценивает Code Health кода локально и подсказывает агенту, что рефакторить
Рецензирование правок агента до коммита на своей машине: комментарии к строкам читает и отвечает на них сам агент через MCP.
CLI и плагин для ревью кода агентом: читает git diff и пишет замечания по строкам с учетом контекста
Плагин для Claude Code: передает задачу локальному no_human и проверяет ветку ревьюером, не видевшим сессию кодера
Локальный граф структуры кода: строит карту репозитория через tree-sitter и отдает агенту по MCP только тот контекст, который относится к правке
Codex-скилл для проверки кода после вайбкодинга: объясняет блоки, называет файлы и строки, сверяет цель с доказательствами.
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| Jev Review (эта карточка) | нет | 247 | ||
| brooks-lint | нет | 1 561 | разбор кода по классическим книгам инженерии с цитатами источников, без внешней оценки по баллам | |
| code-review-graph | нет | не нужна | 32 612 | локальный граф структуры репозитория для ревью, без оценки качества через внешний сервис |
Коротко о README
Страница открывается быстрым стартом с требованиями и командой установки, затем показывает схему цикла оценки и настройку Claude Code, Codex, Cursor и OpenCode. Дальше идут список измерений качества, порядок работы агента, структура репозитория и раздел о безопасности и приватности.