idrive-backup — скилл для Claude Code: управление iDrive
Помогает проверять и менять настройки iDrive Backup на macOS, включая пути резервного копирования и исключения. При изменениях инструмент автоматически сохраняет копии конфигурации.
Apache-2.0 ★ 173 обновлён 2026-10-24
npx skills add sammcj/agentic-coding --skill idrive-backup -a claude-codeЧто делает idrive-backup
Скилл использует скрипт scripts/idrive_tool.py: он проверяет, попадает ли путь в область резервного копирования или исключения, показывает настройки и статус аккаунта, разбирает результаты последней копии. Можно добавлять и удалять пути резервного копирования и исключения, а также находить лишние исключения.
Перед изменениями скрипт создаёт резервные копии конфигурации. Редактировать можно только исключения пользователя: остальные карты iDrive управляет сам и может перезаписать. Пути исключений должны быть абсолютными; из-за сопоставления по подстроке шаблон .cache может совпасть и с каталогом download_cache.
Для ручных правок важно сохранять типы значений и особенности ключей plist. Файлы базы данных и файлы демона в Operation/ менять нельзя: некоторые из них принадлежат root, а запись с повышенными правами здесь неуместна.
Какие задачи решает
- проверить, исключён ли путь из резервного копирования
- узнать, входит ли каталог в область резервного копирования
- добавить абсолютный путь в исключения пользователя
- посмотреть квоту, использование и статус последней копии
- найти и удалить избыточные исключения
Примеры запросов агенту
- Проверь, исключён ли
/Users/me/Downloadsиз резервного копирования iDrive. - Покажи статус аккаунта и результат последней резервной копии iDrive.
- Добавь
/Users/me/Projects/archiveв пути резервного копирования iDrive.
Как установить idrive-backup
1Через Skills CLI (Vercel)
npx skills add sammcj/agentic-coding --skill idrive-backup -a claude-code2Вручную: положить файлы
~/.claude/skills/idrive-backup/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/idrive-backup/
1Через Skills CLI (Vercel)
npx skills add sammcj/agentic-coding --skill idrive-backup -a codex2Вручную: положить файлы
.agents/skills/idrive-backup/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add sammcj/agentic-coding --skill idrive-backup -a cursor2Вручную: положить файлы
.cursor/skills/idrive-backup/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install sammcj/agentic-coding Skills_disabled/idrive-backup/SKILL.md2Вручную: положить файлы
.github/skills/idrive-backup/SKILL.md1Через Skills CLI (Vercel)
npx skills add sammcj/agentic-coding --skill idrive-backup -a gemini-cli2Командой платформы
gemini skills install https://github.com/sammcj/agentic-coding --path Skills_disabled/idrive-backupВручную: положить файлы
.devin/skills/idrive-backup/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Claude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы об idrive-backup
Как установить idrive-backup в Claude Code?
Выполните npx skills add sammcj/agentic-coding --skill idrive-backup -a claude-code. Файл скилла находится по пути ~/.claude/skills/idrive-backup/SKILL.md.
Что делает idrive-backup?
Скилл помогает диагностировать настройки iDrive Backup на macOS: проверять исключения и области копирования, смотреть статус аккаунта и управлять пользовательскими путями.
Какие исключения можно менять?
Только исключения пользователя. Остальные карты системные, и iDrive может перезаписать их; пути для пользовательских исключений должны быть абсолютными.
Исходный текст
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