Obsidian Gitプラグイン直接同期（iOS）
iPhoneのObsidianにコミュニティプラグイン「Git」を直接インストールし、GitHub Fine-grained Personal Access Token（PAT）で認証してVaultを同期する手法。Working Copyなどの外部Gitアプリを使わずに完結する。
Contradiction
この手法は Obsidian Git同期（モバイル） が記録する「Obsidian GitプラグインはiOSのlibgit2メモリ制限でクラッシュする、Working Copyへの完全委任がベストプラクティス」という見解と矛盾する。
- K.I（ishikawa096）（2024-11-10）: 「Working Copyは不要。Obsidian GitプラグインをiPhone直接インストールで動作する」
- ぼやちゃん（k1nsenka）（2025-05-01）: 「Obsidian Gitのモバイル動作は根本的に不安定。Working Copy完全委任が現状ベストプラクティス」
解釈上の注意: Vault規模（ファイル数・容量）によって動作が異なる可能性がある。小規模Vaultではプラグイン直接同期が動作し、大規模Vault（3〜5千ファイル・200 MB超）ではクラッシュが顕在化するという可能性も排除できない。また、Obsidian Gitプラグインのバージョンアップによって状況が変化している可能性もある。
概要
PC側でのセットアップが完了済みの前提で、スマホ側のObsidianにGitプラグインを追加し、GitHubのFine-grained Personal Access Tokenを使ってHTTPS認証する。
| 役割 | ツール |
|---|---|
| Gitクライアント | Obsidian Gitプラグイン（コミュニティプラグイン） |
| 認証 | GitHub Fine-grained Personal Access Token |
| リモートリポジトリ | GitHub |
セットアップ手順
1. GitHub Fine-grained Personal Access Tokenの発行
GitHub Settings → Developer Settings → Personal access tokens → Fine-grained tokens で発行。
- Repository access: 「Only select repositories」でObsidian同期リポジトリのみを指定
- Permissions:
Repository permissions → Contents → Read and write - Tokenは再表示不可のため、スマホ設定前に必ずローカルに保管する
2. iPhoneへのプラグインインストール
- App StoreからObsidianをインストール、新規Vault作成（iCloud OFF）
Settings → Community plugins → Turn on community plugins- Browse → 「Git」を検索・インストール・有効化
- プラグインOptionsの
Authentication/commit authorにGitHub usernameとPATを入力
3. Git Clone（コマンドパレット）
コマンドパレット（右下ハンバーガーメニュー → Open command palette）から：
Git: Clone an existing remote repo
- Remote URL: リポジトリのHTTPS git URL（GitHubの「Code → HTTPS」から取得）
- Clone directory: Vault root
.obsidianディレクトリをpush済みであれば「YES」→「DELETE ALL YOUR LOCAL CONFIG AND PLUGINS」で上書き
4. git author情報の設定
Clone後、Obsidianを再起動し Settings → Community plugins → Git → Authentication/commit author で以下を設定：
- Author name for commit
- Author email for commit（GitHubアカウントと一致させるとcommitが紐付く）
5. 手動同期
右から左スワイプでSource Controlメニューを開く：
- ➕（stage all） → ✔️（commit） → ↑（push）
Working Copy方式との比較
| 観点 | Obsidian Gitプラグイン直接 | Working Copy方式 |
|---|---|---|
| 追加アプリ | 不要 | Working Copyが必要（有料） |
| 費用 | 無料 | ~4,500円（買い切り）または学生無料 |
| セットアップ | プラグイン設定のみ | フォルダリンク設定が必要 |
| 安定性（小規模Vault） | 動作報告あり（2024-11-10時点） | 高い |
| 安定性（大規模Vault） | 要確認（libgit2制限あり） | 高い |
| 自動化 | プラグイン設定で可能 | iOSショートカット連携 |
関連
- Obsidian Git同期（Working Copy） — Working Copyを使う代替アプローチ
- Obsidian Git同期（モバイル） — モバイルでのlibgit2制限とWorking Copy完全委任の推奨
- Obsidian × GitHub iOS同期 — Working Copy × iOSショートカットの詳細
- スマホのObsidianをGitで同期(2024.11) — 本概念のソース
- K.I（ishikawa096）