Rulebook
A native macOS app that finds, compares, merges and audits the CLAUDE.md, AGENTS.md and skill files that coding agents read across your projects.
At a Glance
Free and open source native macOS app released under the MIT License. Audits and merges run through your existing Claude Code or Codex login.
Engagement
Available On
Listed Nov 2026
About Rulebook
Rulebook is a free, open-source native macOS app from developer disinfeqt (Du Xiao). Point it at the folder that holds your projects and it finds every CLAUDE.md, AGENTS.md and CLAUDE.local.md, works out how they relate, and lets you edit, compare, merge and audit them in one place. The latest release listed on GitHub is v0.2.3.
What It Is
Rulebook is a desktop manager for the agent instruction files and skills that coding agents such as Claude Code and Codex read. It shows which agent reads which file and flags problems such as files that have drifted apart, files an agent never loads, and instructions written for older models. Most issues come with a one-click fix. The interface is available in English and Simplified Chinese.
How it classifies instruction files
When a project has both CLAUDE.md and AGENTS.md, Rulebook assigns a status:
- Linked: CLAUDE.md only imports AGENTS.md or is a symlink to it, so every agent reads the same file.
- Layered: CLAUDE.md imports AGENTS.md and adds Claude-only rules.
- Duplicated: two identical copies, shown as one file; saving writes both.
- Diverged: files with different content, so each agent misses rules the other gets.
- Skipped by Claude Code: an AGENTS.md hidden by a CLAUDE.local.md or a parent CLAUDE.md.
It also flags broken @imports, stray @mentions, tool-written blocks that are loaded twice or differ between projects, files over 200 lines, and leftover titles from copied files. It watches the projects and global folders, so external changes appear within about a second.
Compare, merge and consolidate rules
Compare shows CLAUDE.md and AGENTS.md side by side. Merge asks your agent to combine them into one AGENTS.md plus a CLAUDE.md that imports it, and you review the result before anything is saved. Repeated Rules lists rules written into more than one project, groups differently worded duplicates, and can move a rule into ~/.claude/CLAUDE.md and ~/.codex/AGENTS.md, removing the project copies as unsaved changes for review. Agents without a global file, such as Cursor, stop getting that rule from those projects.
Skills view
Switching the sidebar to Skills lists skills in each project and in the home folder, showing which agents load each one, where it was installed from, and what its name and description cost per session. Claude Code looks in .claude/skills while Codex and most other agents look in .agents/skills, so Rulebook finds skills only one agent sees, differing copies, broken links and SKILL.md files without a description, and offers fixes. Skills installed with npx skills are grouped by source.
Audits with your own agent
Audit checks a file against its project for outdated instructions, references to missing files or commands, and contradicting rules, returning a verdict, findings that jump to the relevant text, and suggested edits as a diff. Audits run through Claude Code (2.1.283+) or Codex using your existing login, in read-only mode. Settings let you choose the agent, model and command path. Failed runs are logged to ~/Library/Logs/Rulebook/agent.log.
Setup path
Download Rulebook.zip, drag the app to Applications and choose your projects folder. It requires macOS 14 or later, is signed and notarized by Apple, runs on Apple silicon and Intel Macs, and checks for updates via Sparkle. It can also be built from source with Xcode 26 or later. It is released under the MIT License.
Community Discussions
Be the first to start a conversation about Rulebook
Share your experience with Rulebook, ask questions, or help others learn from your insights.
Pricing
Open Source
Free and open source native macOS app released under the MIT License. Audits and merges run through your existing Claude Code or Codex login.
- Finds every CLAUDE.md, AGENTS.md and skill across projects
- Compare and merge drifted files
- Repeated Rules detection
- Skills management across agents
- Audits via Claude Code or Codex with existing login (read-only)
Capabilities
Key Features
- Finds CLAUDE.md, AGENTS.md and CLAUDE.local.md files across projects
- Classifies relationships: Linked, Layered, Duplicated, Diverged, Skipped
- Side-by-side Compare and agent-assisted Merge with review before saving
- Repeated Rules detection and Move to Global Files
- Skills view showing which agents load each skill and install source
- Flags broken @imports, broken skill links and oversized files
- Read-only audits via Claude Code or Codex with diff suggestions
- File watching and rescan
- English and Simplified Chinese interface
- Automatic update checks via Sparkle
