К основному содержанию
скилл CX Codex

idrive-backup — скилл для Claude Code: управление iDrive

Помогает проверять и менять настройки iDrive Backup на macOS, включая пути резервного копирования и исключения. При изменениях инструмент автоматически сохраняет копии конфигурации.

Apache-2.0 ★ 173 обновлён 2026-10-24

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add sammcj/agentic-coding --skill idrive-backup -a claude-code
Открыть на GitHub

Что делает 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-code

2Вручную: положить файлы

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

Папка скилла целиком; для одного проекта — .claude/skills/idrive-backup/

По шагам, с командами для каждой платформы: Как установить скилл в 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

Похожие скиллы

Все скиллы по теме «DevOps и инфраструктура» →
convex-backup convex Скилл convex-backup настраивает регулярные снапшоты базы Convex и прогоняет учебное восстановление в одноразовый preview, чтобы проверить, что данные действительно возвращаются. CX Codex +1 43 800установок gke-backup-dr официальный google Скилл gke-backup-dr для Claude Code, Gemini CLI и Codex, который настраивает Backup for GKE: включает аддон BackupRestore, создаёт BackupPlan и RestorePlan, запускает восстановление. CX Codex +1 6 464установок cli-backup-sync cheaper-inference Скилл cli-backup-sync для работы с бэкапами Anthropic из терминала: инкрементальные снимки, синхронизация с облаком, расписания и восстановление из архивов. CX Codex +1 1 300установок backup-disaster-recovery aj-geddes Скилл backup-disaster-recovery помогает агенту спланировать резервное копирование, восстановление после сбоев и отработку отказа между регионами. CX Codex +1 629установок database-backup-restore aj-geddes Скилл database-backup-restore для Claude Code и других ассистентов кодинга, покрывает резервное копирование и восстановление баз данных. Закрывает стратегию бэкапов и проверку восстановления. CX Codex +1 593установок backup-recovery devops-skills Скилл backup-recovery настраивает резервное копирование и восстановление через rsync и Restic. Пригодится при настройке бэкапов на диск, в AWS S3 или Backblaze B2 по правилу 3-2-1. CX Codex +1 460установок

Из того же набора73

Весь набор →
html-design-examples Скилл html-design-examples для Claude Code создаёт одностраничные HTML-материалы по образцам из галереи. Он создаёт планы, отчёты, прототипы и другие материалы для чтения в браузере. CX Codex +1 ★ 173звёзд репо step-back Субагент step-back для проверки, не перегружён ли текущий подход избыточными абстракциями. Анализирует код или дизайн и выносит вердикт: продолжать, упрощать или переделать с нуля. CX Codex ★ 173звёзд репо reframe-voice Скилл reframe-voice для Claude Code задаёт стиль доказательных колонок с переосмыслением привычных идей. Помогает разбирать сложные темы в лонгридах без рекламного пафоса. CX Codex +1 ★ 173звёзд репо excalidraw-diagrams Скилл excalidraw-diagrams создаёт и обновляет схемы Excalidraw через интерактивный просмотр MCP или локальный Python-скрипт. CX Codex +1 ★ 173звёзд репо ghostty-config Скилл ghostty-config помогает настраивать терминал Ghostty: подсказывает синтаксис config.ghostty, валидирует параметры и учитывает отличия macOS и Linux. CX Codex +1 ★ 173звёзд репо release-debrief Скилл release-debrief для Claude Code сравнивает свежий релиз поддерживаемого инструмента с последней сохранённой сводкой. Разбирает изменения в Claude Code, OpenCode, llama-swap и llama.cpp. CX Codex +1 ★ 173звёзд репо pptx-to-md Скилл pptx-to-md для Claude Code превращает PPTX в Markdown: один файл на слайд, с текстом, позициями изображений и описанием диаграмм и скриншотов. CX Codex +1 ★ 173звёзд репо web-artifacts-builder-v2 Скилл web-artifacts-builder-v2 собирает сложные HTML-артефакты на React с несколькими компонентами, состоянием или маршрутизацией. Он пригодится, когда нужен готовый автономный HTML-файл. CX Codex +1 ★ 173звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой