vlovers

Rulewitness — Development skill for Claude Code

Development community

Semantic permission diffs and policy tests for Claude Code.

How to install Rulewitness

This entry records only its repository, not the path inside it, so there is no exact command to give. Open vlovers/rulewitness and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Rulewitness does

Semantic permission diffs and policy tests for Claude Code. Explain permission changes with concrete witnesses.

Alternatives in Development

11 Permission Explainer — Permission Explainer System Prompt 2.3k ★
Phi — a coding Agent from pi 175 ★
Generate Permissions — Generate VAMS Permission Template 137 ★

README

RuleWitness

**Semantic Permission Diff for AI Coding Agents**

[![RuleWitness CI](https://github.com/vlovers/rulewitness/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/vlovers/rulewitness/actions/workflows/ci.yml?query=branch%3Amain) [![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE) [![npm version](https://img.shields.io/npm/v/rulewitness.svg)](https://www.npmjs.com/package/rulewitness)

**Did a pull request change what Claude Code can do?** RuleWitness compares supported permission rules between Git revisions, shows a concrete command when a modeled decision changes, and explains which rules caused it. It also detects modeled no-ops and supports policy assertions — offline, without executing the commands.

![RuleWitness CLI demonstration](assets/rulewitness-demo.gif)

RuleWitness is an experimental, offline TypeScript CLI and library for reviewing **Claude Code configuration-rule decisions** between Git commits. It produces concrete, replay-checked witnesses, explains the determining rules, filters modeled no-ops, and runs reusable policy assertions.

**This is not a runtime authorization engine.** `ALLOW` means the supported configured rules allow that input in this model. It does not guarantee Claude Code will execute it. Every report retains `complete: false`. Unsupported settings and uncertain changes remain visible. Only Claude Code's documented subset below is supported; other agents are not advertised.

This project evolved from AgentPermissionDiff in v0.2. Version v0.3 adds a reviewer-focused Markdown presentation, without expanding the permission model. The repository is [vlovers/rulewitness](https://github.com/vlovers/rulewitness), and `rulewitness@0.3.0` is [published on npm](https://www.npmjs.com/package/rulewitness/v/0.3.0). See [migration notes](docs/migration-v0.2.md), the [v0.2.0 release](https://github.com/vlovers/rulewitness/releases/tag/v0.2.0), and the [historical release preparation notes](doc