LoreConvo について
LoreConvoは、コーディングエージェント向けのローカル優先セッションメモリサーバーです。構造化された履歴と決定事項をSQLiteに保存し、複数のクライアント間で検索できます。任意のセッションフックに対応し、記憶の確認・編集・削除も可能です。
主な機能
- 01ローカルSQLiteによるセッション記憶の保存
- 02エピソード記憶と意味記憶の構造化
- 03FTS5による全文検索
- 04任意のセッション終了時記録・開始時想起フック
- 05記憶の出所表示とユーザーによる編集・削除
活用シーン
- 01新しいコーディングセッションで作業を再開
- 02コーディングクライアントを切り替えて文脈を継続
- 03過去の決定、成果物、未解決事項を検索
- 04プロジェクトのMEMORY.mdを検索用にインデックス化
MCP 対応
セッション文脈の保存、検索、想起に使う40個のMCPツールを提供します。Cursor、Codex、Hermes Agentなどのクライアントに接続でき、Claude Codeではプラグインフックによる自動記録と読み込みにも対応します。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
ツール
40掲載時のツール一覧 · 1 日前に更新
| パラメーター | 型 | 必須 | 説明 |
|---|---|---|---|
| tags | any | いいえ | |
| title | string | はい | |
| project | any | いいえ | |
| summary | string | はい | |
| surface | string | はい | |
| end_date | any | いいえ | |
| artifacts | any | いいえ | |
| decisions | any | いいえ | |
| summarize | boolean | いいえ | |
| session_id | any | いいえ | |
| start_date | any | いいえ | |
| skills_used | any | いいえ | |
| open_questions | any | いいえ | |
| reasoning_notes | any | いいえ | |
| external_tool_session | boolean | いいえ |
詳細
LoreConvo v0.10.20
あなたの記憶は、ツールではなくあなたのアイデンティティに従います。あなたの同意のもとで。
LoreConvo は、Claude Code、Cowork、Codex、Cursor、Hermes Agent をまたいでコンテキストを引き継ぐ、唯一の AI メモリです。インストールは一度だけ。メモリは一つ。コーディングする場所を問わず使えます。
Claude Code のプラグインマーケットプレイスから直接インストールするか、PyPI 経由でインストールできます:
uvx --from loreconvo[server] loreconvo
LoreConvo が選ばれる理由
どこで作業しても使えます
LoreConvo は Claude Code、Cowork、Cursor、Codex、Hermes で使えます。どのクライアントを使う場合でも、同じメモリレイヤーが利用できます。プロジェクトの途中で切り替えても、コンテキストは自動的に引き継がれます。
多くのツールでは、メモリがマシンやワークスペースごとに分断されます。LoreConvo はすべての情報を、あなたが所有するローカルの SQLite データベースに保存し、どこからでも利用できるようにします。記録は、保存ツールを使った明示的な方法と、オプションのフックをインストールした場合にセッション終了時に自動で行う方法の2通りです。どちらの場合も、いつでもメモリを確認、編集、削除できます。
保存する内容は自分で管理できます
LoreConvo では、保存する内容を自分で管理できます。セッションフックをインストールした場合にのみ自動記録が実行され、保存内容はすべて確認でき、いつでもメモリを削除できます。
すべてのメモリには、取得元が正確に表示されます。どのインターフェースで取得されたか、いつ取得されたか、どのプロジェクトのコンテキストに属するか、どのスキルが生成したかがわかります。不明瞭な点はありません。完全な来歴を確認できます。
メモリは自分のマシンに保存されます
LoreConvo はすべての情報を、自分のマシン上の SQLite データベースに保存します。任意の AI 要約機能を明示的に有効にしない限り(デフォルトではオフ)、データはローカルに留まります。有効にするには LORECONVO_ANTHROPIC_API_KEY を設定します。このキーを使って、トランスクリプトの抜粋または要約が Anthropic API に送信されます。LoreConvo が汎用の ANTHROPIC_API_KEY を読み取ることはありません。クラウドアカウントは不要です。セッション履歴にアクセスできるベンダーもいません。
セッションは ~/.loreconvo/sessions.db に保存されます。このファイルはあなたが所有しており、バックアップでき、必要なときにいつでも削除できます。
生のトランスクリプトではなく、構造化されたメモリ
LoreConvo は各セッションについて、2種類のメモリを記録します。
- エピソードメモリ: 何が起きたか。要約、作成した成果物、未解決の質問など
- セマンティックメモリ: 何が決定されたか。セッションをまたいで保持される、プロジェクトに関する安定した結論
これらを組み合わせることで、Claude はチャットのトランスクリプトの山ではなく、プロジェクトの履歴を構造化して検索可能な形で記録できます。
想起ベンチマーク
LoreConvo の FTS5 検索は、60セッションの合成コーパス(6つのトピック領域、ラベル付きクエリ36件)を使ってベンチマークされています。
| バリアント | Recall@5 | MRR |
|---|---|---|
| FTS5 + 複合トークン展開(デフォルト) | 88.9% | 0.875 |
| FTS5 ベースライン(展開なし) | 72.2% | 0.708 |
複合トークン展開(camelCase/snake_case のクエリ前処理)により、autoSave、pipeline_tracker、get_context_for などの技術識別子を使うクエリで、Recall@5 が +35.7 pp 向上します。
クイックスタート
コマンド1つでインストールできます。
bash install.sh
これにより、仮想環境を作成し、依存関係をインストールして、すべてが正常に動作することを確認します。システムの Python は変更されず、手動で pip コマンドを実行する必要もありません。
Claude Agent SDK を直接使用していますか? 公開リポジトリを git clone し、SDK のローカルディレクトリ用プラグインローダーで指定してください。リポジトリのルートが自己完結型のプラグインディレクトリ(.claude-plugin/plugin.json + .mcp.json)です。SDK からインストールできる別のバンドルは存在せず、必要もありません。
LoreConvo の使用
Claude Code(ターミナル)
プラグインを読み込んでセッションを開始する場合:
claude --plugin-dir /path/to/loreconvo
既存のセッション内で読み込む場合:
/plugin add /path/to/loreconvo
/path/to/loreconvo をソースフォルダーを保存した場所に置き換えてください。
コードを変更した後は、/reload-plugins を実行すると、再起動せずに更新できます。
読み込みが完了すると、Claude は 40 個の LoreConvo MCP ツールすべてに自動的にアクセスできるようになります。Claude に「このセッションを保存して」または「X について話し合った内容を思い出して」と頼むと、自動的にツールが使われます。
Cowork(デスクトップアプリ)
- プロンプトボックスの横にある + ボタンをクリックします
- Plugins を選択します
- Add plugin を選択します
loreconvoのソースフォルダーを参照します
重要:データベースへの共有アクセス
Cowork はサンドボックス化された VM で実行されるため、デフォルトでは Mac のファイルシステムを参照できません。Claude Code で保存したセッションを読み込むには、Cowork の Claude に次のように頼みます。
「自分の ~/.loreconvo フォルダーをマウントして」
マウントすると、Cowork は Claude Code と同じデータベースを読み書きします。Code で保存したセッションは、Cowork にすぐに表示されます。
Claude Chat(ウェブ)
Chat はプラグインに対応していないため、LoreConvo にはワンコマンドのブリッジが用意されています。ターミナルで次を実行します。
bash export-to-chat.sh
これにより、直近のセッションがエクスポートされ、クリップボードにコピーされます(macOS)。Chat に切り替えて貼り付けます(Cmd+V)。これで、Chat は Code または Cowork のセッションのコンテキストをすぐに利用できます。
特定のセッションを検索するには:
bash export-to-chat.sh "tax prep"
サーフェス間での動作
LoreConvo の主な価値は、コンテキストが Claude の各サーフェス間で自動的に保持されることです。全体の流れは次のとおりです。
Claude Code (~/.claude/settings.json via `claude mcp add`)
|-- SessionEnd hook --> auto_save.py --> ~/.loreconvo/sessions.db
|-- SessionStart hook <-- auto_load.py <-+
|
Cursor (.cursor/mcp.json) <--MCP-----+
Codex (~/.codex/config.toml) <--MCP-+
Hermes Agent (~/.hermes/config.yaml) <-MCP-+
Cowork (MCP-native execution env) <--+
All surfaces: save_session / get_recent_sessions / search_sessions
Claude Chat (web)
|-- export-to-chat.sh --> clipboard --> paste into Chat
Claude Code は主要なサーフェスです。フックは自動的に実行されます。
- セッションが終了すると、
auto_save.pyが会話を取得し、構造化された要約(決定事項、成果物、未解決の質問、タグ)をローカルの SQLite データベースに保存します。 - 新しいセッションが始まると、
auto_load.pyがデータベースを照会し、最近のセッションをシグナル品質に基づいてスコアリングして、最も関連性の高いコンテキストをシステムコンテキストとしてセッションに挿入します。未解決の質問や決定事項を含むセッションは高く評価され、シグナルの弱いセッションは除外されます。また、プロジェクトディレクトリ内にあるMEMORY.mdもインデックスに登録されます(下記の MEMORY.md の自動インデックス化を参照)。
Cursor は、プロジェクトルートにある .cursor/mcp.json を介して接続します。Claude Code と同じ MCP プロトコルを使用します。セットアップの詳細は INSTALL.md を参照してください。
OpenAI Codex は、[mcp_servers.<name>] セクションを使用して ~/.codex/config.toml 経由で接続します。セットアップの詳細は INSTALL.md を参照してください。
Hermes Agent は、mcp_servers: キーの下にある ~/.hermes/config.yaml 経由で接続します。セットアップの詳細は INSTALL.md を参照してください。
Claude Chat(ウェブ)はプラグインに対応していません。export-to-chat.sh スクリプトがこのギャップを埋めます。直近のセッションをクリップボードにエクスポートするため、Chat に直接貼り付けられます。これにより、Chat は Code が自動的に読み込むのと同じコンテキストを利用できます。
その結果、プロジェクトの途中でサーフェスを切り替えても、作業内容を何度も説明し直す必要がなくなります。
データはいつでも利用できます
LoreConvo は、MCP ツールが利用可能な場合はそれらを使い、利用できない場合はバンドルされたスクリプトに自動的に切り替えて動作します。MCP の状態にかかわらず、セッションは安全に保たれます。同じ保存、検索、想起の操作をどちらの場合でも利用できます。設定は不要です。プラグインのスキルが切り替えを自動的に処理します。
プロジェクトワークスペース
LoreConvo のプロジェクトは永続的なワークスペースです。プロジェクトでの作業に関するすべてのセッション、決定事項、成果物を、どの Claude 環境からでも検索できます。
# Create a project workspace
create_project("my-api", "REST API project", expected_skills=["openapi", "python"])
# Add persistent project instructions (optional)
create_project(
"my-api",
description="REST API project",
instructions="Python 3.10+, SQLite only. No cloud dependencies. Deploy via Docker."
)
# See recent sessions, skill usage, and open questions for the project
get_project("my-api")
# Search scoped to the project
search_sessions("auth design", project="my-api")
プロジェクトの指示(任意):プロジェクトの作成時に、Claude がセッション開始時に確認する永続的な指示や制約を保存できます。プロジェクト全体の標準を、各 CLAUDE.md ファイルで繰り返し記述せずに適用するのに便利です。指示は、最近のセッションの要約より前に、自動読み込みコンテキストとして表示されます。
LoreDocs と組み合わせると、LoreConvo は Claude のあらゆる環境で使えるポータブルなプロジェクトワークスペースを構成します。セッションの記憶と構造化されたナレッジを、すべてお使いのマシン上で管理できます。クラウド AI ワークスペースが利用者を単一のエコシステムに縛るのに対し、Lore の 2 つのツールは、すでにお使いのあらゆる Claude 環境で動作します。
MEMORY.md の自動インデックス作成
プロジェクトに MEMORY.md ファイルがある場合、LoreConvo はセッション開始時に毎回、自動でインデックスを作成します。内容は通常のセッションとともに search_sessions で検索できます。
これにより、Claude は MEMORY.md からプロジェクトの規約、チームのメモ、アーキテクチャ上の決定事項を呼び出せるため、利用者がそれらに言及する必要はありません。MEMORY.md からの検索結果には memory_md タグが付与され、source='file_memory' となるため、通常のセッションの記録と区別できます。
スキャン対象のディレクトリ
デフォルトでは、LoreConvo は Claude Code の実行ディレクトリ(現在の作業ディレクトリ)をスキャンします。別のディレクトリを指定するには、claude mcp add --scope user コマンドで環境フラグとして LORECONVO_PROJECT_PATH を渡します。
"--env=LORECONVO_PROJECT_PATH=/Users/YOUR_USERNAME/projects/my_project"
YOUR_USERNAME と my_project を実際の値に置き換えてください。完全な絶対パスを使用してください。~ や $HOME は使用しないでください。
検索結果での MEMORY.md エントリーのフィルタリング
検索に MEMORY.md のエントリーを含めるには、通常どおり search_sessions を使用します。自動的に表示されます。MEMORY.md のエントリーだけを表示するには、タグで絞り込みます。
「LoreConvo のセッションから、
memory_mdタグが付いたものを対象に『database conventions』を検索してください。」
インデックスはセッション開始のたびに更新されます(べき等で、重複は蓄積されません)。
インストールの確認
インストール後、Claude に次のように依頼して、LoreConvo が動作していることを確認します。
「
get_recent_sessionsを実行して、結果を表示してください。」
セッションの一覧(初回の場合は空の一覧)が表示されれば、LoreConvo は接続されています。ツールが見つからないというエラーが表示された場合は、bash install.sh を再実行してプラグインを再読み込みしてください。
フックの確認(Claude Code のみ):
「このセッションの開始時に、LoreConvo がコンテキストを自動読み込みしたか確認してください。」
SessionStart フックが動作していれば、Claude は最近のセッションのコンテキストを自動的に受け取っています。
推奨する CLAUDE.md の設定
最適なエクスペリエンスを得るには、次のスニペットを ~/.claude/CLAUDE.md(グローバル)またはプロジェクトの CLAUDE.md に追加してください。これにより、Claude がセッションをまたいで LoreConvo を一貫して使用できるようになります。
## LoreConvo (persistent session memory)
At session start:
1. Call `get_recent_sessions` to check for recent context relevant to the current work.
2. Use this context to avoid re-explaining things already discussed in prior sessions.
During the session:
- If important decisions are made or domain knowledge is shared, note it for the session summary.
At session end:
- Call `save_session` with a summary of what was accomplished, key decisions, open questions,
and any artifacts created. Use appropriate tags (e.g., project name, surface).
Cowork ユーザー向け: Cowork はフックを自動実行しません。プロジェクトの CLAUDE.md に、セッション開始時に get_recent_sessions を呼び出し、セッション終了時に save_session を呼び出すよう指示を追加してください。詳しくは COWORK_RESTORE.md をご覧ください。
プラン:Free と Pro
LoreConvo はローカル優先で、無料でご利用いただけます。Pro($8/月)ではセッション数の上限がなくなり、LLM品質の要約、ハイブリッド検索、製品間のリンク機能が利用できるようになります。どちらのプランでもすべての処理はお使いのマシン上で実行されます。Pro を利用しても、クラウドコンポーネントは追加されません。
Free の検索:キーワード(FTS5)+新しい順。 Pro の検索:ハイブリッド検索。ベクトル(BGE-small-en-v1.5)、BM25 全文検索、新しさによる再ランキングを RRF 融合で組み合わせます。キーワードだけでなく、意味に基づいてセッションを検索できます。
| Free | Pro ($8/mo) | |
|---|---|---|
| 保存できるセッション数 | 50 | 無制限 |
| 全文検索(FTS5) | はい | はい |
| MEMORY.md の自動インデックス作成 | はい | はい |
| プロジェクトのタグ付け、セッションのリンク、スキル履歴 | はい | はい |
| 自動読み込み/自動保存フック | はい | はい |
| ローカル優先、クラウド不使用、API コストゼロ | はい | はい |
| 関連セッションの検出 | キーワードの共起 | 埋め込みベース(BGE-small-en-v1.5) |
| LLM による非同期セッション要約 | -- | はい(Claude Haiku、オプトイン) |
ハイブリッド検索:ベクトル+BM25+新しさによる再ランキング(rebuild_index) | -- | はい(Pro) |
製品間のドキュメントリンク(get_docs_for_session、session_link_doc) | -- | はい(LoreDocs Pro も必要) |
| チームメモリ:マシン間でセッションをエクスポート/統合 | -- | はい |
Anthropic 管理エージェント向けエクスポート(export_for_anthropic) | -- | はい |
get_tier で現在のプランと使用状況を確認できます。vault_set_tier で Pro ライセンスを有効にできます。
機能
- セッションの自動記録:Claude Code フックを使って、セッション終了時に保存し、開始時に読み込みます。手動で
save_sessionを呼び出す必要はありません - クライアント間のメモリ共有:コンテキストは Claude Code、Cowork、Cursor、Codex、Hermes 間で引き継がれ、特定の IDE やマシンに固定されません
- 構造化されたセッション:生のテキストだけでなく、意思決定、成果物、未解決の質問を記録します。オプションの
reasoning_notesフィールドには、エージェントの推論チェーンを保存できます - プロジェクトの整理:期待されるスキルセットを設定し、セッションをプロジェクトごとにグループ化できます
- スキルの追跡:スマートフィルタリング用に、使用したスキルを記録します
- ペルソナのタグ付け:エージェント固有のメモリ向けに、階層型ペルソナを設定できます(例:
ron-bot:sql) - 全文検索:SQLite FTS5 を使って、すべてのセッションをキーワードで高速検索できます
- MEMORY.md の自動インデックス作成:プロジェクトの MEMORY.md はセッション開始時に自動でインデックス化され、
search_sessionsで通常のセッションと併せて検索できます - LLM による非同期セッション要約(Pro):自動保存されたセッションは、Claude Haiku を使ってバックグラウンドで LLM 品質の要約に更新されます。
LORECONVO_ANTHROPIC_API_KEYを設定すると利用できます。日次上限(LORECONVO_SUMMARIZER_DAILY_CAP、既定値は 100)により、API の過剰な利用を防ぎます。Pro プラン限定です。 - 埋め込みベースの関連セッション検出(Pro):
get_related_sessionsは、BGE-small-en-v1.5 の埋め込み(cosine >= 0.75)を使って、内容が類似するセッションを自動で検出します。保存ごとに最大 10 件の双方向自動リンクを作成し、同じプロジェクト内に限定されます。Free プランではキーワードの共起に基づくリンクが利用できます。埋め込みリンクを無効にするには、LORECONVO_EMBEDDING_LINKS=0を設定します。 - 製品間のドキュメントリンク(Pro):各セッションに最も関連する LoreDocs のドキュメントを自動で検出してリンクし、その逆も行います。新しい 2 つのツール
get_docs_for_sessionとsession_link_docを使用します。LoreConvo Pro と LoreDocs Pro の両方が必要です。 - 設定可能なツールグループ:
configure_toolsツールまたはLORECONVO_TOOL_GROUPSを使って、アシスタントに表示するツールグループ(core、memory、graph、agents、admin)を選択できます。既定ではすべてのグループが有効です。ツールグループを参照してください。 - ローカル優先:SQLite データベースを使用し、クラウドへの依存や API コストはありません
プラン
無料 — 50 セッション
- すべての機能を利用できます:自動読み込み、全文検索、タグ付け、セッションのリンク、エクスポートとインポート
- ローカルの SQLite ストレージを使用します。データはお使いのマシンに保存され、クラウドアカウントは不要です
- Anthropic Marketplace からワンクリックでインストールできます
Pro — 月額 $8
- セッション数無制限
- チームメモリー:セッションをチームメイトと共有できます(ローカル優先の非同期エクスポート/インポート。サーバーは不要です)
- 関連セッションの検出とセマンティック検索
- Anthropic managed-agents へのエクスポート
- バックグラウンドでの LLM 品質のセッション要約(非同期)
チェックアウト後、ライセンスキーはチェックアウト時に使用したメールアドレスに自動で送信されます。通常、数分以内に届きます。お問い合わせ:[email protected]。
MCP ツール
LoreConvo は、セッション中に Claude が自動的に呼び出す MCP ツールを 40 個提供します。 以下の表は、最もよく使用されるツールを示しています。完全なリファレンスについては、MCP ツールカタログをご覧ください。
| ツール | 機能 |
|---|---|
save_session | 決定事項、成果物、タグを含むセッションの概要を保存します |
get_recent_sessions | 必要に応じてサーフェスで絞り込み、最近のセッションを一覧表示します |
get_session | ID を指定して特定のセッションを取得します |
search_sessions | 保存済みのすべてのセッションを全文検索します |
get_context_for | トピックに関連するコンテキストを取得します(「想起」の用途に最適です) |
tag_session | セッションにペルソナタグを追加します |
link_sessions | 関係の種類を指定して、関連するセッションをつなぎます |
get_related_sessions | 指定したセッションに関連するセッションを検索します |
create_project | 必要なスキルを指定して、名前付きのプロジェクトを作成します |
get_project | プロジェクトの詳細と関連するセッションを取得します |
list_projects | すべてのプロジェクトを一覧表示します |
get_skill_history | 特定のスキルを使用したセッションを確認します |
vault_suggest | 読み込むべき関連コンテキストを先回りして提案します |
get_tier | 現在のティアとライセンスキーの状態を確認します |
vault_set_tier | アクティブなティア(free または pro)を設定します |
export_sessions | セッションを移植可能な JSON 形式でエクスポートします |
import_sessions | 以前にエクスポートした JSON ファイルからセッションをインポートします |
consolidate_memories | 関連するセッションを永続的なメモリエントリーに統合します(Recall) |
get_memory_digest | 現在のセッションに簡潔なメモリダイジェストを挿入します(Recall) |
set_session_expiry | 指定した日付にセッションの期限が切れ、削除されるよう設定します |
get_stats | 使用状況の統計情報(セッション数、サーフェス別の内訳)を表示します |
inspect_sessions | デバッグ用にセッションの内部情報を確認します |
export_for_anthropic | Anthropic のマネージドエージェント形式でセッションをエクスポートします(Pro) |
rebuild_index | LanceDB のセマンティック検索インデックスを再構築します(Pro) |
rebuild_index_status | 進行中の rebuild_index 操作の状態を確認します(Pro) |
loreconvo_onboard | 初回セットアップウィザード |
get_dream_log | 統合作業のアクティビティログを表示します |
get_docs_for_session | 特定のセッションにリンクされた LoreDocs ドキュメントを取得します(Pro — LoreDocs Pro が必要です) |
session_link_doc | セッションと LoreDocs ドキュメントのリンクを手動で作成します(Pro — LoreDocs Pro が必要です) |
pin_session | セッションを固定または固定解除し、自動クリーンアップの対象外にします |
get_anti_patterns | アンチパターン(避けるべきアプローチ)としてタグ付けされたセッションを一覧表示します |
tag_as_anti_pattern | セッションをアンチパターンとしてタグ付けし、今後の想起で警告されるようにします |
untag_anti_pattern | セッションからアンチパターンタグを削除します |
save_memory_item | 決定事項、未解決の質問、成果物など、構造化されたメモリー項目を保存します |
query_memory_items | 種類、プロジェクト、ステータス、最近の項目で構造化されたメモリー項目を検索します |
transition_memory_item | メモリー項目のライフサイクル上の状態を変更します(retire、answer、wont-answer) |
update_memory_item | メモリー項目のタイトル、本文、タグ、メタデータを修正するか、別のプロジェクトに移動します |
configure_agent_context | 名前付きのトピック設定を保存または更新し、エージェントがセッション開始時に対象を絞ったコンテキストを自動読み込みできるようにします |
inject_agent_context | 保存済みまたは呼び出し時に指定したトピックを使って、エージェント向けの対象を絞ったセッションコンテキストを返します |
graph_session_map | セッションとそのリンクを示す Mermaid ナレッジグラフをエクスポートします |
要件
- Python 3.11+
- macOS または Linux
mcpとclick(install.shによって自動的にインストールされます)
データとプライバシー
LoreConvo はローカルファーストです。すべてのデータは、お使いのマシン上の ~/.loreconvo/sessions.db に保存されます。
- **収集するデータ:**セッションタイトル、要約、タグ、サーフェス識別子、プロジェクト名、および保存時に指定するスキル名です。テレメトリー、利用状況分析、識別子が自動的に収集されることはありません。
- 保存先:
~/.loreconvo/sessions.dbの SQLite データベースです。クラウドストレージは使用しません。LORECONVO_DB環境変数でパスを変更できます。 - **サードパーティとの共有:**デフォルトではありません。
LORECONVO_ANTHROPIC_API_KEYを設定してオプションの AI 要約を有効にした場合に限り、制限された文字起こしの抜粋または要約が、そのキーを使用して Anthropic API に送信されます。すべての要約処理(バックグラウンド要約(Pro)、ターン後のキャプチャ(Pro)、save_session(summarize=True))ではこのキーのみが使用され、汎用のANTHROPIC_API_KEYが読み取られることはありません。この変数を設定しなければ、すべてのデータはローカルに保存されます。 - 保持期間:
delete_sessionで削除するか、データベースファイルを手動で削除するまでデータは保持されます。自動的な有効期限はありません。 - **お問い合わせ先:**[email protected]
プライバシーポリシー全文:https://labyrinthanalyticsconsulting.com/privacy
トラブルシューティング
MCP ツールが Claude Code に表示されませんか?
最初に bash install.sh を実行したことを確認してください。依存関係がインストールされた .venv が必要です。
「No module named 'mcp'」エラーが表示されますか?
.mcp.json は、プラグインフォルダー内の .venv/bin/python3 を参照しています。フォルダーを移動した場合は、bash install.sh を再実行してください。
Cowork から Code で保存したセッションが見えませんか? Cowork が共有データベースにアクセスできるよう、Claude に「mount my ~/.loreconvo folder」と依頼してください。
フォールバックスクリプト(DB への直接アクセス)
MCP サーバーに接続できない場合(スケジュールタスクや自動化スクリプトなど)、scripts/save_to_loreconvo.py を使って SQLite データベースに直接、同じ主要操作を実行できます。
# Save a session
python scripts/save_to_loreconvo.py \
--title "Daily QA run" \
--surface "qa" \
--summary "Ran full test suite. All passing." \
--tags '["qa", "automated"]'
# Read recent sessions
python scripts/save_to_loreconvo.py --read --limit 5
# Filter by surface
python scripts/save_to_loreconvo.py --read --surface code --limit 3
# Search sessions
python scripts/save_to_loreconvo.py --search "tax pipeline"
このスクリプトは ~/.loreconvo/sessions.db のデータベースを自動検出します(または --db-path を明示的に指定してください)。適切な UUID を生成し、MCP の save_session ツールと同じスキーマで書き込みます。
新機能
v0.10.20(2026-10-26)
追加
- AI アシスタントに表示する LoreConvo ツールのグループを選択できるようになりました。
ツールの数が減ると、アシスタントのツール一覧がすっきりし、使用する
コンテキストも少なくなります。新しい
configure_toolsツール、LORECONVO_TOOL_GROUPS環境変数、または~/.loreconvo/config.jsonのtool_groups設定を使用してください。変更は再起動後に適用されます。デフォルトでは すべてのグループが有効なため、オプトインしない限り何も変わりません。
修正
- 異なるプロジェクトのセッション間に以前のバージョンが作成した関連セッションリンクは、初回起動時に自動的に削除されるようになりました。v0.10.19 でプロジェクトをまたぐ新しいリンクの作成は停止しており、今回は古いリンクを整理します。ご自身で作成したリンクには影響しません。対応は不要です。
- Hermes ユーザー向け:Hermes から呼び出すと以前は失敗していた LoreConvo ツールが、エクスポート、オンボーディング、アンチパターンのタグ付け、関連セッションの検索を含め、動作するようになりました。ツールが MCP サーバー経由でのみ利用可能な場合、Hermes がその旨を知らせるようになり、組み込みの指示も最新のツール名を使うようになりました。
- Pro:
LORECONVO_ANTHROPIC_API_KEYを設定している場合、バックグラウンドのセッション要約が実行されるようになりました。通常のインストールでセットアップしたデータベースでは一度も実行されておらず、セッションには簡易的なヒューリスティック要約が残っていました。Pro でこのキーを設定している場合(たとえばsummarize=Trueのときだけ設定する場合など)、LoreConvo は新しいセッションのテキストもバックグラウンドで Anthropic API に送信して要約を作成するようになります。デフォルトでは 1 日あたり最大 100 件です(LORECONVO_SUMMARIZER_DAILY_CAP)。すべてをローカルに保つには、キーの設定を解除してください。 - アシスタントが正常に終了すると、
~/.loreconvo/sessions.dbにすべてのセッションが個別に保存されるようになりました。そのため、この 1 つのファイルを別のマシンにコピーすれば、セッションも移行できます。以前は、MCP サーバー経由で保存したセッションがサイドファイル(sessions.db-wal)に残る場合があり、sessions.dbだけをコピーすると空の状態で移行されることがありました。LoreConvo の実行中、または強制終了した場合は、sessions.db-walファイルもコピーしてください。 - Python のフォールバック用スクリプトが MCP ツールにより近い動作をするようになりました。
--searchと--readは、デフォルトで外部ツールのセッションと期限切れのセッションを非表示にします(--searchで表示するには、--include-externalまたは--include-expiredを追加してください)。--projectは--searchと--readを実際に絞り込むようになりました(以前は引数として受け付けるだけで無視されていました。--inspectでは代わりにエラーを返すようになりました)。--expires-at clearで有効期限を解除できるようになり、セッション保存フックが失敗していることを示す記録もスクリプトが消去しなくなりました。 python -m loreconvo.cli statsで、get_statsツールと同様に、フックの保存が失敗しているかどうかを確認できるようになりました。
変更
- LoreConvo の実行には Python 3.11 以降が必要になりました。 Python 3.10 は今月サポート終了となり、以下のセキュリティ修正には 3.11 が必要です。Python 3.10 をお使いの場合は、Python をアップグレードするまで v0.10.19 をお使いください。
- 自動要約(
summarize=Trueを指定したsave_session)とターンの記録には、LORECONVO_ANTHROPIC_API_KEYのみを使用するようになりました。以前のバージョンでは、ほかのツール用に設定された一般的なANTHROPIC_API_KEYも使用されることがあり、LoreConvo で設定していない場合でもセッションのテキストが Anthropic API に送信される可能性がありました。**どちらかの機能を使う場合は、LORECONVO_ANTHROPIC_API_KEYを設定してください。**設定しなければ、LoreConvo はローカルのみで動作します。
セキュリティ
- 埋め込みライブラリと、画像処理の依存関係である Pillow を、公開済みの 37 件の脆弱性を修正したバージョンに更新しました。LoreConvo はテキストのみを埋め込むため、影響を受ける画像処理コードは使われていませんでしたが、ライブラリ自体は読み込まれていました。
完全なリリース履歴については、変更履歴をご覧ください。
ライセンス
Business Source License 1.1 (BSL 1.1) - Labyrinth Analytics Consulting
個人利用/非商用利用は無料です(最大 50 セッション)。商用利用には有料ライセンスが必要です。2030-03-31 に Apache 2.0 に切り替わります。詳細は LICENSE をご覧ください。
mcp-name: io.github.labyrinth-analytics/loreconvo
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。