PromptsMay 11, 2026·2 min read

Ruler — One Source of Truth for Agent Rules

Ruler centralizes agent instructions in a .ruler/ directory and generates CLAUDE.md, AGENTS.md, Cursor rules, and MCP configs from one config.

Agent ready

This asset can be read and installed directly by agents

TokRepo exposes a universal CLI command, install contract, metadata JSON, adapter-aware plan, and raw content links so agents can judge fit, risk, and next actions.

Stage only · 29/100Stage only
Agent surface
Any MCP/CLI agent
Kind
CLI Tool
Install
Single
Trust
Trust: Community
Entrypoint
README.md
Universal CLI install command
npx tokrepo install 4f2539b3-dd26-40a0-ade4-9c300f752a20
Intro

Best for: teams using multiple coding agents who want consistent instructions and MCP config propagation across tools

Works with: Node.js + npm/npx, a repo with agent config files (CLAUDE.md/AGENTS.md/.cursor), optional nested project structures

Setup time: 10 minutes

Quant Data

  • Supports Claude Code, Cursor, Codex, Copilot and more (repo)
  • Setup time ~10 minutes

How to Use It Well

Start with a short .ruler/AGENTS.md that encodes your real workflow (tests, style, safety). Then turn on nested mode only where components truly differ.

Adoption Checklist

  • Start with one real task and keep the scope narrow
  • Capture a baseline: time-to-first-success and output quality
  • Version your config/skills so teammates stay in sync

Guardrails

Generated files should stay generated. Avoid manual edits downstream; treat .ruler/ as the only editable surface.

FAQ

Q: Is it production-ready? A: The README labels it as a beta research preview; adopt it in one repo first and keep rollbacks simple.

Q: How does it avoid drift? A: Rules live in .ruler/ and Ruler regenerates downstream config files, so you maintain one source of truth.

Q: Can it handle monorepos? A: Yes. The repo documents nested rule loading for multiple .ruler/ directories with scoped configs.


🙏

Source & Thanks

GitHub: https://github.com/intellectronica/ruler Owner avatar: https://avatars.githubusercontent.com/u/46264?v=4 License (SPDX): MIT GitHub stars (verified via api.github.com/repos/intellectronica/ruler): 2,688

Discussion

Sign in to join the discussion.
No comments yet. Be the first to share your thoughts.

Related Assets