OpenKnowledge、MarkdownフォルダをAIエージェント対応のスマートナレッジベースに変換
リポジトリ内のプレーンテキストMarkdownファイルで作業メモやアーキテクチャ仕様書を管理してからしばらく経ちました。利点としては、すべてローカルに保存され、gitでバージョン管理され、どのIDEでも開けるということがあります。しかし、生のMarkdownタグやテーブルを含む長いテキストを編集するのは、すぐに面倒になります。NotionやGoogle Docsのような本格的なビジュアルエディタが欲しいけれど、他社のクラウドや独自のデータフォーマットに縛られたくないという状況です。
Claude Code、Cursor、その他のターミナルエージェントが日常のワークフローに加わったことで、さらに複雑になりました。常にコンテキストを渡し、セクションの書き直しを依頼したり、コードベースに基づいてドキュメントを更新したりする必要があります。
最近、InkeepチームがOpenKnowledgeをオープンソースとして公開しました。要するに、ビジュアルドキュメントエディタとニューラルネットワークエージェントの動作環境を組み合わせようとしたものです。
内部構造
OpenKnowledgeは、ディスク上の.mdまたは.mdxファイルを含むローカルフォルダを何でも開けます。リポジトリのルート、技術文書用のフォルダ、さらには古いObsidianボールトでも可能です。ここにはプロプライエタリなデータベースはなく、アプリはディスクからファイルを読み込み、プレーンテキスト形式で変更を保存します。
同時に、完全なWYSIWYGが利用可能です。見出し、リスト、リンク、インタラクティブなテーブル、埋め込みHTMLブロックが、入力と同時にリアルタイムでフォーマットされます。マークアップ構文に戸惑うことなく、生成されるファイルは標準的なMarkdownのままです。
メイン機能はサイドに隠されています。エディタにはModel Context Protocol（MCP）およびローカルCLIツール経由で言語モデルとやり取りするための組み込みパネルがあります。Claude、Codex、OpenCode、Pi、その他のエージェントと連携できます。
エディタの主な機能
プロジェクトをコンポーネントに分解すると、興味深い機能セットが得られます：
-
妥協のない本格的なWYSIWYG。 удобном визуальном представлении, и приложение сохраняет валидный Markdown или MDX на лету. Поддерживаются визуальные компоненты, граф связей между страницами (вики-ссылки), вкладки и быстрый поиск файлов.
-
AIとの協調編集。エージェントは画面の второй половине открывается и видит структуру ваших документов. Вы можете попросить модель создать архитектурный план, найти несоответствия в спецификации или переписать раздел, наблюдая за изменениями в реальном времени.
-
готовых интеграционных протоколов. При первом запуске утилита автоматически определяет установленных на вашей системе агентов (Claude Desktop, Cursor, Claude Code) и настраивает MCP-серверы и навыки поиска для вашей локальной базы знаний.
-
синхронизация и командное взаимодействие через Git. Проект не требует платных командных подписок. Синхронизация между устройствами и коллегами основана на обычном Git и GitHub.
インストールと実行方法
プロジェクトには2つの使用オプションがあります： готовый настольное приложение или локальный веб-интерфейс, работающий через Node.js.
macOS（Apple Silicon）、Windows 10+、Linux（deb/rpm）用のデスクトップビルドは、プロジェクトの公式サイトとリポジトリのリリースから入手できます。
サーバー上で作業している場合、Intel Macで動作させている場合、または単にコンソールからツールを起動したい場合は、CLIクライアントも利用可能です。Node.jsバージョン24以上が必要です：
コマンドはシステム全体をスキャンし、インストールされているアシスタントをチェックして、それらとエディタ間の接続を設定します。
実際の活用場面
作者たちは最初からいくつかのタスク向けにこのツールを位置づけています。
最初の明白なシナリオは、技術文書とアーキテクチャ仕様書です。システムデザインを説明したり、RFCを作成したり、レポートを準備する必要がある場合、ビジュアルインターフェースが時間を節約できます。同時に、エージェントはMCP経由で隣接するコードファイルを並行して読み取り、正確な関数シグネチャを提案できます。
2番目のシナリオは、個人用ナレッジベースまたは「第二の脳」です。LLM Wikiのコンセプト（Andrej Karpathyがよく言及している）でメモを管理している場合、エージェントがバラバラな思考を整理してリンクするのを助けますが、OpenKnowledgeはこのベースへのインターフェース 역할을します。全文検索とセマンティック検索により、プロンプトを通じて必要なフラグメントをすばやく取得できます。
まとめ
OpenKnowledgeは、プレーンテキストエディタの簡素な環境からMarkdown編集を脱却させつつ、クローズドなクラウドサービスにユーザーを閉じ込めることのない、成功した試みと言えます。
コードはGPLv3ライセンスで配布され、TypeScriptで書かれており、コミュニティは積極的に成長しています。欠点は、WebバージョンにNode.js 24以上が必要なことであり、古いマシンでは環境の更新が必要になる可能性があります。しかし、ローカル仕様書を頻繁に使用し、AIアシスタントにドキュメントへの便利なアクセスを提供したい場合は、ぜひ試してみる価値があります。
関連プロジェクト