Skip to main content
skill CX Codex

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

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add sammcj/agentic-coding --skill idrive-backup -a claude-code
Open on GitHub

What 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/Downloads is excluded from iDrive backups.
  • Show the iDrive account status and the latest backup result.
  • Add /Users/me/Projects/archive to the iDrive backup paths.

How to install idrive-backup

1Skills CLI (Vercel)

npx skills add sammcj/agentic-coding --skill idrive-backup -a claude-code

2Manually: put the files in place

~/.claude/skills/idrive-backup/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/idrive-backup/

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

Similar skills

All skills for DevOps and infrastructure →

From the same set73

The whole set →
html-design-examples The html-design-examples skill uses a gallery of single-file HTML references to shape plans, reports, prototypes, and other materials meant to be read in a browser. CX Codex +1 ★ 173repo stars step-back step-back — a subagent that checks if your current approach is over-engineered. Analyzes code or design and returns one verdict: continue, simplify, or restart. CX Codex ★ 173repo stars reframe-voice reframe-voice guides long-form thought-leadership writing with an evidence-based perspective. Activates when you explicitly need a deep essay without marketing hype. CX Codex +1 ★ 173repo stars excalidraw-diagrams Builds and edits Excalidraw diagrams using MCP previews or standalone Python generation scripts. CX Codex +1 ★ 173repo stars ghostty-config ghostty-config is a Claude Code skill that configures and troubleshoots Ghostty terminal files, including keybind syntax, CLI actions, and Linux/macOS differences. CX Codex +1 ★ 173repo stars release-debrief release-debrief compares a supported tool’s newest release with the last saved debrief. Use it to catch changes in Claude Code, OpenCode, llama-swap, or llama.cpp. CX Codex +1 ★ 173repo stars pptx-to-md pptx-to-md turns PPTX into per-slide Markdown files, preserving text, image positions, and descriptions of diagrams and screenshots. Useful when you need structured deck content with interpreted visuals. CX Codex +1 ★ 173repo stars web-artifacts-builder-v2 web-artifacts-builder-v2 builds multi-component HTML artifacts with React, including interfaces that need state or routing. Use it to turn a frontend project into a standalone HTML file. CX Codex +1 ★ 173repo stars

Project sponsors

Companies that keep this analytics open