重要なポイント
- 独立開発者HugoValimによるオープンソースのコミュニティプラグイン — Joplin公式製品ではない
- ライセンス：MIT（GitHubリポジトリによる）
- ベンダーSDKを使わない汎用のOpenAI互換HTTP/SSEエンドポイントで接続 — デフォルトのベースURLはOllamaの既定ローカルポート（
http://localhost:11434/v1） - 設定でベースURLを変更するだけでLM StudioやOpenAI APIでも動作
- Joplin 3.6以上が必要。デスクトップ専用 — Joplinモバイルには明示的に非対応
- ノートやファイルへの変更はすべて適用前に一時的な差分ドキュメントとして表示され、レビューされる — 無断で書き込まれることはない
- 取り消しは最大10回分の実行を最大7日間保持。並行制御はタイムスタンプベースの競合検出を使用
- ノートに対するオプションのセマンティック検索（RAG）にはJoplin 3.7以上が必要
📍 一文で説明
Joplin AI Agentは、レビューを前提としたAIチャットエージェントをJoplinに追加するコミュニティプラグインで、完全にローカルなOllamaやLM Studioサーバーを含む任意のOpenAI互換エンドポイントに接続できます。
💬 簡潔に説明
Joplin内にAIチャットパネルを追加し、ノートを読み取り、表示された差分をあなたが承認した場合のみ編集できます。クラウドの月額課金ではなく、自分のPC上でOllamaやLM Studioを使って動くモデルに接続するため、ノートを完全に自分のマシン内に留めることができます。
📌補足: このレビューはローカルLLMソフトウェアディレクトリにあるJoplin AI Agentの掲載内容を掘り下げた記事です — 他の数十のローカルAI対応ツールとの比較は同ページを参照してください。
Joplin AI Agentとは？
Joplin AI Agentは、クロスプラットフォームのオープンソースノートアプリJoplin向けのコミュニティプラグインで、独立開発者HugoValimがMITライセンスのオープンソースソフトウェアとして開発・配布しています。自身のGitHubリポジトリによれば、Joplinプロファイル内のノート・ノートブック・テキストファイルに対して、ツールベースの読み書きアクセスを持つAIエージェントを追加し、あらゆる変更提案は適用前にレビューステップを経ます。
- プラグインID：
com.hugovalim.joplin-ai-agent - 本レビュー時点でバージョン0.7.0 — プラグインのバージョンは本記事とは独立して更新されるため、最新版はリポジトリを直接確認してください
- 主な機能：サイドバーのチャットエージェントがJoplinプロファイル内のノート・ノートブック・テキストファイルを検索・読み取り、レビュー後に編集できる
- ローカル推論：推論エンジンを内蔵しておらず、別途起動しているOpenAI互換サーバー（Ollama、LM Studio、またはクラウドAPI）にリクエストを送信する方式で、モデル重み自体は同梱していない
- 開発者：HugoValim。オープンソースとして配布する独立開発者で、Joplinのメンテナーとは無関係
- 正規のリポジトリ：github.com/HugoValim/joplin-ai-plugin
Joplin AI Agentでできること
自身のREADMEによれば、Joplin AI Agentはボールト全体を把握したチャット、ツールベースのファイルアクセス、そして書き込み前のレビューステップを組み合わせています。
- 永続的なチャット履歴 — 会話ごとにリセットされるのではなく、セッションをまたいでコンテキスト設定と実行サマリーを保持
- オプションのノート検索（RAG） — ノート内容をコンテキストとして使えるセマンティック検索。この機能に限りJoplin 3.7以上が必要
- プロンプトインジェクション対策・捏造引用対策のルール — ノート内容経由のプロンプトインジェクションを防ぎ、エージェントがノートについて書く際の捏造引用を減らすためのルールを文書化
- ツールベースの読み書きアクセス — エージェントはノート・ノートブック・プレーンテキストファイルを読み、編集を提案できる。単に会話するだけではない
- レビュー必須の変更提案 — 提案された編集は適用前に一時的な差分ドキュメントとして表示され、無断で書き込まれるのではなく、正確な変更内容を承認または却下できる
- タイムスタンプベースの競合検出 — 変更を適用する前にノートの更新タイムスタンプを確認し、並行編集を検出する
- 取り消し履歴 — 最大10回分の実行を最大7日間保持し、エージェントによる不適切な編集を後から取り消せる
- キーボードショートカット付きサイドバーUI — チャットパネルはJoplinのサイドバーにあり、キーボードショートカットを備え、長い履歴は1ページ100メッセージでページ分割される
- 外部フォルダーワークスペース対応 — Joplinプロファイル外の外部フォルダー内ファイルに対しても動作し、そのフォルダーの
.gitignoreを尊重する
Joplin AI Agentをローカルモデルに接続する方法
Joplin AI Agentは任意のOpenAI互換HTTP/SSEエンドポイントと通信します — ベンダー固有のSDKを設定する必要はありません。 デフォルトのベースURL http://localhost:11434/v1 はOllamaの既定のローカルサーバーポートと一致するため、標準的なOllamaのローカルインストールならURL変更なしでそのまま動作します。
ベースURL
APIキー
- 入力内容:
- ほとんどのローカルサーバーでは任意。必須とするクラウドプロバイダーでは必要。
モデル名
- 入力内容:
- バックエンドが報告する正確なモデル識別子（例：すでにpull済みのOllamaモデルタグ）。
システムプロンプト、温度、出力トークン数、タイムアウト
- 入力内容:
- エージェントの挙動を調整するオプション項目 — 変更する明確な理由がなければデフォルトのままでよい。
すべての設定はJoplinの設定 →「Joplin AI Agent」にあります。プラグインはベンダー固有のSDKではなく汎用のOpenAI互換プロトコルを話すため、同じAPI形式を公開しているローカルまたはセルフホストのサーバーであれば、ベースURLを変更するだけで動作するはずです。
Joplin AI Agentの入手方法
Joplin AI Agentは単体アプリではなく、Joplin内のプラグインとしてインストールされます — Joplin自体がすでにインストールされている必要があります。本レビュー時点で、このプラグインがJoplinアプリ内のコミュニティプラグイン検索に表示されるかは確認できていないため、GitHub Releasesで公開されている.jplファイルから手動でインストールしてください。
GitHub Releasesからの手動インストール（推奨）
- インストール手順:
- GitHub Releasesページから
com.hugovalim.joplin-ai-agent.jplをダウンロードする。Joplinで設定 → プラグインを開き、「ファイルからインストール」を使ってダウンロードした.jplファイルを選択する。求められたらJoplinを再起動し、まだ有効になっていなければプラグインを有効化する。
ソースからビルド
- インストール手順:
- github.com/HugoValim/joplin-ai-pluginをクローンし、リポジトリ自体のビルド手順に従う — 特定のコミットを使いたい場合や、変更を貢献したい場合に有用。
Joplin 3.6以上が必要です。Joplin AI Agentはデスクトップ専用で、Joplinのモバイルアプリには明示的に対応していません。Windows・macOS・LinuxのデスクトップJoplinにのみインストールしてください。
Joplin AI Agentは書き込み時にノートをどう保護するか？
Joplin AI Agentが提案するノートやファイルへの変更は、まず一時的な差分ドキュメントとして表示され、無断で編集されることはありません。 適用するかどうかを決める前に、正確な変更内容をレビューできます — エージェントが自分の判断でノートを上書きすることはありません。
- 差分優先の書き込み — 提案された変更は、実際のノートに適用される前に、何が変わるかを正確に示す一時的な差分ドキュメントとして表示される
- タイムスタンプベースの競合検出 — 変更を適用する前にノートの最終更新タイムスタンプを確認し、あなたや別のデバイスがエージェントの読み取り後にノートを変更したケースを検出する
- 取り消しウィンドウ — 最大10回分の実行が最大7日間復元可能なままとなり、望まない変更を適用前に却下するだけでなく、後からでも取り消せる
- プロンプトインジェクション対策・捏造引用対策のルール — 自身の文書によれば、ノート内容経由のプロンプトインジェクションを防ぎ、エージェントがあなたのノートを参照する際の捏造引用を減らすルールを適用している
Joplin AI Agentは誰向け？
Joplin AI Agentが合うかどうかは、すでにJoplinをノートアプリとして使っており、自分で管理するバックエンドを使ってそのボールトを読み取り・レビュー後に編集できるAIエージェントを求めているかどうかによります。
競合とその代替
Joplin AI Agentは、単体のチャットインターフェースではなく特定のノートアプリ向けに作られた他のAIエージェントプラグインと最も直接的に競合します。現時点でPromptQuorumが公開している最も近い比較記事は、別のホストアプリを対象としたものです。
- Copilot for Obsidian レビュー — 同じカテゴリのAIエージェントプラグインだが、対象はJoplinではなくObsidian。ノートボールトを読み取り編集するAIエージェント（ローカルモデル対応）という同じ核となる考え方を共有しており、二つの異なるノートアプリが同じ課題にどう取り組んでいるかを比較する際に参考になる。
- Smart Connectionsのレビュー — 同じ「ノートアプリ内のAI」という広いカテゴリーの別種のツール：Obsidian向けのローカルセマンティック検索・リンク発見プラグインであり、ファイルを編集するエージェントではない。
Joplin AI Agent評価時のよくある誤解
Joplin AI Agentに関する混乱の多くは、それをJoplin公式機能だと思い込むこと、またはモバイルでもデスクトップと同様に動作すると期待することから生じます。
よくある質問
Joplin AI Agentとは何ですか？
Joplin AI Agentは、ノートアプリJoplin向けにコミュニティが開発したプラグインで、ノート・ノートブック・テキストファイルへの読み取り、そしてレビュー後の書き込みアクセスを持つAIチャットエージェントを追加します。開発者HugoValimが独立して開発しています。
Joplin AI Agentはローカルなノート検索AIモデルで動作しますか？
はい。任意のOpenAI互換HTTP/SSEエンドポイントに接続でき、デフォルトのベースURL（http://localhost:11434/v1）はOllamaのローカルサーバーと一致するため、コード変更なしで完全にローカルなモデルで動作します。ベースURLを変更するだけでLM Studioや他のOpenAI互換サーバーでも動作します。
Joplin AI AgentはJoplinチームが作っているのですか？
いいえ。開発者HugoValimが開発・保守する独立したコミュニティプラグインであり、Joplinのメンテナーによる開発でも公式承認でもありません。
Joplin AI Agentはどのライセンスで公開されていますか？
github.com/HugoValim/joplin-ai-pluginのGitHubリポジトリによればMITライセンスです。
Joplin AI Agentのインストール方法は？
プラグインのGitHub Releasesページからcom.hugovalim.joplin-ai-agent.jplファイルをダウンロードし、Joplinで設定 → プラグインを開き、「ファイルからインストール」で選択します。Joplinアプリ内のプラグインマーケットプレイスで検索可能かは確認できていないため、この手動インストールが文書化された手順です。
Joplin AI AgentはJoplinモバイルで動作しますか？
いいえ。このプラグインはJoplinモバイルに明示的に対応しておらず、Windows・macOS・LinuxのJoplinインストールでのみ、デスクトップ専用で動作します。
Joplin AI Agentが必要とするJoplinのバージョンは？
プラグイン自体にはJoplin 3.6以上が必要です。オプションのノート検索（RAG）機能に限り、Joplin 3.7以上が必要です。
Joplin AI Agentは自動的にノートを編集しますか？
いいえ。提案された変更はすべて、適用前にレビュー用の一時的な差分ドキュメントとして表示されます — エージェントが無断でノートに書き込むことはありません。
Joplin AI Agentが行った変更を取り消せますか？
はい。プラグインは最大10回分の実行を最大7日間保持するため、最近のエージェントによる変更を後から取り消せます。
Joplin AI Agentが対応するAIバックエンドは？
自身の文書によれば、任意のOpenAI互換HTTP/SSEエンドポイントに対応しています — ベンダー固有のSDKではなく汎用のAPI形式を使うため、Ollama（デフォルト）、LM Studio、OpenAI APIが含まれます。