Repolode
intellectronica

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. 1

    Установите Ruler глобально с помощью npm

    npm install -g @intellectronica/ruler
  2. 2

    Перейдите в корень проекта и инициализируйте каталог .ruler/

    ruler init
  3. 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 в терминал и помогает анализировать, редактировать и автоматизировать работу с кодом.

108,8 тыс.+118 за неделю14,9 тыс.TypeScriptApache-2.0Активно поддерживаетсяОбновлён 22 часа назад

Постоянная память для AI-агентов-разработчиков: автоматически сохраняет сессии и подбирает полезный контекст для следующих сессий в Claude Code, Cursor, Codex и других MCP-клиентах.

30,2 тыс.+141 за неделю2,7 тыс.TypeScriptApache-2.0Обновлён 7 часов назад