Making Agents Really Reliable (MARR)

MARR is a configuration system for Claude Code that makes AI agents more predictable and effective through structured standards.

Marr is my real surname. I needed a configuration folder that Anthropic would never accidentally claim in .claude/, so I just used my own name and retrofitted a backronym. Peak efficiency, minimal narcissism. Honest! 😄

What is MARR?

MARR provides a two-layer configuration system for AI agents:

1. User-level (~/.claude/marr/) — Personal preferences applied across all projects
2. Project-level (.claude/marr/) — Project-specific standards and requirements

Standards cover git workflow, testing, MCP usage, documentation, and more. Projects stay self-contained while sharing common preferences.

Quick Start

# Install
npm install -g @virtualian/marr

# One-time user setup
marr init --user

# Initialize a project
marr init --project

# Or both at once
marr init --all

# Validate configuration
marr validate

Commands

Command	Description
marr init --user	Set up user-level config (run once per machine)
marr init --project	Initialize current project with MARR
marr init --all	Set up both user and project config
marr validate	Check configuration is valid
marr clean	Remove MARR configuration
marr doctor	Interactive conflict resolution
marr standard	Manage standards
marr sync	Sync standards between projects

Run marr <command> --help for detailed options.

Documentation

Full documentation at virtualian.github.io/marr

• Getting Started
• Configuration Guide
• CLI Reference
• Standards Reference

Development

git clone https://github.com/virtualian/marr.git
cd marr
npm install
npm run build
npm link

See the Contributing Guide for more.

License

ISC