Vault Sync

Vault Syncは既存のVault Gitリポジトリをユーザーのローカルファイルシステムにミラーリングします。ファイルシンクとローカル準備のためにのみ使用してください。検索、クエリ、チャット、インデックス作成、Vault作成、またはVault管理には使用しないでください。

セットアップ時

1. 環境がmacOS、Linux、またはWSL2であることを確認します。ネイティブWindows PowerShellおよびCommand Promptは対象外です。
2. bashとgitを確認します。rgはオプションですが、シンク後に有用です。
3. vault-syncがまだPATHにない場合はインストールします:

mkdir -p ~/.local/bin
curl -fsSL https://raw.githubusercontent.com/graphlit/vault-sync/main/bin/vault-sync -o ~/.local/bin/vault-sync
chmod +x ~/.local/bin/vault-sync

4. ユーザーが提供しなかった場合は、Vault GitリポジトリURLとローカルフォルダを確認します。デフォルトとして~/vaults/<repo-name>を使用します。
5. 現在の作業ディレクトリ、アプリ名、またはリポジトリオーナーからローカルVaultパスを推定しないでください。~/.zine/vault、~/.dossium/vault、または~/.graphlit/vaultなどの隠しアプリフォルダを作成しないでください。
6. 実行します:

vault-sync init <vault-repo-url> <path>
vault-sync pull <path>
vault-sync doctor <path>

7. ユーザーが定期的な更新を希望する場合は、プルスケジュールをインストールします:

vault-sync schedule install <path> --every 5m

シンク済みVaultを使用する場合

1. 実用的な場合は最初に更新します:

vault-sync pull <path>

2. まず<path>/README.mdを読みます。
3. .git、.zine、.dossium、.graphlit、.claude、.codexなどの隠しコントロールフォルダは無視します。
4. 通常のファイルシステムツールを使用します: ls、rg、sed、cat、およびネイティブファイル読み取り。
5. ユーザーが明示的にローカルファイルの編集を要求しない限り、Vaultを読み取り専用として扱います。

オプションのQMD検索コンパニオン

QMDがインストール済みでユーザーがより強力なローカル検索ヘルパーを希望する場合は、シンク済みVaultフォルダをQMDコレクションとして追加します:

qmd collection add <path> --name <name> --mask "**/*.md"
qmd context add qmd://<name> "Local Vault synced by Vault Sync"
qmd embed

QMDを使用して対象ファイルを検索し、ファイル読み取りで完全なソースを取得します。

Vault Syncはミラーです。エージェントがリーダーです。