iPhone(iPad)でGitHubのObsidian Vaultを同期する

Zenn 記事（著者：ぼやちゃん / k1nsenka）。Obsidian Git プラグインはモバイルで不安定という問題を受けて、iOS ネイティブ Git クライアント「Working Copy」を使った安全な Pull／Commit／Push 同期フローを徹底解説した実践ガイド。Vault作成からGitHub クローン・フォルダリンク・ショートカット自動化まで網羅している。

記事の核心メッセージ

Obsidian Git プラグインの libgit2 はモバイル環境でメモリ不足が頻発し、ファイル数 3〜5千・容量 200 MB 超で初回クローン時やプッシュ時にクラッシュする。解決策は モバイルでは Working Copy に完全に任せること。

Obsidian Git プラグインが使えない理由

• プラグイン作者自身が「モバイルの libgit2 は大量ファイルを扱えない」と根本対応困難を認めている（Issue #475）
• iOS 17/16 ともにクラッシュ報告があり、ファイル数・容量が閾値を超えると顕在化
• Push のクラッシュは “timeout → プラグイン再起動” パターン（libgit2 のメモリ不足）

必要なもの

役割	アプリ / サービス	備考
Git クライアント	Working Copy（v5.4+）	Push は Pro アドオンが必要
ノート	Obsidian（iOS）
Vault ホスティング	GitHub	PAT または SSH 認証
自動化	ショートカット（Apple）	Pull／Push の自動実行用

セットアップ手順

Step 1 — Vault をローカルに作成

1. Obsidian → Create new vault
2. 「iCloud に保存」を オフ にして On My iPhone/Obsidian/<VaultName> に作成

Tip

iCloud 同期をオフにすることで、Working Copy との競合を防ぐ。

Step 2 — GitHub リポジトリを Working Copy にクローン

1. Working Copy 起動 → + → Clone repository
2. URL 入力（https://github.com/<user>/<repo>.git）。認証は PAT が簡単
3. クローン完了後、リポジトリヘッダ右の ⌄ → Setup Sync for（旧: Link Repository to Directory）
4. ファイルアプリで On My iPhone › Obsidian › <VaultName> を指定 → Link
5. ローカル Vault と GitHub リモートが双方向ミラーされる

Note

iPad 版・iPhone 版ともに現在は「Setup Sync for」という選択肢名に統一されている（記事執筆当初から名称変更あり）。

Step 3 — 手動で Push テスト

1. Obsidian でノートを編集・保存
2. Working Copy で modified files を確認し全て stage
3. Commit → メッセージ入力 → Commit
4. Push → GitHub main に反映されることを確認

Step 4 — ショートカット自動化

4-1 ショートカット作成

• Pull Vault

  • Action: Working Copy → Pull Repository
  • Repo: <VaultRepo> / Remote: origin/main

• Commit & Push Vault

  • Actions: Commit Repository → Push Repository
  • Commit message: iOS auto-update – [[Current Date]]
  • What to Commit を modified に設定

4-2 オートメーション設定

1. ショートカット → Automation → Create Personal Automation
2. Trigger: App → Obsidian → Opens → Action: Run Shortcut: Pull Vault
3. Trigger: App → Obsidian → Closes → Action: Run Shortcut: Commit & Push Vault
4. 「Ask Before Running」を オフ

これで Obsidian を開くたびに自動 Pull・閉じるたびに自動 Commit & Push が走る。

トラブルシューティング

症状	原因	解決策
Link Repository to Folder が無い	Working Copy が古い	App Store で v5.4+ に更新
Push で “needs authentication”	PAT 期限切れ	GitHub で再発行し設定
Pull が “detached HEAD” になる	Obsidian Git との競合	モバイルではプラグインを無効化、.gitignore に .obsidian/plugins/obsidian-git/ を追記
Obsidian が初回 Clone で落ちる	モバイル libgit2 制限	Working Copy で Clone する本手順を使用

キーインサイト

Obsidian Git プラグインをモバイルで使わず Working Copy に全権委任することで、iPhone だけで安全な Obsidian Vault の GitHub 同期が実現する。ショートカット自動化（開いたら Pull・閉じたら Push）により、操作を意識せずデスクトップとの双方向同期が維持される。

関連ページ

• Obsidian Git同期（モバイル）
• Working Copy
• GitHub Actions
• Obsidian × Cursor 連携