# Sync Permissions > Merge local AI permission settings into repository-wide permissions Use when this capability is needed. - Skill: `tomevault-io/sync-permissions` (Agent Skill, multi-file: 2 files) - Install (CLI): `npx skillmds@latest add tomevault-io/sync-permissions` - Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/sync-permissions/raw - Safety review: pending - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: Coding & Dev Tools - Author: tomevault-io (https://skillmd.com/u/tomevault-io) - Updated: 2026-09-17 - Page: https://skillmd.com/skills/tomevault-io/sync-permissions --- # Sync Permissions Scan local AI settings across all repos/worktrees, analyze permissions, and merge approved changes into repository permissions. ## Supported Tools | AI Tool | Config Location | Sync Status | | --- | --- | --- | | Claude | `agentsmd/permissions/` | Fully supported | | Gemini | `.gemini/permissions/` | Fully supported | | Copilot | `.github/copilot-instructions.md` | Not yet supported | ## Workflow ### Phase 1: Discovery and Analysis Scan home directory for AI permission settings, classify permissions, and deduplicate against existing patterns. **Currently scans:** - Claude settings from `~/.claude/settings.local.json` in all repos/worktrees - Gemini settings from `~/.gemini/settings.json` in all repos/worktrees ### Phase 2: User Approval Review analysis report. Ask user to approve, modify, or cancel. ### Phase 3: Execution **Only after approval**, apply changes, sync across tools, and cleanup local files. **Sync strategy:** - Merge permissions using a union approach - When same permission exists in both tools with different classifications, prioritize Claude classification - When permission exists only in Gemini, preserve and propagate to Claude - Result: identical permission sets across all supported tools ## Architecture Command -> Agent -> Skill pattern: - Agents: `permissions-analyzer`, `permissions-syncer` - Skill: `permission-patterns` (safety classification, deduplication, token-efficient extraction) ## Related Skills - quick-add-permission (config-management) --- > Converted and distributed by [TomeVault](https://tomevault.io/claim/jacobpevans) — claim your Tome and manage your conversions.