mcpField
A
agentmemory-hooks

agentmemory-hooks

github.com/rohitg00Agent workflows30.0k10.9k installsUpdated today
Repository

About agentmemory-hooks

A skill describing agentmemory lifecycle hooks that automatically record observations from agent sessions. It covers setup across supported agent environments and explains capture events and related options.

Key features

  1. 01Automatic session observation capture
  2. 02Tool-use and prompt capture
  3. 03Session boundary and handoff support
  4. 04Pre-compact context preservation
  5. 05Commit-to-session linking

Use cases

  1. 01Record agent activity without manual saves
  2. 02Preserve context before compaction
  3. 03Review captured observations in the viewer

MCP support

MCP setup alone does not enable automatic capture; hooks or native integrations provide capture. Some setup commands shown also connect MCP.

Install

Copy the command and run it in a terminal.

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

After installing, type/agentmemory-hooksin Claude Code to confirm it loaded.

Bundled filesREFERENCE.mdTROUBLESHOOTING.md

Details

From the project README

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:

/plugin marketplace add rohitg00/agentmemory
/plugin install agentmemory

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

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 do

  • Session start and end frame each unit of work and let handoff resume it.
  • Tool-use hooks capture what changed and why, the raw material for recall and recap.
  • Prompt-submit captures intent. Pre-compact preserves context before the host trims it.
  • A post-commit hook links commits to sessions, which powers commit-context and commit-history.

Important

  • The plugin hooks capture by default without an LLM. Per-observation LLM compression (AGENTMEMORY_AUTO_COMPRESS) and hook context injection (AGENTMEMORY_INJECT_CONTEXT) are separate options. Session summaries can use a configured LLM provider independently of automatic observation compression. 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.

Comments

Markdown supported