obsidian は何をしますか?
ローカルのObsidianボールトで作業するために使用します。Obsidianボールトは、Markdownファイルと .obsidian/ 設定フォルダからなる通常のフォルダです。
ソース
- アプリ設定:
~/Library/Application Support/obsidian/obsidian.json - デフォルトのボールト名:
obsidian - 通常のローカルのボールトパス:
~/obsidian - 公式CLI:
obsidian - ボールトコマンドはカレントワーキングディレクトリ(cwd)からボールトを解決します。
~/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が無効と表示する場合:
- ユーザーに設定 → 一般 → 詳細設定 → コマンドラインインターフェイス を有効にするよう依頼することを優先してください。
- 既にアプリ設定の構造を確認している場合、
~/Library/Application Support/obsidian/obsidian.jsonで"cli": trueと設定します。 - アプリレベルの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 ファイルを編集することを推奨します。長い散文に対して脆弱なシェルクォーティングは避けてください。
ベース、キャンバス、プラグイン
まずは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パスを通じて、隠しドットフォルダのノートを作成しないでください。
- リファクタリングがタスクでない限り、フロントマターとウィキリンクは保持してください。
- 複数のボールトが存在する場合は推測せず、
obsidian vaultsとobsidian.jsonを使用してください。