Simplify permissions

As agents work, you approve tool calls — npm test, git push, MCP tools — and each approval lands in that agent’s local .claude/settings.local.json. Over time, every worktree accumulates its own copy of the same permissions, and you keep approving the same things.

Simplify Permissions scans all agent worktrees, finds permissions that have been approved repeatedly, and promotes them to your project’s shared .claude/settings.json. Once promoted, every agent inherits them automatically. The local copies are pruned.

This command requires Claude Code and must be run from the primary worktree, not an agent worktree.

Run the command

Click New Task in the top right, then Configure → Permissions. The agent scans all worktrees and presents a report with:

• Candidates — new permissions found in agent worktrees, sorted by how many worktrees approved them. Patterns seen in multiple worktrees are more likely to be legitimate.
• Malformed entries — permissions with formatting issues, shown with a suggested fix.
• Rejected entries — permissions rejected for safety reasons, with an explanation.

If no candidates are found, the agent reports that all worktrees are in sync and stops.

Choose what to promote

The agent asks you to pick from four options:

1. Add all — promote every candidate to the shared settings.
2. Add frequent — only promote candidates seen in two or more worktrees.
3. Cherry-pick — select specific entries by number.
4. Skip — don’t add anything, just prune duplicates.

What changes

The agent adds your approved patterns to .claude/settings.json under permissions.allow, deduplicates and sorts the list, then prunes entries from each worktree’s settings.local.json that are now covered by the shared baseline.

After writing the changes, the agent offers to commit and push .claude/settings.json and any modified local files.