---
title: "AI編集の履歴をGitで残す｜obsidian-gitでナレッジ管理を監査可能にする"
excerpt: "ObsidianのvaultをGitリポジトリとして管理するobsidian-gitを検証しました。AIによるノート編集の監査ログとしてコミット履歴を活用する構成です。ObsidianがシェルPATHを引き継がない問題、外部ドライブ上のvaultが認識されない問題、モバイル同期の代替手段までをまとめています。"
author: "AI活編集部"
author_username: ai-katsu-editorial
published_at: 2026-04-14T00:00:00+00:00
verified_at: 2026-04-14T00:00:00+00:00
models: ["Claude Code"]
tools: ["Obsidian", "GitHub"]
tasks: ["開発・エンジニアリング", "ツール検証"]
canonical_url: https://ai-katsu.jp/articles/obsidian-git
---
# AI編集の履歴をGitで残す｜obsidian-gitでナレッジ管理を監査可能にする

AIにノートを編集させるようになると、新しい課題が出てきます。**いつ、どこが、誰（何）によって書き換わったのかが分からなくなる**ことです。

この検証では、Obsidianのvaultをそのままリポジトリとして扱う**obsidian-git**を導入し、**Gitのコミット履歴をAI編集の監査ログとして使う**構成を作りました。

## この検証の概要

| 項目 | 内容 |
| --- | --- |
| 検証時期 | 2026年4月14日〜（検証中） |
| 対象 | obsidian-git（Vinzent03/obsidian-git）v2.38.1（2026年4月12日リリース） |
| やりたかったこと | Obsidianで編集 → 毎回ターミナルでgit操作、という手間をなくす／Claude Code編集 → 自動バックアップのフロー確立／AIによる編集の「監査ログ」としてGitコミット履歴を活用 |
| 初期設定時間 | **約1時間**（トラブルシュート込み）／設定後の学習コストはほぼゼロ |
| 費用 | **0円**（プラグイン無料、テキストノートならGitHub無料枠内） |
| 判定 | **条件付きで導入可**（vaultを内部ストレージに置く前提） |

## 結論：AI編集の追跡にはGit履歴が最適

obsidian-gitを選んだ理由は、同期機能ではありません。

**Claude Codeと同一Gitリポジトリを共有するため、AI編集の追跡に最適だからです。**

| 項目 | obsidian-git | Obsidian Sync（公式） | Remotely Save |
| --- | --- | --- | --- |
| 機能性 | Git操作フル対応 | 同期のみ | 同期のみ |
| コスト | **無料** | 月額$8〜 | 無料〜 |
| **変更履歴** | **Gitで完全保持** | なし | なし |
| モバイル対応 | 不安定 | 安定 | 安定 |
| Claude Code連携 | **最適（同一Gitリポジトリ）** | 不可 | 不可 |

同期だけが目的なら公式のObsidian Syncのほうが安定しています。**差がつくのは「変更履歴が残るか」です。**AIがノートを編集する運用では、この一点が重要になります。

## ハマりポイント1：ObsidianはシェルのPATHを引き継がない

最初に詰まるのがここです。

**ObsidianはシェルのPATHを引き継がないため、gitバイナリのパスを明示的に設定する必要があります。**

設定場所は プラグイン設定 → **Advanced** → `Custom Git binary path`。ここに `/usr/local/bin/git` のような絶対パスを入力します。

**macOSでHomebrewやカスタムパスにgitをインストールしている場合は特に注意**が必要です。ターミナルでは動くのにObsidianからは見つからない、という状態になります。

## ハマりポイント2：外部ドライブ上のvaultは認識されない

gitバイナリのパスを設定してもエラーが消えませんでした。

**外部SSD（`/Volumes/` 以下）上のvaultで「Can't find a valid git repository」エラーが発生。**原因はmacOSのサンドボックスまたは外部ドライブのパス解決の問題と推測しています。

**解決策は、vaultを内部ストレージに移動することでした。**外部ドライブでの運用は避けるのが確実です。

| エラー | 原因 | 対処法 |
| --- | --- | --- |
| git not found / PATH error | ObsidianがシェルPATHを引き継がない | Custom Git binary pathに絶対パスを設定 |
| Can't find a valid git repository | 外部ドライブ上のvault または Custom base pathの誤設定 | vaultを内部ストレージに移動、またはCustom base pathを空にする |

## .gitignoreの推奨設定

vault全体をそのままコミットすると、認証情報や作業状態まで含まれます。

```
.obsidian/workspace.json
.obsidian/workspace-mobile.json
.obsidian/cache
.obsidian/plugins/*/data.json
.trash/
```

特に `plugins/*/data.json` は重要です。**プラグインによっては認証トークンがここに含まれる場合があります。**除外しておかないと、リポジトリに認証情報が入ります。

あわせて、**vaultルートに `CLAUDE.md` を配置してvault構造を説明する設計**にしています。AIが構造を把握したうえで編集できるようにするためです。

## モバイルは「使わない」という判断

obsidian-gitのモバイル版については、明確に非推奨という結論です。

**iOSのObsidian Gitプラグインは、iOSサンドボックス制約によりネイティブgitバイナリを呼び出せないため事実上使用不可です。**モバイルではisomorphic-git（JS実装）が使われますが、公式に「非常に不安定」と明記されています。

無料運用を前提としたモバイル同期の選択肢を比較しました。

| 方法 | 費用 | 安定性 | 設定難易度 | 自動化 |
| --- | --- | --- | --- | --- |
| Obsidian Sync | 月額$8〜 | 安定 | 低 | 完全自動 |
| **a-shell + lg2**（推奨） | **無料** | 中程度 | 中 | 半自動（Shortcuts可） |
| Working Copy | $19.99買い切り | 安定 | 中 | 半自動（Shortcuts可） |
| iSH + git | 無料 | 不安定 | 高 | 手動 |
| Obsidian Gitプラグイン（iOS） | 無料 | 非常に不安定 | 低 | 不可（事実上使用不可） |

a-shellでは**Unixの `git` コマンドではなく `lg2`（libgit2ベースの独自実装）を使います。**コマンド体系は同じですが呼び出し名が異なります。

日常のpull/pushは次のとおりです。

```
# 起動時（PCの変更を取り込む）
bookmark obsidian && cd knowledge-vault && lg2 pull origin

# 終了時（変更をGitHubへ）
bookmark obsidian && cd knowledge-vault && lg2 add . && lg2 commit -m "iOS update" && lg2 push origin
```

Apple Shortcutsに登録すれば1タップで実行できますが、**iOSのバックグラウンド制限により完全自動化はできません。**

## モバイルからの操作は別ルートで解決する

この検証では、モバイル同期を無理に解決していません。用途で使い分ける方針をとりました。

-   **スマホでノートを読みたい** → a-shell + lg2 でpullしてvaultを最新化
-   **スマホからノートを書いてGitHubに反映したい** → a-shell + lg2 で add/commit/push
-   **スマホからClaude Codeでvaultを編集・操作したい** → Cloudflare Workers の Remote MCP経由（a-shellは不要）

3つ目が成立するのは、**ClaudeのiOSアプリがチャットUIであり、ローカルディレクトリを参照・マウントする機能を持たない**ためです。スマホからvaultをAIに操作させるなら、リモート経由が現実的という整理になります。

## 制約：.mdxファイルは開けない

もうひとつ確認できた制約です。

**`.md` ファイルは開けますが、`.mdx` ファイルは開けません。**AstroでContent Collectionsを利用するプロジェクトをObsidianと連携させることはできませんでした。

ドキュメントをObsidianで管理する前提を置くなら、**拡張子の選択が制約になる**という点は先に知っておく価値があります。

## よくある質問

### Obsidian Sync（公式）ではだめですか？

**同期だけが目的なら公式のほうが安定しています。**obsidian-gitを選ぶ理由は、変更履歴がGitで完全に残ることと、Claude Codeと同一リポジトリを共有できることです。

### 「Can't find a valid git repository」が出ます

**vaultが外部ドライブ上にある可能性があります。**この検証では外部SSD上のvaultで発生し、内部ストレージへ移動して解決しました。Custom base pathの誤設定でも同じエラーが出ます。

### gitが見つからないと言われます

**ObsidianはシェルのPATHを引き継がないためです。**プラグイン設定のAdvancedセクションにある `Custom Git binary path` に絶対パス（例: `/usr/local/bin/git`）を設定してください。

### スマホでも使えますか？

**モバイル版obsidian-gitは非推奨です。**iOSサンドボックス制約でネイティブgitが呼べず、事実上使用できません。無料で運用するなら a-shell + `lg2` が現実的な代替になります。

## まとめ

-   obsidian-gitの価値は同期ではなく**変更履歴が残ること**。AI編集の監査ログとしてGitコミット履歴を使える
-   **ObsidianはシェルPATHを引き継がない。**Advanced → `Custom Git binary path` に絶対パスを設定する
-   **外部ドライブ上のvaultはリポジトリとして認識されない。**内部ストレージに置くのが前提
-   `.gitignore` で `plugins/*/data.json` を除外する（認証トークンが含まれる場合がある）
-   **モバイル版は事実上使用不可。**無料なら a-shell + `lg2`、AI操作はリモートMCP経由という使い分け
-   `.mdx` は開けないため、Content Collectionsを使うプロジェクトとは連携できない

AIにドキュメントを触らせる運用では、「戻せること」と「差分が見えること」が安心材料になります。既存のGitの仕組みをそのまま使えるなら、追加のコストはほとんどかかりません。

株式会社AI棒では、こうしたAI活用の検証を日々行い、企業のナレッジ管理とAI導入を支援しています。ご相談は[お問い合わせフォーム](/contact)から、継続的な伴走支援については[AI参謀](/ai-sanbo)をご覧ください。