idrive-backup — Claude Code skill for iDrive settings
Inspect and manage iDrive Backup settings on macOS, from exclusion rules to backup paths. The bundled tool saves configuration copies before making changes.
Apache-2.0 ★ 173 updated 2026-10-24
npx skills add sammcj/agentic-coding --skill idrive-backup -a claude-codeWhat idrive-backup does
The skill runs scripts/idrive_tool.py to check whether a path is covered by a backup reference or an exclusion, display settings and account status, and read recent backup results. It can also add or remove backup paths and user exclusions, then identify redundant exclusions.
The tool backs up configuration before edits. Only user-defined exclusions are editable; iDrive manages the other maps and may overwrite them. Exclusion paths must be absolute. Matching in the Partial File map uses substrings, so .cache can match a directory such as download_cache too.
Manual edits require care with plist value types and unusual key names. Do not write to database files or anything under Operation/: some are owned by root, so elevated writes are off the table.
What it helps with
- check whether a path is excluded from backup
- see if a directory falls under a backup reference
- add an absolute path to user exclusions
- inspect account quota and the latest backup result
- find and remove redundant exclusions
Example prompts for the agent
- Check whether
/Users/me/Downloadsis excluded from iDrive backups. - Show the iDrive account status and the latest backup result.
- Add
/Users/me/Projects/archiveto the iDrive backup paths.
How to install idrive-backup
1Skills CLI (Vercel)
npx skills add sammcj/agentic-coding --skill idrive-backup -a claude-code2Manually: put the files in place
~/.claude/skills/idrive-backup/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/idrive-backup/
1Skills CLI (Vercel)
npx skills add sammcj/agentic-coding --skill idrive-backup -a codex2Manually: put the files in place
.agents/skills/idrive-backup/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add sammcj/agentic-coding --skill idrive-backup -a cursor2Manually: put the files in place
.cursor/skills/idrive-backup/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install sammcj/agentic-coding Skills_disabled/idrive-backup/SKILL.md2Manually: put the files in place
.github/skills/idrive-backup/SKILL.md1Skills CLI (Vercel)
npx skills add sammcj/agentic-coding --skill idrive-backup -a gemini-cli2Platform CLI
gemini skills install https://github.com/sammcj/agentic-coding --path Skills_disabled/idrive-backupManually: put the files in place
.devin/skills/idrive-backup/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about idrive-backup
How do I install idrive-backup in Claude Code?
Run npx skills add sammcj/agentic-coding --skill idrive-backup -a claude-code. The skill file is at ~/.claude/skills/idrive-backup/SKILL.md.
What does idrive-backup do?
It helps inspect iDrive Backup on macOS, including exclusion rules, backup paths, account status, and recent backup results. It can also edit user exclusions and backup references.
Which iDrive exclusions can I edit?
Only user-defined exclusions. iDrive controls the other maps and can overwrite them; user exclusion paths must be absolute.
Source text
SKILL.md · Apache-2.0
--- name: idrive-backup description: Use this skill whenever the user wants you to manage, discuss or diagnose iDrive Backup configuration on macOS allowed-tools: Read Edit Write Bash Glob Grep disable-model-invocation: true --- # iDrive Backup for macOS iDrive stores all configuration at `~/Library/Application Support/IDriveforMac/`. The username is the iDrive account email (e.g. `[email protected]`), detected from the top-level key in `appDefaultSettings.plist`. ## The Tool This skill bundles `scripts/idrive_tool.py` which handles all iDrive operations with correct matching semantics, symlink resolution, and safety backups. Run it with: ```bash python3 <skill-path>/scripts/idrive_tool.py <command> [args...] ``` ### Commands | Command | Description | | ------------------------------------- | --------------------------------------------------------------------------------------------------- | | `check-exclusion <path>` | Check if a path is excluded and by which rules. Reports backup scope too | | `check-scope <path>` | Check if a path falls under any backup reference path | | `list-exclusions [--category <name>]` | List exclusion entries. Categories: Default, Partial File, User Profile, User Specified, Propagated | | `add-exclusion <path>` | Add absolute path to User Specified exclusions (auto-backups config first) | | `remove-exclusion <path>` | Remove path from User Specified exclusions | | `show-settings` | Display all scalar settings with current values | | `set-setting <key> <value>` | Modify a setting (auto-detects type from existing value) | | `account-status` | Show quota, usage, encryption type, plan, app version | | `last-backup` | Parse recent LOGXML files and show backup status/results | | `find-redundant` | Find exclusion paths made redundant by a parent path in any map | | `clean-redundant` | Remove redundant entries from User Specified exclusions | | `list-backup-paths` | List all online backup reference paths | | `add-backup-path <path>` | Add a directory to backup reference | | `remove-backup-path <path>` | Remove a directory from backup reference | | `backup-config` | Create timestamped backup copies of config files | ## Safety Rules 1. **Back up before modifying.** The tool does this automatically. Manual changes must copy both `appDefaultSettings.plist` and `<username>/backupReferenceFile.plist` to `~/.idrive-backup/backups/` with timestamps first. 2. **Only modify User Specified exclusions.** The other four maps (Default, Partial File, User Profile, Propagated) are system-managed and will be overwritten by iDrive. 3. **Preserve plist key quirks exactly.** Two keys have trailing spaces: `ShowHiddenFilesKey ` and `PowerAfterScheduledJob `. One has a typo: `NotifyFaiulreValue`. The editable exclusion map key is `User specified Exclusion` (lowercase 's'). Getting any of these wrong creates orphaned keys. 4. **Never modify** `IDLoginDetails.plist`, `Sync.plist`, `LDB_NEW/*.ib` databases, or anything under `Operation/` (root-owned daemon files). 5. **Exclusion values are always int(1).** Presence in the map means excluded. Never write a 0 value; delete the key instead. 6. **All User Specified paths must be absolute.** No tildes, no trailing slashes, no relative paths. ## Five Exclusion Maps | Map | Plist Key | Count | Matching | Editable | | -------------- | -------------------------------- | --------- | -------------------------------------------- | ---------------- | | Default | `Default Exclusion` | ~24 | Exact/parent path | No | | Partial File | `Partial File Exclusion` | ~41 | **Substring** of full path OR exact filename | No | | User Profile | `User Profile Default Exclusion` | ~7 | Exact/parent path | No | | User Specified | `User specified Exclusion` | 100-2000+ | Exact/parent path | **Yes** | | Propagated | `Propagated Files Exclusion` | Usually 0 | Exact/parent path | No (web console) | **Partial File Exclusion is substring-based.** This is the trickiest map. A pattern like `.cache` matches both `/Users/foo/.cache` and `/path/to/download_cache`. Patterns are relative names (never absolute paths), including dotfile dirs (`.git`, `.venv`), filename patterns (`fp16.bin`, `safetensors`), and one with a separator (`pkg/mod`). ## Key Gotchas 1. **Mixed boolean types.** Some settings use `<true/>`/`<false/>`, others use `<integer>0</integer>`/`<integer>1</integer>` for the same concept. The tool handles this; if modifying manually, match the existing type. 2. **Symlinks/firmlinks.** `~/Desktop` may resolve to `~/Library/Mobile Documents/com~apple~CloudDocs/Desktop` when iCloud Desktop is enabled. Always resolve with `os.path.realpath()` before comparing paths. 3. **CDP log filenames have a leading space.** iDrive bug: Continuous Data Protection logs in `SessionLogsNew/Backup/` are named ` MM-DD-YYYY-00-00-00` (note leading space). Account for this when globbing or reading. 4. **Some files are root-owned.** `Operation/Backup/IBThrottle`, `LDB_NEW/*.ib`, and some plists are written by the iDrive daemon as root. Reading is fine; writing requires elevated privileges you shouldn't use. 5. **The appDefaultSettings.plist can be large.** User Specified Exclusion alone can have 1,800+ entries (mostly auto-populated `~/Library/Containers/com.apple.*` paths). The plist file can exceed 170 KB. ## Detailed Reference For detailed file format information, all 22+ scalar settings with types and descriptions, secondary file formats (logs, size files, sync config), or the complete directory layout, read `references/idrive-config.md`.
© sammcj · Apache-2.0 · sammcj/agentic-coding