claude-perm-sim
Claude Code permission rule simulator: shows which rule decides a tool call and where a rule set is permissive.
What it is
claude-perm-sim loads your merged Claude Code permission settings, tells you which rule decides any given tool call, and finds the bypasses: commands that slip past a Bash pattern, paths that escape an Edit scope, and MCP tools nothing covers.
For developers and teams who hand-write Claude Code permission rules. Read-only, no runtime dependencies, Node 20 or newer. Part of a small set of Claude Code security tools listed at basitalisandhu.github.io, alongside agent-config-audit and cc-plugin-lock.
Install
npx github:basitalisandhu/claude-perm-sim load # effective rules, with the file each came from
npx github:basitalisandhu/claude-perm-sim explain "Bash(git push origin main)" # which rule decides one call
npx github:basitalisandhu/claude-perm-sim bypass # where an allow rule admits more than it names
From the README; see the full README for every option.
Links
Releases
More in Security tooling
- agent-off-switch: Find every AI agent identity in Microsoft 365, AWS and GitHub, see what it can reach, and switch it off. Offline on saved exports.
- skill-scan-gate: CI gate for Claude Code skills and plugins, with SARIF output. GitHub Action and CLI.
- agent-threat-model: Threat modeling for AI agents: describe the system in YAML, get a STRIDE and OWASP Agentic threat model.
- agent-config-audit: Audit AI agent configuration files for security risks.
- agentic-semgrep-rules: Semgrep rules for AI agent code in Python, TypeScript and JavaScript.
- security-actions: GitHub Actions for AI agent and supply chain security checks.
- cc-hooks: Typed Python SDK and offline test runner for Claude Code hooks.
- cc-plugin-lock: Lock file for Claude Code plugins: pins plugins and skills to content hashes and verifies them before load.
- llms-txt-gen: Generate llms.txt for any docs site or repository.
- scp-guardrails: Build AWS service control policies from a short spec and lint them for lockouts and statements that deny nothing.
- spotlighting: Spotlighting for prompt injection defence in Python: mark untrusted text before it reaches a model.
- llm-agent-control-plane: Deterministic policy enforcement for LLM agents.
Topics: agent-security, ai-agents, ai-security, claude, claude-code, cli, developer-tools, devsecops, hacktoberfest, least-privilege, llm-security, mcp, permission-rules, permissions, sarif, security-tools, simulator, static-analysis, typescript