Skip to main content
command CX Codex

permission-tuner — Claude Code command: analyze access rules

permission-tuner analyzes why Claude Code keeps prompting for permissions or denying operations, then generates rules to reduce confirmation fatigue.

MIT ★ 2,966 updated 2026-09-29

Install into Claude Code · Plugin marketplace All methods and platforms ↓
/plugin marketplace add rohitg00/pro-workflow
/plugin install pro-workflow@pro-workflow
Open on GitHub

What permission-tuner does

permission-tuner reads your ~/.claude/settings.json config and session transcripts, counts denials by category, and identifies three classes of friction: ask rules that trigger even in auto mode, hook blocks on harmless commands, and classifiers that wrongly reject routine tasks.

The command preserves dangerous rules—they stay in deny or ask to protect your project. After analysis, it presents recommended changes you can apply by hand.

Run /permission-tuner with no arguments to start. Results show which autoMode.environment or autoMode.allow entries will stop unnecessary prompts, and which hooks produce false positives.

What it helps with

  • remove ask rules that force Claude Code out of auto mode
  • fix hook false positives blocking safe operations
  • add autoMode entries for a classifier that wrongly rejects routine work
  • cut down permission confirmation requests

Example prompts for the agent

  • /permission-tuner
  • Run permission-tuner to find out why Claude Code keeps asking for permissions
  • Apply permission-tuner recommendations to your autoMode config

How to install permission-tuner

1Plugin marketplace

/plugin marketplace add rohitg00/pro-workflow
/plugin install pro-workflow@pro-workflow

2Manually: put the files in place

.claude/commands/permission-tuner.md

Call it with /permission-tuner. For all projects use ~/.claude/commands/

Questions about permission-tuner

How do I install permission-tuner in Claude Code?

Run /plugin marketplace add rohitg00/pro-workflow, then /plugin install pro-workflow@pro-workflow. The command loads from .claude/commands/permission-tuner.md.

What does permission-tuner do?

It reads your permission rules and recent denials, finds what triggers the prompts, and suggests rule changes to reduce them.

What's an ask rule and why does it block auto mode?

An ask rule requests confirmation even when auto mode is on. permission-tuner suggests dropping the ones you always approve, because they freeze automation.

Source text

permission-tuner.md · MIT
---
description: Analyze permission prompts and auto mode denials, then generate permission rules and autoMode entries that reduce prompt fatigue
---

# /permission-tuner - Permission Optimization

Find out why Claude Code keeps prompting or denying, and fix the cause.

## Quick Start

Run this command to:
1. Read your permission rules and `autoMode` config
2. Count denials by kind from recent session transcripts
3. Separate hook false positives, classifier blocks, and ask-rule prompts
4. Present recommended changes for your approval

## What It Does

- **Ask rules you always approve**: suggests removing them, since ask rules prompt even in auto mode
- **Classifier blocks on routine work**: suggests `autoMode.environment` or `autoMode.allow` entries
- **Hook false positives**: names the hook script that blocked harmless commands, since each block counts toward auto mode's fallback to prompts
- **Dangerous operations**: keeps them in deny or ask

## Usage

```text
/permission-tuner
```

After running, review the suggested changes and apply the ones you want. `autoMode` entries belong in `~/.claude/settings.json`.

© Rohit Ghumare · MIT · rohitg00/pro-workflow

Similar slash commands

All slash commands for Agent setup: memory, context, orchestration →
permission-auditor UseAI-pro permission-auditor — a skill for Claude Code, Codex, Cursor and other platforms: checks what permissions another skill requests, explains risks and suggests minimal access. Runs before installing a new skill. CX Codex +1 477installs dx-org-permission-set-assign forcedotcom dx-org-permission-set-assign assigns Salesforce permission sets to org users via sf org assign permset. Handles default admins, target org aliases, and batch assignments. CX Codex +1 5,900installs applying-a-permission-policy mvschwarz applying-a-permission-policy is a Claude Code skill that sets OpenRig permissions before a team launch. It activates during command-permission setup or when native approval prompts interrupt work. CX Codex +1 ★ 8,928repo stars permission-check pedrohcgs permission-check diagnoses why Claude Code asks for approval or ignores bypass mode. It checks project and global configuration layers without editing files. CX Codex +1 ★ 1,729repo stars service-omni-supervisor-permset-assign forcedotcom service-omni-supervisor-permset-assign — a skill for Claude Code that automates assigning the ContactCenterSupervisor permission set to users. Runs a verification and assignment script for Salesforce supervisor provisioning. CX Codex +1 102installs performance-tuner alirezarezvani performance-tuner — a subagent for finding performance bottlenecks, profiling applications, and optimizing code. Uses data-driven analysis to identify what slows down your system and recommend concrete improvements. CX Codex ★ 788repo stars

From the same set83

The whole set →
auto-setup auto-setup detects a project’s stack and configures quality gates, permission rules, and hooks. Useful when bringing a new codebase into Claude Code. CX Codex +1 ★ 2,966repo stars compact-guard compact-guard is a Claude Code command that saves working state before context compaction and restores critical data afterward. Run it before manual compaction or when auto-compaction warnings appear. CX Codex +1 ★ 2,966repo stars wrap-up wrap-up audits git diffs, runs test suites, records lessons learned, and prepares context before closing a Claude Code session. CX Codex +1 ★ 2,966repo stars planner planner — a read-only subagent turns complex coding work into an implementation plan. Use it when several files, architecture choices, or unclear requirements are involved. CX Codex ★ 2,966repo stars list list displays stored patterns and rules from the pro-workflow database by recency, category, or project. CX Codex +1 ★ 2,966repo stars context-discipline The context-discipline rule sets limits for file reads, tool calls, and test-driven edits. It helps keep Claude Code from reopening unchanged files or polishing code after tests pass. CX Codex +1 ★ 2,966repo stars communication-style communication-style sets how Claude replies: short, no openers or praise, code before prose. Useful when agent answers drown in politeness. CX Codex +1 ★ 2,966repo stars search Runs full-text keyword searches across the pro-workflow learnings database. Helps recall previous mistakes and project rules while coding. CX Codex +1 ★ 2,966repo stars

Project sponsors

Companies that keep this analytics open