obsidian-cli

保管庫のファイルを直接いじるのではなく、動いている Obsidian に頼んで操作させたいときのスキルです。エージェントは obsidian というコマンドを叩き、Obsidian の側がノートを読んだり、作ったり、探したりします。

同じ公開元の obsidian-markdown が「ノートの書き方」を教えるのに対し、こちらは「アプリの操作の仕方」を教えます。もう一つの柱がプラグインとテーマの開発で、直したコードを Obsidian に読み込み直させ、エラーや画面を確かめる手順が入っています。

SKILL.md の大きさ（2026-10-22 時点）

3,183 バイト

同梱ファイル（2026-10-22 時点）

0 件

よく使う形として載っている例

10 行

プラグイン開発の確かめの流れ

4 段

コマンドの一覧は持たず、obsidian help に任せる

SKILL.md はコマンドの全一覧を載せていません。obsidian help を叩けば常に最新の一覧が出る、という立場です。本文に置いてあるのは、書き方の決まりと、よく使う形の例だけです。

この作りなので本文は小さく収まっています（スキルを入れすぎて重くなる仕組み）。Obsidian の側でコマンドが増えても、スキルを直さずに済みます。

書き方の決まりは 2 種類

値を取るものは name="My Note" のように = でつなぎ、空白を含む値は引用符で囲みます。silent や overwrite のように値を取らないものは、名前だけを並べるスイッチです。

複数行の中身は、改行を \n、タブを \t で書きます。出力をクリップボードに写す --copy、ファイルを開かせない silent、一覧の件数を数える total も本文にあります。

どのノート・どの保管庫を相手にするか

保管庫は、最後に手前に出ていたものが既定です。別の保管庫を相手にするときは、vault="My Vault" を最初の引数に置きます。

よく使う形として載っている 10 行

• read / create / appendノートを読む・作る（雛形を指定できる）・末尾に足す
• search語で探す。limit で件数を絞る
• daily:read / daily:append今日のデイリーノートを読む・タスクを足す
• property:setノートの属性を書く
• tasks / tags / backlinksタスク・タグの集計・被リンクを引く

プラグイン開発の確かめは 4 段

1. 読み込み直すplugin:reload id=... で直したプラグインを読み込ませる
2. エラーを見るdev:errors。出たら直して 1 段目に戻る
3. 目で確かめるdev:screenshot で画面を撮るか、dev:dom で要素を調べる
4. コンソールを見るdev:console level=error で警告や想定外の出力を探す

ほかに、アプリの中で JavaScript を走らせる eval、CSS の値を調べる dev:css、モバイル表示を真似る dev:mobile on があります。CDP やデバッガの操作は obsidian help で見よ、とされています。

同じリポジトリの 5 件の組み方と入れ方は、Obsidian の地図にまとめています。

Obsidian を開いていない環境

SKILL.md は、Obsidian が開いていることを前提にしています。CLI は動いている Obsidian につなぐ仕組みなので、デスクトップのアプリが無いサーバーや CI では使えません。

ファイルとしてノートを書くだけなら、アプリは要りません。記法は obsidian-markdown が扱います。

表やキャンバスの定義を書きたいとき

• 表として引く定義（.base）同じ公開元の obsidian-bases
• キャンバス（.canvas）同じ公開元の json-canvas
• ノートの記法同じ公開元の obsidian-markdown

このスキルはアプリの操作を教えるもので、.base や .canvas の中身の書き方は扱いません。表は obsidian-bases、キャンバスは json-canvas です。

コマンドの意味を本文だけで知りたいとき

本文は例が中心で、各コマンドの引数の全部は載っていません。細かい指定は、実際に obsidian help を叩いて確かめる前提です。

解析で分かること

SKILL.md はエージェントに obsidian コマンドを実行させます（シェル実行）。create・append・property:set などはノートを作る・書き換える操作で、書き方の例には上書きの overwrite も出てきます。

外部の URL は、公式の文書（help.obsidian.md/cli）への案内が 1 か所あるだけです。同梱ファイルはありません（2026-10-22 時点）。

書き換えは保管庫の控えを取ってから

ノートを作る・足す・属性を書く操作は、保管庫のファイルに直接効きます。試すときは、保管庫を git の管理下に置くか、控えを取ってからにしてください（スキルを入れる前に確認すること）。

名前で探すと別のノートに当たることがある

file= はウィキリンクと同じ解決の仕方で、名前だけでノートを探します。同じ名前のノートが複数あるときに確実に当てたいなら、path= で経路を書くほうが確かです。

何も指定しないと、いま開いているノートが相手になります。書き換えの指示では、相手のノートを明示させてください。

CLI を使えるようにする手順

Obsidian の公式の案内（obsidian.md/help/cli、2026-10-22 確認）では、CLI には 1.12 の installer が要り、1.12.7 以降を勧めています。設定の「一般」で「Command line interface」を入れ、案内に従って登録すると obsidian が PATH に入ります。

Windows では、登録のあと端末を開き直すまで反映されません。同じ案内には、Obsidian が動いていなければ最初のコマンドで起動する、とも書かれています。

対象の保管庫を取り違えない

既定の相手は、最後に手前に出ていた保管庫です。保管庫を複数使っているなら、vault= を最初に置かせると取り違えが起きません。

ライセンスは MIT

リポジトリの LICENSE は MIT です。再配布や商用利用の前に公開元の表記を確認してください。

Obsidian を閉じていても使えますか

SKILL.md は、Obsidian が開いていることを前提にしています。公式の案内では、動いていなければ最初のコマンドで Obsidian が起動するとされています（2026-10-22 確認）。いずれにしてもデスクトップのアプリが要るので、アプリの無いサーバーでは使えません。

どんなコマンドがあるかはどこで分かりますか

obsidian help です。SKILL.md は全一覧を載せず、これが常に最新だとしています。公式の文書（help.obsidian.md/cli）も案内されています。

obsidian-markdown と何が違いますか

obsidian-markdown はノートの記法を教え、エージェントがファイルを直接書きます。obsidian-cli は動いている Obsidian にコマンドで頼む方法を教えます。検索・被リンク・デイリーノート・タスクの集計など、アプリが持つ機能を使えるのがこちらの特徴です。

プラグインの開発にも使えますか

使えます。本文に、読み込み直す・エラーを見る・画面や要素を確かめる・コンソールを見る、の 4 段の流れがあります。アプリの中で JavaScript を走らせる eval もあるので、任せる範囲は先に決めてください。

対応しているエージェントはどれですか

Claude Code と Codex です。公開元の README が、Claude Code と Codex それぞれへの入れ方を節に分けて案内しています（2026-10-22 確認）。README は OpenCode への入れ方も載せていますが、当サイトの表示は Claude Code と Codex だけです。