alint CLI
Линтер в стиле ESLint, где правила проверяет модель: ищет в коде, сгенерированном агентами, то, что синтаксис не ловит, и ставит вердикт в CI
- 137 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Содержимое проверяемых файлов отправляется выбранной модели, а при облачном провайдере уходит за пределы машины
- Каждое правило вызывает модель и тратит токены, а агентные правила могут читать другие файлы проекта
- Плагин Codex добавляет Stop-хук, который запускает проверку автоматически в конце хода
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add cli/alintОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Содержимое проверяемых файлов отправляется выбранной модели, а при облачном провайдере уходит за пределы машины
- Каждое правило вызывает модель и тратит токены, а агентные правила могут читать другие файлы проекта
- Плагин Codex добавляет Stop-хук, который запускает проверку автоматически в конце хода
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
alint — командная строка для анализа кода, сгенерированного агентами. Она похожа на ESLint: выбираются файлы, применяются именованные правила, печатаются диагностики в привычном формате, а код выхода понимает CI. Отличие в том, что правило решает через вызов модели или через агента с инструментами, когда одной синтаксической проверки мало. Подход применим к JavaScript и TypeScript, документам, сгенерированным файлам и любому содержимому, которое умеет читать плагин. Модель подключается к любому OpenAI-совместимому адресу, например Ollama, LM Studio, OpenRouter или OpenAI, а также через ACP-агентов Claude Code, Codex, Gemini CLI, Kimi Code CLI и OpenCode. Настройка идет командой `alint setup -N`, файл `.alint/config.toml` лежит в проекте, а правила описывает `alint.config.ts`. Запуск `alint src` проверяет каталог, `alint --dirty` берет только файлы, измененные относительно `HEAD`, а `--format json` дает машинный отчет для `alint output inspect`. Есть сервер языка `alint lsp` для редакторов и необязательный плагин Codex со Stop-хуком: он запускает `alint --dirty` перед завершением хода агента. Релизы включают отдельные бинарники, так что проекты на Python, Go и Rust обходятся без Node.js.
Для кого. Командам, где код пишут агенты, и ревьюерам, которым нужны проверяемые правила для намерений и стиля, а не только для синтаксиса.
Подходит, если
- Код от агентов проходит ESLint, но по смыслу расходится с замыслом, и это нужно ловить автоматически
- Правила из AGENTS.md и скиллов переносят в проверяемые правила, которые прогоняют в CI
- Перед завершением хода агент Codex должен проверить файлы, измененные за сессию
- Проверку гоняют на локальной модели через Ollama или LM Studio, чтобы цена прогонов оставалась предсказуемой
- Результат одного прогона сохраняют в JSON и смотрят позже, не тратя токены повторно
Не подходит, если
- Нужна детерминированная проверка синтаксиса и форматирования: для нее подходят обычные ESLint и Prettier
- Нет ни одной модели: правила решаются вызовами модели, а без провайдера прогон не запустится
- Нужна проверка без отправки исходников провайдеру: при облачной модели содержимое файлов уходит ей
- Нужен редактор с готовым расширением из Marketplace: расширение VS Code пока запускают из исходников
Пример запроса к агенту
Запусти alint --dirty и покажи диагностики по файлам, которые я менял, а потом исправь замечания уровня errorОграничения
Прогон правил тратит токены: каждое правило вызывает модель, поэтому большой каталог обходится дорого на облачных провайдерах. Для структурированного вывода alint принудительно вызывает инструмент, и модели вроде DeepSeek V4 отклоняют это в режиме рассуждения: в настройках нужно отключить `thinking`. Сервер `alint lsp` сам модель не вызывает, пока кэш пуст, диагностик нет. Последний коммит сделан в сентябре 2026 года, репозиторий указывает и организацию moeru-ai.
Как отключить. Удалите пакет командой `npm uninstall -g @alint-js/cli` и папку `.alint/` проекта. Плагин Codex удаляют средствами самого Codex.
Частые вопросы
Как установить alint?
Выполните `npm install -g @alint-js/cli` или добавьте пакет в проект через `npm install -D @alint-js/cli` и запускайте `npx alint src`. Без Node.js подойдет автономный бинарник из релизов GitHub.
Какие модели подходят для alint?
Любой OpenAI-совместимый адрес: Ollama, LM Studio, OpenRouter, OpenAI. Локальные модели автор советует для частых прогонов из-за предсказуемой цены. Агентов Claude Code и Codex подключают как модели через ACP.
Что означают коды выхода?
Код 0 говорит об отсутствии ошибок, даже если есть предупреждения. Код 1 означает хотя бы одну ошибку в диагностике, код 2 сообщает, что прогон не удалось завершить из-за конфигурации, ввода или сбоя.
Как проверить только измененные файлы?
Запустите `alint --dirty`. Команда берет файлы, отличающиеся от `HEAD`, включая неотслеживаемые, и пропускает игнорируемые и удаленные. Чистый репозиторий завершается успешно без вывода.
Как подключить alint к Codex?
Добавьте источник командой `codex plugin marketplace add moeru-ai/alint --sparse .agents/plugins --sparse plugins/codex-plugin-alint` и выполните `codex plugin add alint@alint`. Затем включите проверку для репозитория командой `alint config integrations stop-gate enable`.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыСтатический линтер инструкций агента: находит двусмысленные описания инструментов и пробелы в схемах до запуска, без модели и сети
Локальный отладчик TypeScript-агентов: дерево шагов, проверка траектории в CI и архив доказательств без аккаунта.
Поправки, которые вы даете агенту, становятся файлами-правилами в репозитории и проверяются локально и в CI одной командой.
Проверяет diff и переписку с агентом: ловит ошибки в коде и расхождения между вашей просьбой и тем, что агент сделал. CLI, скилл и GitHub Action
Проверяет пакеты Agent Skills: структуру, ссылки, объем в токенах и качество инструкций с оценкой моделью-судьей
Шаблон проекта Playwright на TypeScript с правилами и 17 скиллами, чтобы Claude Code, Codex и Cursor писали тесты по стандарту
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Звезды репозитория | Главное отличие |
|---|---|---|---|
| alint (эта карточка) | нет | 137 | |
| brooks-lint | нет | 1 564 | ревью кода по классическим книгам как скилл, без отдельного CLI с кодами выхода |
| code-review-skill | нет | 2 204 | скилл-инструкция для ревью по многим языкам, без отдельного линтера |
Коротко о README
README представляет alint как проверку кода, написанного агентами, и дает установку, настройку провайдера моделей и примеры запуска с флагами. Затем описаны просмотр конфигурации и сохраненного вывода, сервер для редакторов, плагин Codex со Stop-хуком и две системы конфигурации: настройка провайдеров в TOML и политика правил в `alint.config.ts`. Ниже идут пакеты монорепозитория и раздел о статусе.