claude-obsidianは出典付きObsidian vaultをローカルで育てる

vaultは通常ファイルのまま残る

READMEはclaude-obsidianをClaude Codeと互換Agent Skills host向けのlocal-first knowledge systemと位置づけます。vaultはMarkdown、JSON、source filesの通常ディレクトリで、plugin cacheに隠れず、cloud databaseに閉じず、モデルへ黙ってアップロードしないと説明しています。Andrej KarpathyのLLM Wikiパターンを踏襲し、kepano/obsidian-skillsをObsidian Markdown、Bases、JSON Canvas構文の参照基盤に据えています。

README自身は、これを自動文字起こし装置、cloud sync、factual oracle、backupやsource controlの代替ではないと線引きしています。保存形式と所有境界を重視する用途向けで、単純なメモ用途だけなら15 skills導入の負担が上回る可能性があります。リポジトリはPython、MITライセンス、default branch mainです。homepageはagricidaniel.com/blog/claude-obsidian-ai-second-brainへリンクしています。

README descriptionはself-organizing AI second brain for Obsidian + Claude Codeと述べ、open-source Notion alternative、PKM、AI note-takingの文脈で位置づけています。ただしクラウドSaaS型Notionの共同編集やhosted searchをそのまま期待する用途とは設計が異なり、local filesとprovenance ledgerが中心です。

sourceからliving knowledgeへの反復ループ

READMEはMost AI note workflows stop after saving textと対比し、claude-obsidianを反復可能なループとして構成しています。Capture with contextはlocal sourceをvisible inboxへ通し、synthesis前にimmutable content-addressed copyを保持します。Ground every important claimはsource and claim ledgersでauthority、freshness、support、contradiction、confidence、review stateを維持します。

Connect what you learnはlinked pages、indexes、Maps of Content、methodology-aware structures、Obsidian Canvas viewsを構築します。Use the vault againは既知内容をquery、research、retrieve、lint、foldし、毎回ゼロから会話を始めない設計です。出力はagentの有無にかかわらず有用であることを意図し、plain Markdownはportability、Obsidianはnavigationとvisual explorationを担います。

Local by default、Sources survive the summary、Knowledge compounds deliberatelyの3点もREADME Why it feels different節の要点です。vaultはuser-owned ordinary filesであり、network egressは別決定とREADMEは繰り返し述べます。unsupported claimやcontradictory claimはvisibleのまま残す設計で、summaryだけが正典にならないことを意図しています。

initはJSON planを承認してから適用

Quick startはgit clone https://github.com/AgriciDaniel/claude-obsidian.gitとcd claude-obsidianから始まり、製品checkoutとknowledge vaultを分けます。scripts/claude-obsidian.py initにvaultパス、--generated-at、--operation-idを渡すとJSON planが返り、approved_plan_sha256をコピーして同じinitに--applyを付けます。

READMEは各mutating setup commandが適用前に操作内容を表示すると述べます。初回は既存vaultを直接触らず別ディレクトリを使い、planの対象パスとoperation idを保存します。既存Obsidian vaultにはdocs/install-guide.md#adopt-an-existing-vaultのadopt workflowがあり、initとadoptを混在させないことが重要です。v2.1.1はLegacy Migration Safety、v2.1.0はNative Windows Compatibility、v2.0.0はReliability and Evidence Refoundationを謳うリリースとしてREADMEにリンクされています。

initコマンドのJSON planにはapproved_plan_sha256が含まれ、apply時に同じgenerated-at、operation-id、sha256を渡さないと意図しないmutationを防げません。Quick startはclaude --plugin-dir /absolute/path/to/claude-obsidianをvault rootから起動することを示し、relative path依存を避けるようREADMEが書いています。

wiki系skillで取り込みから検索まで

READMEが示す基本ループは、inbox/へsourceを置き/claude-obsidian:wiki-ingestでlinked pagesとprovenance recordsへ変換することです。/claude-obsidian:saveはscoped answerやinsightを保存し、自動transcript保存はしません。/claude-obsidian:wiki-queryはvault evidenceからread-onlyで答え、/claude-obsidian:wiki-lintはdead links、orphans、metadata gaps、stale indexes、empty sectionsを報告します。

wiki skillはvault initialize/adopt、readiness diagnose、work routingを担い、wiki-modeはgeneric、LYT、PARA、Zettelkasten filing conventionsを切り替えます。wiki-retrieveはcontextual prefixes、BM25、optional cosine rerankingをREADMEに列挙しています。テストではinboxの1 sourceをwiki-ingestし、生成ページのリンク、出典、claim ledgerを確認し、wiki-queryの回答が同じvault内の証拠へ戻るかを見ます。

wiki-ingestはcaptured sourcesをlinked pagesとprovenance recordsへ変換し、saveはautomatic transcript recorderではないとREADMEは強調します。queryingはread-only、lintingはvault health report、retrievalはcontextual prefixとBM25、optional cosine rerankingを組み合わせます。Canvas skillはwiki-scoped Obsidian Canvas creation/maintenanceを担い、defuddleはingestion前のweb content cleaningです。

15 skillsとmulti-agent hostの差

skillsはwiki、save、wiki-ingest、wiki-query、wiki-lintの基本群に加え、autoresearch、canvas、defuddle、wiki-fold、wiki-mode、wiki-retrieve、wiki-cliなどへ拡張されます。参照用としてobsidian-markdown、obsidian-bases、thinkもREADMEに列挙されています。Claude Codeでは/claude-obsidian:wiki-lintのようにnamespaced invocationを使い、Codex、OpenCode、Gemini向けにはbash bin/setup-multi-agent.sh --host codexと--apply版が案内されています。

CursorとWindsurfはworkspace-local skill discovery、WindowsとWSLはdocs/windows-wsl.mdが別途必要です。autoresearchはbounded web research with explicit egress and separate canonical merge、defuddleはclean readable web content before ingestion、canvasはwiki-scoped Obsidian Canvas creation/maintenanceです。optional toolsはdetected maturityとして宣言され、missing adapterはsimulateせずdegradeするとREADMEは説明しています。

obsidian-markdown skillはObsidian Flavored Markdown、links、embeds、calloutsの正しい書き方を参照skillとして提供し、obsidian-bases skillは.base tables、cards、filters、formulas、summariesを扱います。bin/setup-multi-agent.shはCodex、OpenCode、Gemini向けportable skill linksをpreview/applyし、CursorとWindsurfはworkspace-local discoveryが前提です。CHANGELOG.mdとLICENSEはupgrade判断の入口であり、v2.0.0のEvidence Refoundationはledger設計の変更点をreleases notesで確認する必要があります。

parallel agentはdraftをtransactionで適用

READMEはingestion、querying、linting、retrieval、research、rollupsがprovenance-aware modelを共有すると述べます。Parallel agents cannot race the vaultと明記し、workersがdraftを返し、一つのorchestratorがinspectしてrecoverable transactionとして適用します。network egressは別の明示的判断です。

Capabilities are stated honestlyとして、optional tools are detected、maturity is declared、missing adapters degrade clearly instead of being simulatedとREADMEは説明します。この設計は複数生成結果をそのまま正典にしないチーム向けです。反面、Markdownの可読性だけでは根拠の正しさは保証されません。MITライセンス下でvault backup、source control、operation logを別管理し、wiki-lintが報告したorphanやmetadata gapを実ファイルで確認してから範囲を広げるのがREADMEの想定に沿います。

recoverable transaction設計は、parallel workersがdraftを返した後にorchestratorがinspectして適用するため、同時編集によるvault破損を避ける意図があります。wiki-lintでorphanやstale indexが出た場合、linked pageを手で直す前にsource ledger上のauthorityとreview stateを確認する流れがREADMEのprovenance-aware modelに沿います。

claude-obsidian.py initで確認する手順

試験手順はREADME Quick startに沿います。$HOME/Documents/TestVaultのような別パスでexport GENERATED_ATとOPERATION_IDを設定し、python3 scripts/claude-obsidian.py init "$HOME/Documents/TestVault" --generated-at "$GENERATED_AT" --operation-id init-reviewedをplanのみ実行します。表示されたapproved_plan_sha256をメモし、同じ引数に--approved-plan-sha256 "<sha256-from-the-plan>" --applyを付けて適用します。

適用後、cd "$HOME/Documents/TestVault"からclaude --plugin-dir /absolute/path/to/claude-obsidianを起動し、/claude-obsidian:wikiでreadinessを確認します。inbox/へ小さなPDFやMarkdownを1件置き/claude-obsidian:wiki-ingestを実行し、linked page、source ledger、claim ledger、contradiction、confidence、review stateをファイルシステムで追います。wiki-queryへ同じトピックを投げ、回答がvault内citeに戻るか、wiki-lintがdead linkを報告しないかを記録します。

導入試験では、製品checkoutとvaultを混同しないことが最初の関門です。checkout側のskills/配下に各skill contractがあり、trigger phrasesとmutation ruleがskillごとに分かれています。vault側ではinbox/、source ledger、claim ledger、Canvasファイル、operation logが通常のファイルとして残るため、ObsidianのGraph viewやCanvas viewで人間が目視確認できます。wiki-foldはoperation logからextractive rollupを作り、wiki-cliはObsidian CLI reads/searchとtransaction-safe writesをREADMEに説明しています。think skillはobserve、listen、connect、create、growのreview loopを提供します。upgradeとuninstallはinstallation guideにあり、marketplace setupやevery supported hostの手順も同guideに集約されています。Windows native対応はv2.1.0、legacy migration safetyはv2.1.1がREADME releasesに記載する焦点です。

adopt workflowではnon-destructiveに既存vaultを取り込み、installation guideの手順どおりvault selectionとmutation previewを確認します。wiki-modeでLYT、PARA、Zettelkastenを切り替えた場合、同じsourceから生成されるfolder structureとMOCが変わるため、mode変更前後でwiki-lint結果を比較します。autoresearchはexplicit egressとseparate canonical mergeが前提で、networkを開く前にegress policyを文書化しておく必要があります。

READMEに無い運用条件

README取得時点のGitHubメタデータ（stars 14283、forks 1436、open issues 141）は本文に含まれず、READMEもその数値が実際の導入数を示すとは書いていません。SLA、性能数値、セキュリティ監査結果もREADMEにはありません。

評価ではdocs/install-guide.md、docs/windows-wsl.md、CHANGELOG.md、LICENSE、releases v2.1.1/v2.1.0/v2.0.0を公式READMEと照合し、READMEがリンクする一次資料だけを根拠にしてください。autoresearchのnetwork egressやWindows/WSL構成、marketplace setupは環境ごとに挙動が変わるため、自分のhostとvault pathで再現できた事実とREADME記述を分けて記録します。

編集部の結論

出典をMarkdownとして自分のディレクトリに残し、Claude Codeからvaultを運用したい人に向きます。クラウド同期や自動的な事実保証、バックアップ不要の運用を期待する人には合いません。別vaultでscripts/claude-obsidian.py initのJSON planを確認し、approved_plan_sha256付きで--applyした後、inboxから/claude-obsidian:wiki-ingestを通してsource ledgerとlinked pageが残るかを見てください。

公式情報源

1. Official documentation
2. Official README
3. Project repository
4. Release notes