claude-permissions-optimizer

Discover safe Bash commands from session history and apply them to settings.json.

50|14|Updated Mar 11, 2026
One-click install
npx skills add https://github.com/All-The-Vibes/ATV-StarterKit --skill claude-permissions-optimizer-all-the-vibes
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: claude-permissions-optimizer
Source: https://github.com/All-The-Vibes/ATV-StarterKit/tree/main/.github/skills/claude-permissions-optimizer
Command: npx skills add https://github.com/All-The-Vibes/ATV-StarterKit --skill claude-permissions-optimizer-all-the-vibes

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Optimize Claude Code permissions by discovering safe Bash commands from session history and auto-applying them to settings.json. This reduces unnecessary prompts while maintaining secure defaults.

Core Features & Use Cases

  • Identify safe commands from session transcripts and automatically update settings.json to reduce prompts.
  • Respect risk flags and avoid dangerous commands; provide explanations for risky patterns.
  • Scope across all Claude Code sessions and projects; works from any coding agent with CLAUDE_CONFIG_DIR present.

Quick Start

Run the optimizer to analyze your Claude Code sessions and auto-apply safe Bash command allowances to settings.json.

Frequently Asked Questions about claude-permissions-optimizer

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I reduce Claude Code permission prompts for safe Bash commands?

You can reduce Claude Code permission prompts by analyzing session transcripts to discover safe Bash commands and auto-applying them to settings.json. This minimizes unnecessary prompts while preserving secure defaults.

Can I automate Claude Code settings.json permissions across multiple projects?

Yes, you can automate Claude Code settings.json permissions across all sessions and projects. The optimizer works from any coding agent with CLAUDE_CONFIG_DIR present to scope permission allowances globally.

How does the Claude Code permissions optimizer classify risky Bash commands?

The Claude Code permissions optimizer uses a Bash command classifier and normalization logic to evaluate session history. It categorizes commands into green, yellow, and red risk levels, avoiding dangerous commands while providing explanations for risky patterns.

What's the best way to optimize Claude Code workflow security without manual allowlist editing?

The best way to optimize workflow security without manual edits is using an automated optimizer that loads a local allowlist, classifies recent Bash commands from session transcripts, and outputs a JSON schema with stats and risk flags.

Does the Claude Code permission optimizer work without external dependencies?

Yes, the Claude Code permission optimizer works without external dependencies. It requires only the component scripts and the CLAUDE_CONFIG_DIR environment to analyze session history and apply safe command allowances.

Why are some Bash commands flagged as risky when optimizing Claude Code permissions?

Some Bash commands are flagged as risky during permission optimization because the classifier respects risk flags and identifies dangerous patterns. The output JSON schema includes optional footnotes that provide explanations for these yellow and red risk classifications.