Obsidian

Obsidian vault = ディスク上の通常フォルダです。

Vault の構造 (典型的な例)

• Notes: *.md (プレーンテキストの Markdown; 任意のエディタで編集可能)
• Config: .obsidian/ (ワークスペース + プラグイン設定; スクリプトからは通常触らない)
• Canvases: *.canvas (JSON)
• Attachments: Obsidian 設定で選択したフォルダ (画像/PDF など)

アクティブな Vault を見つける

Obsidian デスクトップは以下の場所で Vault を追跡しています (信頼できる情報源):

• ~/Library/Application Support/obsidian/obsidian.json

obsidian-cli はそのファイルから Vault を解決します。Vault 名は通常 フォルダ名 (パスのサフィックス) です。

「どの Vault がアクティブ / ノートはどこに?」を素早く確認する

• デフォルトを既に設定している場合: obsidian-cli print-default --path-only
• そうでない場合は、~/Library/Application Support/obsidian/obsidian.json を読み取り、"open": true の Vault エントリを使用してください。

注記

• 複数の Vault は一般的です (iCloud vs ~/Documents、仕事/個人など)。推測せず、設定を読んでください。
• ハードコードされた Vault パスをスクリプトに書き込むのは避けてください。設定を読むか print-default を使用するほうが望ましいです。

obsidian-cli クイックスタート

デフォルト Vault を選択します (1 回限り):

• obsidian-cli set-default "<vault-folder-name>"
• obsidian-cli print-default / obsidian-cli print-default --path-only

検索

• obsidian-cli search "query" (ノート名)
• obsidian-cli search-content "query" (ノート内; スニペット + 行を表示)

作成

• obsidian-cli create "Folder/New note" --content "..." --open
• Obsidian URI ハンドラ (obsidian://…) が機能している必要があります (Obsidian がインストールされていることが必須)。
• URI 経由で「隠し」ドットフォルダ (例: .something/...) の下にノートを作成するのは避けてください。Obsidian が拒否する可能性があります。

移動/名前変更 (安全なリファクタ)

• obsidian-cli move "old/path/note" "new/path/note"
• Vault 全体の [[wikilinks]] と一般的な Markdown リンクを更新します (これが mv との主な利点です)。

削除

• obsidian-cli delete "path/note"

適切な場合は直接編集をお勧めします。.md ファイルを開いて変更すると、Obsidian がそれを反映します。