/backup

sidebar_position: 2

backup

ターゲットディレクトリのバックアップを作成、一覧表示、管理します。

skillshare backup              # すべての Skill ターゲットをバックアップ
skillshare backup claude       # 特定のターゲットをバックアップ
skillshare backup agents       # すべての agent ターゲットをバックアップ
skillshare backup --all        # Skill と agent をバックアップ
skillshare backup --list       # すべてのバックアップを一覧表示
skillshare backup --cleanup    # 古いスナップショットと放置された未完成ディレクトリを削除
skillshare backup --delete 2026-01-19_10-00-00  # 1 つのバックアップを削除
skillshare backup files        # skillshare が書き換えた単一ファイルのバージョン

こんなときに使う

• 危険な変更を行う前に手動でバックアップを作成する
• 既存のバックアップを一覧表示して復元の選択肢を確認する
• 古いスナップショットと放置された未完成ディレクトリをクリーンアップする、または不要になったバックアップを 1 つ削除する
• `AGENTS.md` や `CLAUDE.md` などのファイルの以前のバージョンを取り戻す

自動バックアップ

バックアップは、以下の前に **自動的に** 作成されます。

• `skillshare sync`（Skill ターゲットと agent ターゲット）
• `skillshare sync agents`（agent ターゲットのみ）
• `skillshare target remove`

保存場所: `~/.local/share/skillshare/backups/<timestamp>/`（グローバル）、`.skillshare/backups/`（プロジェクトモード、agent のみ）

保持ポリシーは、自動バックアップのたびに `--cleanup` と同じポリシーで自動的に適用されます。スナップショットを手動で整理する必要はありません。

コマンド

バックアップの作成

skillshare backup              # すべてのターゲット
skillshare backup claude       # 特定のターゲット
skillshare backup --dry-run    # プレビュー

バックアップの一覧表示

skillshare backup --list

Backups  ~/.local/share/skillshare/backups
  2026-01-20_15-30-00  claude, cursor · 4.2 MB
  2026-01-19_10-00-00  claude · 2.1 MB
  2026-01-18_09-00-00  claude, cursor · 4.0 MB

3 backups, 10.3 MB

Next
  skillshare restore <target> --from <timestamp>  roll a target back

古いバックアップのクリーンアップ

skillshare backup --cleanup           # 古いスナップショットと放置された未完成ディレクトリを削除
skillshare backup --cleanup --dry-run # クリーンアップをプレビュー

完了したスナップショットのデフォルト保持ポリシー:

• 直近 10 個のバックアップを保持
• 30 日以上前のバックアップを削除
• 合計サイズの上限を 500 MB に設定

件数とサイズの上限は、グローバル設定、またはダッシュボードの **ターゲットフォルダー** タブにある保持の概要から変更できます。`0` は無制限です。30 日の上限は固定で、プロジェクトのスナップショットはデフォルトのままです。

backup:
  max_count: 20      # デフォルト 10
  max_size_mb: 1000  # デフォルト 500

最新のスナップショットは、それ単体でサイズ上限を超えていても常に保持されます — 復元ポイントがまったくない状態にはなりません。

このポリシーはすべての `sync` の後に自動的に実行されるため、`--cleanup` はオンデマンドで整理したいときにのみ必要です。

クリーンアップは、中断されたバックアップが残した未完成の `.snapshot-*` ディレクトリも削除します。完了したスナップショットがない場合も対象です。これらのディレクトリは `--list` に表示されず、その合計サイズにも含まれません。`--cleanup --dry-run` では削除せずにプレビューに含めます。バックアップの書き込み中は、そのバックアップディレクトリのクリーンアップをスキップします。完了後にクリーンアップを再実行してください。

バックアップの削除

skillshare backup --delete 2026-01-19_10-00-00            # 1 つのスナップショットを削除
skillshare backup --delete 2026-01-19_10-00-00 --dry-run  # 削除される内容を表示
skillshare backup --delete 2026-01-19_10-00-00 -p         # プロジェクトの .skillshare/backups/ から削除

タイムスタンプは `--list` が表示するフォルダ名です。スナップショット全体が、含まれるすべてのターゲットとともに削除されます。

ファイル履歴 {#file-history}

skillshare は、単一ファイル（`AGENTS.md` や `CLAUDE.md` などの指示ファイル、または[共有ファイル](/docs/how-to/daily-tasks/sharing-instructions#backups)の配置先）を書き換えたり置き換えたりする前に、古い内容を保存します。`backup files` はそれらのバージョンを一覧表示し、復元します。

skillshare backup files                                   # 保存済みバージョンがあるファイル
skillshare backup files show ~/.claude/CLAUDE.md          # 1 つのファイルのバージョン（新しい順）
skillshare backup files restore ~/.claude/CLAUDE.md origin
skillshare backup files restore ./CLAUDE.md 1769000000000000000.shim --dry-run

Versions  ~/.claude/CLAUDE.md
  1769000000000000000.edit        2026-01-21 12:53:20  history/edit          2.1 KB  # Team rules
  drift:1768900000000000000.mode  2026-01-20 09:06:40  drift/mode            1.9 KB  # Team rules
  origin                          2026-01-10 08:00:00  origin                1.2 KB  # My notes

各バージョンには ID があります。

| ID | 種類 | 意味 | |----|------|---------| | `<time>[.<reason>]` | `history` | skillshare がファイルに書き込む前に保存したもの | | `drift:<time>[.<reason>]` | `drift` | skillshare が置き換えた、あなた自身の編集 | | `origin` | `origin` | 共有ファイルを最初につないだ時点のファイル。その配置先を削除すると自動的に復元されます。ファイルがなかった場合、復元すると現在のファイルが削除されます |

理由（reason）は、skillshare が何をしようとしていたかを示します。

| 種類 | 理由 | 保存されるタイミング | |------|--------|--------------| | `history` | `convert` | ファイルを `AGENTS.md` に変換する、または `AGENTS.md` に名前変更する前 | | `history` | `shim` | プロジェクトのファイルに `@AGENTS.md` を追加する前 | | `history` | `edit` | ダッシュボードでの編集の前 | | `history` | `collect` | ターゲットの変更を共有ファイルに取り込む前 | | `history` | `attach` | 最初につないだときに共有ファイルで置き換える前 | | `history` | `restore` | 古いバージョンを復元する前 | | `history` | `migrate` | 0.23.0 で廃止された MCP 設定を除いて sync が config を保存する前。[0.22 からの Pi のアップグレード](/docs/reference/commands/mcp#pi-migration)を参照 | | `drift` | `overwrite` | ファイルを直接編集し、**上書き** を選んだとき | | `drift` | `mode` | 配置先のモードを切り替える前 | | `drift` | `restore` | 配置先を復元する前 |

以前のリリースで保存されたバージョンには理由がありません。各ファイルについて、種類ごとに最新 10 件が保持されます。

`restore` は、まず現在の内容を理由 `restore` の新しいバージョンとして保存してから、選んだバージョンを書き込みます。パスがシンボリックリンクの場合は、`--unlink` を付けない限り拒否されます。`--unlink` はリンクを通常のファイルに置き換えます。

`backup files` はモードに従います。プロジェクト内（または `-p` 指定時）では、そのプロジェクト内のファイルのみを一覧表示し、`show` / `restore` はプロジェクト外のパスを拒否します。`-g` はすべてのファイルが対象です。`files` はサブコマンドなので、文字どおり `files` という名前のターゲットをバックアップするには `skillshare backup -t files` を使います。

ダッシュボード {#dashboard}

[`skillshare ui`](/docs/reference/commands/ui) の **設定 › バックアップ** には 3 つのタブがあります。

• **ターゲットフォルダー** — 上記のスナップショットを日付ごとに表示します。ターゲットまたは **agents のみ** でフィルタできます。スナップショットを開くと各フォルダーのファイル数とサイズが表示され、どれか 1 つを **復元**（Skill と agent のエントリのどちらも）したり、**パスをコピー** や **このバックアップを削除** ができます。**今すぐバックアップ** と **古いバックアップを整理** は、`backup` と `--cleanup` に相当します。その横の保持の概要から件数とサイズの上限を変更でき、**すべて削除** は確認後にすべてのスナップショットを削除します。ファイル、MCP、Hooks のバックアップには影響しません。
• **ファイル** — 上記のファイル履歴。ファイルを選ぶと理由付きでバージョンが表示され、**プレビューして復元** で現在のファイルとの差分、またはバージョン全体を確認できます。リンクされた配置先は、**復元してリンクを切る** を確認した後にのみ通常のファイルに置き換えられます。
• **MCP** — MCP 設定の書き込み前に毎回取られるバックアップ。Agent の設定ごとにグループ化され、それぞれで追加・変更・削除されたサーバーが表示されます。**プレビューして復元** は **MCP** ページと同じ復元ダイアログを開きます（コマンドラインでは [`mcp restore`](/docs/reference/commands/mcp)）。


プロジェクトモードでは、このページはプロジェクトのみを対象とします。`.skillshare/backups/` にある agent のスナップショット、プロジェクト内のファイル、プロジェクトの MCP 設定のバックアップです。削除した Skill と