Agentmemory Hooks

by rohitg00007a1a7fe864No license29K starsListed Oct 8, 2026Updated Oct 8, 2026Repository updated today

The agentmemory plugin hooks that capture observations automatically across the agent session lifecycle. Use when explaining how memory gets captured without manual saves, when debugging missing observations, or when tuning what gets recorded.

Instructions onlyAI & Agents
AI-generated overview

Explains the agentmemory plugin's lifecycle hooks that capture agent session observations automatically.

What it does
This is a reference document describing how the agentmemory Claude Code plugin registers lifecycle hooks so observations are captured automatically without manual saves. It covers session start and end framing, tool-use capture, prompt-submit intent capture, pre-compact context preservation, and a post-commit hook linking commits to sessions. It also notes that capture is on by default and zero-LLM, while LLM summarization and context injection are separate opt-ins, and points to troubleshooting and related skills.
When to use it
Use it when explaining how memory gets captured without manual saves, when debugging missing observations, or when tuning what gets recorded.
Requirements
Requires the agentmemory Claude Code plugin to be installed and its server running; the document references a local server address and a shared troubleshooting file.

The Claude Code 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

Install the plugin and the hooks register themselves:

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

Watch observations land live at http://localhost:3113.

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

  • Capture is on by default and is zero-LLM. Turning observations into LLM summaries (AGENTMEMORY_AUTO_COMPRESS) and injecting them back into context (AGENTMEMORY_INJECT_CONTEXT) are separate opt-ins because they spend tokens.
  • If observations are missing, confirm the plugin is enabled and the server is running. See ../_shared/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.

Source and attribution

Source:rohitg00/agentmemoryinplugin/skills/agentmemory-hooksat commit007a1a7

License: No license

Content belongs to its original authors. SourceWeft indexes it from a public repository.

Report or request removal