mcpField
A
agentmemory-hooks

agentmemory-hooks

github.com/rohitg00エージェントワークフロー30.0k10.9k 回インストール今日更新
リポジトリ

agentmemory-hooks について

agentmemory のライフサイクルフックを説明するスキルです。エージェントのセッションから観察内容を自動記録する仕組み、対応環境での設定、取得イベントや関連オプションを紹介します。

主な機能

  1. 01セッション観察内容の自動取得
  2. 02ツール使用とプロンプトの取得
  3. 03セッション境界と引き継ぎの対応
  4. 04圧縮前のコンテキスト保持
  5. 05コミットとセッションの関連付け

活用シーン

  1. 01手動保存なしでエージェントの活動を記録
  2. 02圧縮前のコンテキスト保持
  3. 03ビューアーで取得内容を確認

MCP 対応

MCP の設定だけでは自動取得は有効になりません。取得はフックまたはネイティブ連携が担い、一部の設定コマンドは MCP 接続も行います。

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/rohitg00/agentmemory --skill agentmemory-hooks

インストール後、Claude Code で/agentmemory-hooksを入力して読み込まれたか確認します。

同梱ファイルREFERENCE.mdTROUBLESHOOTING.md

詳細

agentmemory プラグインはライフサイクルフックを登録し、メモリを自動的に記録します。通常の作業で memory_save を呼び出す必要はありません。フックがツールの使用、プロンプト、セッションの境界を監視し、代わりに観察内容を書き込みます。

クイックスタート

Claude Code の場合は、プラグインをインストールします。

/plugin marketplace add rohitg00/agentmemory
/plugin install agentmemory

Devin CLI と Devin Desktop の場合は、プラグインをインストールして新しいセッションを開始します。

devin plugins install rohitg00/agentmemory#plugin

Devin 内で /hooks を実行し、agentmemory フックが読み込まれていることを確認します。プラグインフックはローカルの Devin セッションでのみ実行され、クラウドセッションでは実行されません。

Pi と OMP では、agentmemory connect pi --with-mcp または agentmemory connect omp --with-mcp でネイティブの想起と記録をインストールします。Pi を再読み込みするか OMP を再起動してから、/agentmemory-status を確認します。DSH では agentmemory connect dsh --with-hooks と再起動が必要です。Cursor のライフサイクルフックは、有効化されたプラグインによって提供されます。これは connect cursor の MCP 設定とは別です。

Hermes と OpenClaw は、ネイティブ統合とそれぞれのライフサイクル仕様を使用します。対応する統合の設定手順に従い、実際のターンによって観察内容が作成されることを確認してください。共有スキルをインストールしたり MCP に接続したりするだけでは、自動記録は有効になりません。デフォルトのポートを使用している場合は、http://localhost:3113 のビューアーで記録された観察内容を確認します。記録待ちキューがあるだけでは、デーモンにイベントが保存された証拠にはなりません。

フックの動作

  • セッションの開始と終了で各作業単位を区切り、handoff による再開を可能にします。
  • ツール使用フックは、何が変わったのか、なぜ変わったのかを記録します。これは recall と recap の基礎となる情報です。
  • プロンプト送信フックは意図を記録します。コンパクト化前フックは、ホストがコンテキストを短縮する前にコンテキストを保持します。
  • コミット後フックはコミットをセッションに関連付けます。これにより commit-context と commit-history が機能します。

重要

  • プラグインフックはデフォルトで、LLM を使わずに記録します。観察ごとの LLM 圧縮（AGENTMEMORY_AUTO_COMPRESS）とフックによるコンテキスト注入（AGENTMEMORY_INJECT_CONTEXT）は、それぞれ独立したオプションです。セッションの要約では、自動的な観察内容の圧縮とは別に、設定済みの LLM プロバイダーを使用できます。ネイティブ統合にはそれぞれ独自の想起・記録設定があります。すべてのプラグインがこれらのフラグで制御されると決めつけず、ホストの設定を確認してください。
  • 観察内容が見つからない場合は、プラグインが有効になっていて、サーバーが実行中であることを確認してください。TROUBLESHOOTING.md を参照してください。

関連項目

  • agentmemory-config では、記録と注入のフラグを設定できます。
  • handoff、recap、session-history の各スキルは、これらのフックが記録した内容を使用します。

リファレンス

登録されているフックイベントの詳細は、plugin/hooks/hooks.json から生成された REFERENCE.md に記載されています。

コメント

Markdown 対応