rohitg00/agentmemory

agentmemory-hooks

The agentmemory plugin hooks that capture observations automatically across the agent session lifecycle.

ソースを見る

使い方

  1. インストールコマンドをコピーし、自分の環境へ導入する前にソースを確認します。
  2. 必要なツール、認証情報、対応環境を原文で確認します。
  3. 入力と成果物を指定し、出力を資料と照合します。
npx skills add https://github.com/rohitg00/agentmemory --skill agentmemory-hooks

開始前の確認

  • 導入にはモデル契約、API枠、ファイルへのアクセス許可は含まれません。
  • スター数や導入数は活動の指標であり、独立した品質・安全性試験ではありません。
リポジトリの原文

見出し、例、コード、表、リンク、参照画像を含む原文を表示しています。

The agentmemory plugin registers lifecycle hooks so memory is captured automatically. You do not have to call memory_save for routine work; the hooks observe tool use, prompts, and session boundaries and write observations for you.

Quick start

For Claude Code, install its plugin:

bash
/plugin marketplace add rohitg00/agentmemory
/plugin install agentmemory

For Devin CLI and Devin Desktop, install the plugin and start a new session:

bash
devin plugins install rohitg00/agentmemory#plugin

Run /hooks inside Devin to confirm the agentmemory hooks are loaded. Plugin hooks run only in local Devin sessions, not in cloud sessions.

Pi and OMP install native recall and capture with agentmemory connect pi --with-mcp or agentmemory connect omp --with-mcp. Reload Pi or restart OMP, then inspect /agentmemory-status. DSH requires agentmemory connect dsh --with-hooks and a restart. Cursor lifecycle hooks come from its enabled plugin, separately from connect cursor's MCP setup.

Hermes and OpenClaw use their native integrations and lifecycle contracts. Follow the matching integration setup instructions and verify a real turn creates an observation. Installing shared skills or connecting MCP alone does not enable automatic capture. Watch recorded observations in the viewer at http://localhost:3113 when using the default port. A pending capture queue is not proof that the daemon stored the event.

What the hooks record

The Claude Code plugin registers 12 hooks. They send what they record to the local agentmemory server, which stores it on this machine.

  • SessionStart and SessionEnd frame each unit of work and let handoff resume it. SessionEnd also reads the host transcript file to recover user prompts that a hook missed.
  • UserPromptSubmit records each prompt you type.
  • PostToolUse and PostToolUseFailure record the tool name, its input, and its output or error. This includes results returned by other connectors and MCP servers. Long output is truncated and <private> blocks and common secret formats are redacted before storage.
  • PreToolUse does nothing by default. With AGENTMEMORY_INJECT_CONTEXT=true it sends the file paths and search patterns from a tool's input to look up related memory and prints what it finds.
  • Stop and SubagentStop record the final assistant reply (up to 4,000 characters). SubagentStart, Notification and TaskCompleted record those events.
  • PreCompact syncs memory before the host trims context.

If the server is unreachable, events wait in a local capture spool (at most 5 MiB, kept up to 7 days) and are sent when it comes back.

The plugin does not register a git post-commit hook, so commits are linked to sessions only when another integration records them.

Important

  • The plugin hooks capture without an LLM. Nothing they record goes to an outside AI provider unless AGENTMEMORY_LLM_PROVIDER or a cloud EMBEDDING_PROVIDER is set on the server. Per-observation LLM compression also needs AGENTMEMORY_AUTO_COMPRESS=true.
  • Hook context injection is off by default. SessionStart, PreToolUse and PreCompact print stored memory into the conversation only with AGENTMEMORY_INJECT_CONTEXT=true.
  • Hooks send the server secret only to a loopback URL or an https:// URL. Native integrations have their own recall/capture settings; inspect the host configuration instead of assuming these flags control every plugin.
  • If observations are missing, confirm the plugin is enabled and the server is running. See TROUBLESHOOTING.md.

See also

  • agentmemory-config for the capture and injection flags.
  • The handoff, recap, and session-history skills consume what these hooks record.

Reference

The exact registered hook events live in REFERENCE.md, generated from plugin/hooks/hooks.json.

同じリポジトリから

関連する Skills

すべての Skills
rohitg00
コミュニティ

agentmemory-agents

How agentmemory wires into host coding agents via the connect command. Use when installing agentmemory into a specific agent, when asked which agents are supported, or when a connect adapter writes the wrong config path.

1時間の導入数
1
GitHub Stars
3万
更新日
11月18日
rohitg00
コミュニティ

agentmemory-architecture

How agentmemory is built, the iii engine primitives it runs on, its storage model, ports, and the viewer. Use when reasoning about how memory is stored or retrieved end to end, when extending the system, or when answering how agentmemory works under the hood.

1時間の導入数
1
GitHub Stars
3万
更新日
11月18日
rohitg00
コミュニティ

agentmemory-config

Set up and diagnose local agentmemory, including MCP, environment variables, ports, and feature flags. Use when getting started, checking a connection, enabling a feature, configuring auth, or explaining why a feature is off by default.

1時間の導入数
1
GitHub Stars
3万
更新日
11月18日
rohitg00
コミュニティ

agentmemory-mcp-tools

Map of every agentmemory MCP tool, what each does, and its parameters. Use when choosing which memory tool to call, when a tool name or argument is unclear, or when answering what agentmemory can do via MCP.

1時間の導入数
1
GitHub Stars
3万
更新日
11月18日