사용 방법
- 설치 명령을 복사하고 자신의 에이전트 환경에 설치하기 전에 소스 패키지를 확인하세요.
- 필요한 도구, 인증 정보, 지원 환경은 원본 문서에서 확인하세요.
- 입력과 원하는 산출물을 설명하고 출처와 결과를 대조하세요.
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:
/plugin marketplace add rohitg00/agentmemory
/plugin install agentmemoryFor Devin CLI and Devin Desktop, install the plugin and start a new session:
devin plugins install rohitg00/agentmemory#pluginRun /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
handoffresume 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=trueit 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_PROVIDERor a cloudEMBEDDING_PROVIDERis set on the server. Per-observation LLM compression also needsAGENTMEMORY_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.