Repolode
Enviar
intellectronica

intellectronica/ruler

Uma CLI que mantém regras em Markdown em .ruler/ e gera arquivos de instruções e configuração do MCP para mais de 30 agentes de programação com IA.

Ver no GitHub
Estrelas
2,962
Forks
166
Issues abertas
21
Último commit
anteontem

O que é?

Ruler resolve o problema de manter as mesmas orientações de programação em vários assistentes de IA, cada um esperando seu próprio arquivo, como CLAUDE.md, regras do .cursor ou .clinerules. Você escreve as instruções uma só vez em arquivos Markdown no diretório .ruler/, e o comando ruler apply as distribui para o arquivo de configuração lido por cada agente compatível.

Além dos arquivos de regras, o Ruler permite definir configurações de servidores MCP em ruler.toml e gravá-las na configuração MCP nativa de cada agente. Também pode propagar skills e definições de subagentes para os agentes que oferecem suporte a esses recursos. A ferramenta ainda mantém os arquivos gerados fora do controle de versão atualizando o .gitignore e cria backups para que ruler revert possa restaurar os arquivos originais.

A ferramenta oferece um modo aninhado experimental que encontra vários diretórios .ruler/ em um monorepo, permitindo que diferentes componentes tenham suas próprias regras. O Ruler é publicado no npm como @intellectronica/ruler e requer Node.js 20.19 ou mais recente.

Recursos principais

  • 01Armazena todas as instruções para os agentes em Markdown em um único diretório .ruler/.
  • 02Gera arquivos de regras para mais de 30 agentes, incluindo Claude Code, Cursor, Copilot, Codex CLI e Windsurf.
  • 03Grava definições de servidores MCP do ruler.toml na configuração MCP nativa de cada agente.
  • 04Atualiza automaticamente o .gitignore para os arquivos gerados e cria backups .bak.
  • 05Oferece o comando ruler revert para desfazer as alterações feitas por apply.
  • 06Oferece carregamento experimental de regras aninhadas para monorepos.

Casos de uso

  • Uma equipe que usa Claude Code e Cursor e quer manter os mesmos padrões de programação nos dois.
  • Manter um único conjunto de convenções do projeto sincronizado quando os desenvolvedores usam diferentes assistentes de IA.
  • Monorepos em que os diretórios de frontend, backend e testes precisam de instruções diferentes para os agentes.
  • Distribuir configurações compartilhadas de servidores MCP para vários agentes de programação sem editar cada configuração manualmente.

Início rápido

  1. 1

    Instale o Ruler globalmente via npm

    npm install -g @intellectronica/ruler
  2. 2

    Acesse a raiz do seu projeto e inicialize o diretório .ruler/

    ruler init
  3. 3

    Edite os arquivos de regras em .ruler/ e, em seguida, gere os arquivos de configuração do agente

    ruler apply

Antes de usar

  • Requer Node.js ^20.19.0, ^22.12.0 ou >=23.
  • Ainda está em prévia de pesquisa beta, então o comportamento pode mudar.
  • O carregamento de regras aninhadas é experimental e pode mudar em versões futuras.

Em coleções

Frameworks e apps de agentes de IA open sourceServidores MCPFerramentas de CLI e terminalGeradores de sites estáticos e ferramentas de documentação

Tópicos

#ai-agents#coding-assistant#configuration#llm#mcp#developer-tools#cli#markdown#agents#ai

Perguntas frequentes

O que é ruler?
Uma CLI que mantém regras em Markdown em .ruler/ e gera arquivos de instruções e configuração do MCP para mais de 30 agentes de programação com IA. Ruler resolve o problema de manter as mesmas orientações de programação em vários assistentes de IA, cada um esperando seu próprio arquivo, como CLAUDE.md, regras do .cursor ou .clinerules. Você escreve as instruções uma só vez em arquivos Markdown no diretório .ruler/, e o comando ruler apply as distribui para o arquivo de configuração lido por cada agente compatível.
ruler é gratuito? Qual é a licença?
ruler é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
ruler ainda é mantido?
Manutenção ativa. O último commit de ruler foi em 4 de nov. de 2026.
Para que posso usar ruler?
Uma equipe que usa Claude Code e Cursor e quer manter os mesmos padrões de programação nos dois. Manter um único conjunto de convenções do projeto sincronizado quando os desenvolvedores usam diferentes assistentes de IA. Monorepos em que os diretórios de frontend, backend e testes precisam de instruções diferentes para os agentes. Distribuir configurações compartilhadas de servidores MCP para vários agentes de programação sem editar cada configuração manualmente.
Como instalar ruler?
Instale o Ruler globalmente via npm: npm install -g @intellectronica/ruler Acesse a raiz do seu projeto e inicialize o diretório .ruler/: ruler init Edite os arquivos de regras em .ruler/ e, em seguida, gere os arquivos de configuração do agente: ruler apply
Onde consigo ruler?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/intellectronica/ruler

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados