CLI-инструмент для создания README-файлов репозитория с помощью LLM или офлайн, без API-ключа.
intellectronica/ruler
CLI хранит единый набор правил в Markdown в .ruler/ и генерирует файлы инструкций и конфигурации MCP для более чем 30 AI-агентов для программирования.
- Звёзды
- 2,963
- Форки
- 166
- Открытые issues
- 21
- Последний коммит
- 3 дня назад
Что это?
Ruler помогает поддерживать единые рекомендации по написанию кода для нескольких AI-ассистентов, каждый из которых ожидает свой файл, например CLAUDE.md, правила .cursor или .clinerules. Вы один раз записываете инструкции в Markdown-файлы в каталоге .ruler/, а команда ruler apply размещает их в файлах конфигурации, которые читает каждый поддерживаемый агент.
Помимо файлов с правилами, Ruler позволяет задавать настройки MCP-серверов в ruler.toml и записывать их в нативную конфигурацию MCP каждого агента, а также передавать навыки и определения субагентов агентам, которые их поддерживают. Инструмент также исключает сгенерированные файлы из системы контроля версий, обновляя .gitignore, и создаёт резервные копии, чтобы команда ruler revert могла восстановить исходные файлы.
Инструмент поддерживает экспериментальный вложенный режим: он находит несколько каталогов .ruler/ в монорепозитории, чтобы у разных компонентов могли быть собственные правила. Пакет опубликован в npm под именем @intellectronica/ruler и требует Node.js версии 20.19 или новее.
Ключевые возможности
- 01Хранит все инструкции для агентов в Markdown в едином каталоге .ruler/.
- 02Создаёт файлы с правилами для более чем 30 агентов, включая Claude Code, Cursor, Copilot, Codex CLI и Windsurf.
- 03Записывает определения MCP-серверов из ruler.toml в нативную конфигурацию MCP каждого агента.
- 04Автоматически обновляет .gitignore для сгенерированных файлов и создаёт резервные копии .bak.
- 05Позволяет отменить изменения, внесённые командой apply, с помощью ruler revert.
- 06Поддерживает экспериментальную загрузку вложенных правил для монорепозиториев.
Сценарии использования
- Команда использует и Claude Code, и Cursor и хочет применять в обоих одинаковые стандарты написания кода.
- Поддерживать единый набор соглашений проекта в актуальном состоянии, когда разработчики используют разные AI-ассистенты.
- Монорепозитории, где для каталогов frontend, backend и тестов нужны разные инструкции для агентов.
- Распространять общие настройки MCP-серверов среди нескольких агентов для программирования, не редактируя конфигурацию каждого вручную.
Быстрый старт
- 1
Установите Ruler глобально с помощью npm
npm install -g @intellectronica/ruler - 2
Перейдите в корень проекта и инициализируйте каталог .ruler/
ruler init - 3
Отредактируйте файлы правил в .ruler/, затем сгенерируйте файлы конфигурации агента
ruler apply
Что важно знать
- Требуется Node.js версии ^20.19.0, ^22.12.0 или >=23.
- Проект всё ещё находится на этапе исследовательского бета-превью, поэтому его поведение может измениться.
- Загрузка вложенных правил — экспериментальная функция, которая может измениться в будущих выпусках.
В подборках
Темы
Частые вопросы
- Что такое ruler?
- CLI хранит единый набор правил в Markdown в .ruler/ и генерирует файлы инструкций и конфигурации MCP для более чем 30 AI-агентов для программирования. Ruler помогает поддерживать единые рекомендации по написанию кода для нескольких AI-ассистентов, каждый из которых ожидает свой файл, например CLAUDE.md, правила .cursor или .clinerules. Вы один раз записываете инструкции в Markdown-файлы в каталоге .ruler/, а команда ruler apply размещает их в файлах конфигурации, которые читает каждый поддерживаемый агент.
- ruler можно использовать бесплатно? Какая у него лицензия?
- ruler распространяется с открытым исходным кодом под лицензией MIT. Перед использованием в коммерческих продуктах проверьте условия лицензии.
- ruler всё ещё поддерживается?
- Активно поддерживается. Последний коммит в ruler — 4 нояб. 2026 г..
- Для чего можно использовать ruler?
- Команда использует и Claude Code, и Cursor и хочет применять в обоих одинаковые стандарты написания кода. Поддерживать единый набор соглашений проекта в актуальном состоянии, когда разработчики используют разные AI-ассистенты. Монорепозитории, где для каталогов frontend, backend и тестов нужны разные инструкции для агентов. Распространять общие настройки MCP-серверов среди нескольких агентов для программирования, не редактируя конфигурацию каждого вручную.
- Как установить ruler?
- Установите Ruler глобально с помощью npm: npm install -g @intellectronica/ruler Перейдите в корень проекта и инициализируйте каталог .ruler/: ruler init Отредактируйте файлы правил в .ruler/, затем сгенерируйте файлы конфигурации агента: ruler apply
- Где скачать ruler?
- Исходный код и инструкции по установке — на GitHub: https://github.com/intellectronica/ruler
Описание создано ИИ на основе README проекта. Статистика GitHub обновляется ежедневно.
Похожие проекты
Опенсорсный AI-агент от Google, который переносит Gemini в терминал и помогает анализировать, редактировать и автоматизировать работу с кодом.
Постоянная память для AI-агентов-разработчиков: автоматически сохраняет сессии и подбирает полезный контекст для следующих сессий в Claude Code, Cursor, Codex и других MCP-клиентах.
CLI для терминала, который превращает описания на обычном английском в YAML-воркфлоу для Claude Code, Codex, Gemini CLI и других кодинг-агентов с проверками качества.
MCP-сервер и CLI, которые передают AI-агентам для написания кода актуальную документацию и примеры кода для конкретных версий библиотек.
CLI с открытым исходным кодом для работы с coding-агентом в терминале через облачные API и локальные модели, например Ollama.