Obsidian Sync から Git管理への移行マニュアル

📋 目次

1. 事前準備
2. GitHubアカウント作成
3. リポジトリのクローン
4. Cursorの設定
5. Obsidianの設定
6. 日常の操作方法
7. よくある質問・トラブルシューティング

事前準備

💾 現在のデータをバックアップ

1. 現在のObsidian Vaultフォルダを別の場所にコピー
2. デスクトップなどに「Vault_backup_日付」フォルダとして保存

⚠️ Obsidian Syncを無効化

1. Obsidianを開く
2. 設定（⚙️）→ Core plugins → Sync をオフ
3. 同期が完全に停止するまで待つ

GitHubアカウント作成

1. アカウント登録

1. https://github.com にアクセス
2. Sign up をクリック
3. 必要情報を入力：
   • Username: 英数字（例：mktn、makoto-nishino など）
   • Email: 普段使うメールアドレス
   • Password: 強力なパスワード

2. メール認証

1. 登録したメールアドレスに認証メールが届く
2. メール内の Verify email address をクリック

3. プロフィール設定（任意）

1. 右上のアイコン → Settings
2. Profile で名前・プロフィール画像を設定

リポジトリのクローン

1. リポジトリへのアクセス権限をもらう

管理者（Makoto）に以下を連絡：

• 「GitHubのUsername: [あなたのusername]」（例：mktn）
• 「リポジトリへの招待をお願いします」

2. 招待の承認

1. GitHubの通知またはメールで招待が届く
2. Accept invitation をクリック

3. Cursorでリポジトリをクローン

方法1: Cursorのコマンドパレットを使用（推奨）

1. Cursorを開く
2. Command + Shift + P (Mac) または Ctrl + Shift + P (Windows)
3. 「Git: Clone」と入力して選択
4. リポジトリURL: https://github.com/mktn/ohmyteeth-vault.git
5. 保存場所を選択（デスクトップ推奨）
6. GitHubの認証画面が表示されたらログイン

方法2: Cursorのターミナルを使用

1. Cursorを開く
2. View → Terminal または Command + J (Mac)
3. デスクトップに移動：

   cd ~/Desktop    # Mac
   cd %USERPROFILE%\Desktop    # Windows

4. リポジトリをクローン：

   git clone https://github.com/mktn/ohmyteeth-vault.git

4. Personal Access Token（PAT）の作成

認証エラーが出た場合：

1. GitHub → 右上アイコン → Settings
2. 左下 Developer settings
3. Personal access tokens → Tokens (classic)
4. Generate new token (classic)
5. 設定：
   • Note: "Obsidian Vault Access"
   • Expiration: No expiration
   • Scopes: repo にチェック
6. Generate token
7. 🚨 重要：トークンをコピーして安全な場所に保存

Cursorの設定

1. Git設定

1. Cursorを開く
2. ターミナルを開く：View → Terminal または Command + J
3. 自分の情報を設定：

   git config --global user.name "あなたの名前"
   git config --global user.email "GitHubのメールアドレス"

2. フォルダを開く

1. File → Open Folder
2. デスクトップの ohmyteeth-vault フォルダを選択

3. Cursor画面の見方

• 左サイドバー: ファイル一覧
• 中央: ファイル編集エリア
• 下部: ターミナル（必要時に表示）
• 左サイドバー下部: Source Control（ブランチアイコン）

Obsidianの設定

1. 新しいVaultとして開く

1. Obsidianを開く
2. Open folder as vault
3. ohmyteeth-vault フォルダを選択

2. Obsidian Gitプラグインのインストール

リポジトリにプラグインが含まれていない場合は、手動でインストールします：

1. 設定（⚙️）→ Community plugins
2. Turn on community plugins をクリック（初回のみ）
3. Browse ボタンをクリック
4. 検索窓で「Git」と入力
5. Git プラグイン（開発者: Vinzent, Denis Olehov）を見つける
6. Install をクリック
7. Enable をクリックして有効化

3. Obsidian Gitプラグインの設定

1. 設定（⚙️）→ Community plugins → Obsidian Git の設定をクリック
2. 推奨設定：

   Auto commit-and-sync interval: 30 minutes
   Auto commit-and-sync after stopping file edits: ON
   Auto pull interval: 15 minutes
   Commit message: {{hostname}}: {{date}} - {{numFiles}} files updated

4. 動作テスト

1. 適当なファイルを作成・編集
2. 30分待つか、手動でコミット：
   • Ctrl/Cmd + P → "Git: Commit all changes"
3. エラーが出ないことを確認

日常の操作方法

📝 Obsidianでの作業

1. 普通にノートを作成・編集
2. 保存は自動 - 特別な操作は不要
3. 30分ごとまたは編集停止後に自動でチームと同期

💻 Cursorでの作業

1. ファイル編集：左のファイル一覧から選択して編集
2. 変更の確認：
   • 左サイドバーのSource Control（ブランチアイコン）をクリック
   • 変更されたファイルが一覧表示
3. 手動コミット：
   • コミットメッセージを入力
   • Commitボタンをクリック
   • Sync Changesで同期

🔄 他のメンバーの変更を取得

• Obsidian: 15分ごとに自動取得
• Cursor:
  1. 左サイドバー → Source Control（ブランチアイコン）
  2. 右上の Sync Changes ボタンをクリック
  3. または ... メニュー → Pull

よくある質問・トラブルシューティング

❓ Q: 認証エラーが出る

A: Personal Access Tokenを使用してください

1. GitHub → Settings → Developer settings → Personal access tokens
2. 新しいトークンを生成
3. パスワード欄にトークンを入力

❓ Q: コンフリクト（競合）が発生した

A: 同じファイルを複数人で同時編集した場合

1. Cursorで競合ファイルを開く
2. <<<<<<< HEAD と >>>>>>> で囲まれた部分を確認
3. 正しい内容を残して、不要な記号を削除
4. 保存してコミット

❓ Q: ファイルが勝手に変更された

A: 他のメンバーの変更が反映されています

• GitHubで変更履歴を確認可能
• 必要に応じて以前のバージョンに戻せます

❓ Q: Obsidian Gitプラグインが動かない

A: 設定を確認してください

1. Community plugins が有効か
2. Git設定（user.name, user.email）ができているか
3. Cursorのターミナルで git status が正常に動くか
4. Cursorで同じフォルダが開かれているか確認

❓ Q: 間違ってコミットしてしまった

A: Cursorで取り消し可能

1. Source Control → 右上の ... メニュー
2. Undo Last Commit をクリック
3. または、ターミナルで：

   git reset --soft HEAD~1

プッシュ後は管理者に相談してください。

❓ Q: 非公開ファイルが同期されてしまう

A: .gitignoreに除外設定を追加 管理者に「○○フォルダを非公開にしたい」と連絡してください。

❓ Q: GitHubのウェブサイトで内容を見たい

A:

1. https://github.com/mktn/ohmyteeth-vault にアクセス
2. ブラウザでファイルの閲覧・編集が可能
3. 編集した場合は他のメンバーにも反映されます

❓ Q: 新しいパソコンでも使いたい

A: 同じ手順でセットアップ

1. 新しいPCでCursor・Obsidianをインストール
2. CursorでGit設定（user.name, user.email）
3. Cursorでリポジトリをクローン
4. Obsidianで同じフォルダを開く

❓ Q: 誰が何を変更したか知りたい

A: Cursorで確認可能

1. Source Control → 変更されたファイルをクリック
2. 右側に変更差分が表示
3. 変更者・日時も確認できます

❓ Q: オフラインでも使える？

A: 使えます

• オフライン中の変更はローカルに保存
• オンライン復帰時に自動で同期されます

❓ Q: バックアップはどうなる？

A: GitHubが自動バックアップ

• 全ての変更履歴が保存されます
• いつでも過去のバージョンに戻せます
• さらに安心したい場合は、定期的にローカルフォルダもバックアップ

🚨 緊急時の連絡先

技術的な問題が解決できない場合：

• Slack: @makoto
• メール: makoto@ohmyteeth.com

報告すべき情報：

1. 何をしようとしていたか
2. エラーメッセージの内容（スクリーンショット）
3. 使用しているOS（Mac/Windows）
4. CursorとObsidianで同じフォルダを開いているか

✅ 移行完了チェックリスト

• GitHubアカウント作成完了
• リポジトリへの招待承認完了
• ローカルにリポジトリクローン完了
• Cursor設定完了（Git設定含む）
• Obsidian設定完了（プラグイン設定含む）
• テストファイルで動作確認完了
• 質問・不明点を管理者に確認済み

🎉 お疲れさまでした！これでチーム全体でより効率的にナレッジ共有ができます。