mcpField
O
obsidian

obsidian

github.com/steipete生産性7.4k98 回インストール1 日前に更新
リポジトリ

obsidian について

公式 CLI と Markdown ファイルを使って、ローカルの Obsidian vault を扱うスキルです。リンクや設定を保ちながら、対象を絞って読み書きする方法を案内します。

主な機能

  1. 01vault 内のノート検索と読み取り
  2. 02ノートの作成、追記、移動
  3. 03デイリーノート、リンク、アウトラインの確認
  4. 04Bases とプラグイン設定の照会
  5. 05対象を絞った安全な編集の案内

活用シーン

  1. 01vault 内でノートやバックリンクを探す
  2. 02デイリーノートに内容を追加する
  3. 03リンクを更新しながらノートを移動する
  4. 04Markdown ファイルを慎重に編集する

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/steipete/agent-scripts --skill obsidian

インストール後、Claude Code で/obsidianを入力して読み込まれたか確認します。

詳細

Obsidian

ローカルの Obsidian ボルトで作業するときに使用します。Obsidian ボルトは、Markdown ファイルと .obsidian/ 設定ファイルを含む通常のフォルダーです。

ソース

  • アプリ設定：~/Library/Application Support/obsidian/obsidian.json
  • デフォルトのボルト名：obsidian
  • 通常のローカルボルトのパス：~/obsidian
  • 公式 CLI：obsidian
  • ボルトのコマンドは現在の作業ディレクトリからボルトを解決します。~/obsidian から実行してください。

最初に確認すること

command -v obsidian
obsidian version
obsidian vaults
cd ~/obsidian
obsidian commands filter=search:

version や vaults などのグローバルコマンドは、ボルトの外でも動作します。ボルトのコンテンツを扱うコマンドは、~/obsidian の外では Vault not found. と表示される場合があります。CLI の確認には obsidian help ではなく、obsidian commands を使用してください。

obsidian で CLI が無効と表示された場合：

  1. Settings -> General -> Advanced -> Command line interface で有効にするよう、まずユーザーに依頼してください。
  2. アプリ設定の形式をすでに確認している場合、~/Library/Application Support/obsidian/obsidian.json では "cli": true を使用します。
  3. アプリレベルの CLI 設定を変更した後は、Obsidian を再起動してください。

読み取りのワークフロー

Obsidian を認識した検索には、公式 CLI を優先してください。

cd ~/obsidian
obsidian search query="OpenClaw" format=json
obsidian search:context query="OpenClaw" limit=20 format=json
obsidian read path="Folder/Note.md"
obsidian file path="Folder/Note.md"
obsidian outline path="Folder/Note.md" format=json
obsidian backlinks path="Folder/Note.md" format=json
obsidian links path="Folder/Note.md"
obsidian properties path="Folder/Note.md" format=json

パスがすでにわかっており、バイト列を正確に取得する必要がある場合は、ファイルシステムから直接読み取ってください。

sed -n '1,220p' "$HOME/obsidian/Folder/Note.md"
rg -n "term" "$HOME/obsidian"

情報の新しさやボルトの選択が重要な場合は、使用したソースを報告してください。

書き込みのワークフロー

最小限の範囲で書き込める方法を選択してください。

  • 新しいノート：obsidian create path="Folder/Note.md" content="..."。
  • デイリーノートへの追記／先頭への挿入：obsidian daily:append content="..."。
  • 簡単なノートの編集：Markdown ファイルに apply_patch を使用します。
  • ノートの名前変更／移動：リンクを更新できるよう、obsidian move path="Old.md" to="Folder/New.md" を優先してください。
  • 書き込み後に UI を開く場合：役立つとき、または依頼されたときにのみ open を追加してください。

よく使うコマンド：

cd ~/obsidian
obsidian create path="Notes/New.md" content="# New\n\nBody"
obsidian append path="Notes/New.md" content="More text"
obsidian move path="Notes/New.md" to="Archive/New.md"
obsidian daily:path
obsidian daily:read
obsidian daily:append content="- Follow-up item"

複数行のコンテンツでは、パスがわかった時点で apply_patch を使って .md ファイルを編集してください。長い文章に対して、壊れやすいシェルの引用符指定を避けてください。

Bases、Canvas、プラグイン

まず CLI でコマンドを確認してください。

cd ~/obsidian
obsidian bases
obsidian base:views path="Projects.base"
obsidian base:query path="Projects.base" view="Active" format=json
obsidian plugins format=json
obsidian plugins:enabled format=json
obsidian commands filter=workspace:

.canvas、.base、.json ファイルは、可能であれば構造化データとして読み取り／編集してください。書式を維持し、編集後に JSON を検証してください。

安全性

  • ボルトを一括で書き換えないでください。対象を限定したパスを使用し、差分を確認してください。
  • ユーザーから依頼された場合、または設定／プラグインに関する作業が明示的なタスクである場合を除き、.obsidian/ を編集しないでください。
  • 明示的に依頼された場合を除き、ノートを削除しないでください。完全削除ではなく、ゴミ箱への移動を優先してください。
  • Obsidian URI／CLI 経由で、隠しドットフォルダー内にノートを作成しないでください。
  • タスクでリファクタリングする場合を除き、フロントマターと Wiki リンクを保持してください。
  • 複数のボルトがある場合は推測せず、obsidian vaults と obsidian.json を使用してください。

コメント

Markdown 対応