# intellectronica/ruler

Ruler — apply the same rules to all coding agents

Repository: https://github.com/intellectronica/ruler
Canonical: https://ross.abutalabs.com/products/ruler
Homepage: https://okigu.com/ruler
Language: TypeScript
License: MIT
License Family: permissive
Topics: agents, ai, aider, claude-code, codex, cursor, github-copilot, vibe-coding, windsurf
Last push: 2026-08-26T18:01:49+00:00

## Health v2 (maintenance only)
Score: 78/100 (v2, computed 2026-09-03T02:39:23.370411+00:00)
- activity 99, release rhythm 78, longevity 33
- inputs: {"age_days": 470, "days_push": 7, "days_rel": 64, "gap_med": 2, "n_releases_24m": 70}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 2893, forks 159 (observed 2026-08-28T04:07:28.503208+00:00)

## What it is
Ruler is a CLI tool that centralizes AI coding assistant instructions in a single .ruler/ directory and automatically distributes them to the config files of supported agents like Cursor, Claude Code, Copilot, Aider, and Windsurf. It also propagates MCP server settings and automates .gitignore handling for generated configs.

## Use cases
- keep AI coding agent instructions in sync across tools
- stop duplicating rules for Cursor, Copilot, and Claude Code
- manage MCP server settings for multiple AI assistants
- set up per-directory AI rules in a monorepo
- onboard a new AI coding tool with existing project rules
- keep generated agent config files out of git

## When to choose
- you use multiple AI coding assistants and want one source of truth for instructions
- your team struggles with inconsistent or drifting agent guidance
- you want automated distribution of rules and MCP settings across agent configs

## When to avoid
- you use only one AI coding assistant and its native config is sufficient
- you need a fully stable, non-beta tool for critical workflows
- you need an agent framework or runtime rather than config management

## Facets
- artifact type: cli-tool
- maturity: active
- function: developer-tools, configuration-management, agent-framework, mcp
- domain: developer-tools
- platform: cli, cross-platform
- tags: ai-coding-agents, rules-management, cursor, claude-code, github-copilot, aider, windsurf, vibe-coding, single-source-of-truth, ai-agents, automation, nodejs

## Member repositories
- intellectronica/ruler (main) score 78

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:07:28.503208+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T18:48:15.312708+00:00, confidence not recorded.
  - readme: https://github.com/intellectronica/ruler (fetched 2026-08-28T04:07:28.503208+00:00, sha 3b657f642fa8)
  - homepage: https://okigu.com/ruler (fetched 2026-08-29T09:50:44.444879+00:00, sha f476e26e3ab4)
  - site_page: https://agentic-ventures.com/sunday-school/drop-in-vibe-on (fetched 2026-08-29T09:50:44.453720+00:00, sha 83a10cf9550c)
- Data as of 2026-08-30T08:39:29.467469+00:00.