@agentmemory/agentmemory 0.9.30 → 0.9.31
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.env.example +39 -33
- package/AGENTS.md +8 -8
- package/README.md +173 -558
- package/dist/.env.example +39 -33
- package/dist/cli.d.mts.map +1 -1
- package/dist/cli.mjs +1741 -966
- package/dist/cli.mjs.map +1 -1
- package/dist/compression-recovery-CnhLQC6N.mjs +5912 -0
- package/dist/compression-recovery-CnhLQC6N.mjs.map +1 -0
- package/dist/{connect-B4_ca6BD.mjs → connect-BSLIAMpw.mjs} +874 -267
- package/dist/connect-BSLIAMpw.mjs.map +1 -0
- package/dist/hooks/_capture.d.mts +5 -2
- package/dist/hooks/_capture.d.mts.map +1 -1
- package/dist/hooks/_capture.mjs +55 -19
- package/dist/hooks/_capture.mjs.map +1 -1
- package/dist/hooks/notification.mjs +20 -6
- package/dist/hooks/notification.mjs.map +1 -1
- package/dist/hooks/post-commit.mjs +25 -5
- package/dist/hooks/post-commit.mjs.map +1 -1
- package/dist/hooks/post-tool-failure.mjs +12 -4
- package/dist/hooks/post-tool-failure.mjs.map +1 -1
- package/dist/hooks/post-tool-use.mjs +12 -4
- package/dist/hooks/post-tool-use.mjs.map +1 -1
- package/dist/hooks/pre-compact.mjs +37 -10
- package/dist/hooks/pre-compact.mjs.map +1 -1
- package/dist/hooks/pre-tool-use.mjs +25 -5
- package/dist/hooks/pre-tool-use.mjs.map +1 -1
- package/dist/hooks/prompt-submit.mjs +12 -4
- package/dist/hooks/prompt-submit.mjs.map +1 -1
- package/dist/hooks/session-end.mjs +47 -16
- package/dist/hooks/session-end.mjs.map +1 -1
- package/dist/hooks/session-start.mjs +37 -10
- package/dist/hooks/session-start.mjs.map +1 -1
- package/dist/hooks/stop.mjs +74 -72
- package/dist/hooks/stop.mjs.map +1 -1
- package/dist/hooks/subagent-start.mjs +13 -5
- package/dist/hooks/subagent-start.mjs.map +1 -1
- package/dist/hooks/subagent-stop.mjs +18 -6
- package/dist/hooks/subagent-stop.mjs.map +1 -1
- package/dist/hooks/task-completed.mjs +13 -5
- package/dist/hooks/task-completed.mjs.map +1 -1
- package/dist/{image-refs-T_urbwHM.mjs → image-refs-Cyta4Lf9.mjs} +2 -2
- package/dist/{image-refs-T_urbwHM.mjs.map → image-refs-Cyta4Lf9.mjs.map} +1 -1
- package/dist/index.mjs +8539 -4203
- package/dist/index.mjs.map +1 -1
- package/dist/integrations/dsh.d.mts +55 -0
- package/dist/integrations/dsh.d.mts.map +1 -0
- package/dist/integrations/dsh.mjs +1145 -0
- package/dist/integrations/dsh.mjs.map +1 -0
- package/dist/{keyed-mutex-DchXsyfP.mjs → keyed-mutex-DCUh7PG-.mjs} +58 -9
- package/dist/keyed-mutex-DCUh7PG-.mjs.map +1 -0
- package/dist/{secret-store-BnY3A50C.mjs → secret-store-D9GwO0xp.mjs} +535 -434
- package/dist/secret-store-D9GwO0xp.mjs.map +1 -0
- package/dist/session-arguments-zxsbbd8y.mjs +113 -0
- package/dist/session-arguments-zxsbbd8y.mjs.map +1 -0
- package/dist/{src-Jsq9LCeH.mjs → src-DaMtDzt_.mjs} +4087 -3788
- package/dist/src-DaMtDzt_.mjs.map +1 -0
- package/dist/{standalone-DKCdrf1d.mjs → standalone-BlqshyZ5.mjs} +213 -56
- package/dist/standalone-BlqshyZ5.mjs.map +1 -0
- package/dist/standalone.d.mts +1 -1
- package/dist/standalone.d.mts.map +1 -1
- package/dist/standalone.mjs +626 -73
- package/dist/standalone.mjs.map +1 -1
- package/dist/viewer/index.html +288 -140
- package/integrations/hermes/README.md +84 -0
- package/integrations/hermes/__init__.py +669 -0
- package/integrations/hermes/plugin.yaml +27 -0
- package/integrations/omp/LICENSE +190 -0
- package/integrations/omp/README.md +76 -0
- package/integrations/omp/capture.ts +1 -0
- package/integrations/omp/dist/index.mjs +1450 -0
- package/integrations/omp/index.ts +488 -0
- package/integrations/omp/package.json +13 -0
- package/integrations/omp/security.ts +67 -0
- package/integrations/omp/skills/agentmemory-agents/REFERENCE.md +32 -0
- package/integrations/omp/skills/agentmemory-agents/SKILL.md +48 -0
- package/integrations/omp/skills/agentmemory-agents/TROUBLESHOOTING.md +70 -0
- package/integrations/omp/skills/agentmemory-architecture/SKILL.md +33 -0
- package/integrations/omp/skills/agentmemory-architecture/TROUBLESHOOTING.md +70 -0
- package/integrations/omp/skills/agentmemory-config/REFERENCE.md +90 -0
- package/integrations/omp/skills/agentmemory-config/SKILL.md +78 -0
- package/integrations/omp/skills/agentmemory-config/TROUBLESHOOTING.md +70 -0
- package/integrations/omp/skills/agentmemory-hooks/REFERENCE.md +20 -0
- package/integrations/omp/skills/agentmemory-hooks/SKILL.md +49 -0
- package/integrations/omp/skills/agentmemory-hooks/TROUBLESHOOTING.md +70 -0
- package/integrations/omp/skills/agentmemory-mcp-tools/REFERENCE.md +66 -0
- package/integrations/omp/skills/agentmemory-mcp-tools/SKILL.md +42 -0
- package/integrations/omp/skills/agentmemory-mcp-tools/TROUBLESHOOTING.md +70 -0
- package/integrations/omp/skills/agentmemory-rest-api/REFERENCE.md +158 -0
- package/integrations/omp/skills/agentmemory-rest-api/SKILL.md +49 -0
- package/integrations/omp/skills/agentmemory-rest-api/TROUBLESHOOTING.md +70 -0
- package/integrations/omp/skills/commit-context/EXAMPLES.md +71 -0
- package/integrations/omp/skills/commit-context/SKILL.md +64 -0
- package/integrations/omp/skills/commit-context/TROUBLESHOOTING.md +70 -0
- package/integrations/omp/skills/commit-history/EXAMPLES.md +71 -0
- package/integrations/omp/skills/commit-history/SKILL.md +62 -0
- package/integrations/omp/skills/commit-history/TROUBLESHOOTING.md +70 -0
- package/integrations/omp/skills/forget/EXAMPLES.md +40 -0
- package/integrations/omp/skills/forget/SKILL.md +73 -0
- package/integrations/omp/skills/forget/TROUBLESHOOTING.md +70 -0
- package/integrations/omp/skills/handoff/EXAMPLES.md +57 -0
- package/integrations/omp/skills/handoff/SKILL.md +75 -0
- package/integrations/omp/skills/handoff/TROUBLESHOOTING.md +70 -0
- package/integrations/omp/skills/lesson/SKILL.md +64 -0
- package/integrations/omp/skills/lesson/TROUBLESHOOTING.md +70 -0
- package/integrations/omp/skills/memory-discipline/SKILL.md +65 -0
- package/integrations/omp/skills/memory-discipline/TROUBLESHOOTING.md +70 -0
- package/integrations/omp/skills/recall/EXAMPLES.md +74 -0
- package/integrations/omp/skills/recall/SKILL.md +74 -0
- package/integrations/omp/skills/recall/TROUBLESHOOTING.md +70 -0
- package/integrations/omp/skills/recap/EXAMPLES.md +62 -0
- package/integrations/omp/skills/recap/SKILL.md +68 -0
- package/integrations/omp/skills/recap/TROUBLESHOOTING.md +70 -0
- package/integrations/omp/skills/remember/EXAMPLES.md +67 -0
- package/integrations/omp/skills/remember/SKILL.md +66 -0
- package/integrations/omp/skills/remember/TROUBLESHOOTING.md +70 -0
- package/integrations/omp/skills/session-history/EXAMPLES.md +59 -0
- package/integrations/omp/skills/session-history/SKILL.md +67 -0
- package/integrations/omp/skills/session-history/TROUBLESHOOTING.md +70 -0
- package/integrations/omp/skills/write-agentmemory-skill/SKILL.md +41 -0
- package/integrations/omp/skills/write-agentmemory-skill/TROUBLESHOOTING.md +70 -0
- package/integrations/openclaw/LICENSE +190 -0
- package/integrations/openclaw/README.md +88 -0
- package/integrations/openclaw/openclaw.plugin.json +71 -0
- package/integrations/openclaw/package.json +38 -0
- package/integrations/openclaw/plugin.mjs +425 -0
- package/integrations/openclaw/plugin.yaml +26 -0
- package/integrations/openclaw/skills/agentmemory-agents/REFERENCE.md +32 -0
- package/integrations/openclaw/skills/agentmemory-agents/SKILL.md +48 -0
- package/integrations/openclaw/skills/agentmemory-agents/TROUBLESHOOTING.md +70 -0
- package/integrations/openclaw/skills/agentmemory-architecture/SKILL.md +33 -0
- package/integrations/openclaw/skills/agentmemory-architecture/TROUBLESHOOTING.md +70 -0
- package/integrations/openclaw/skills/agentmemory-config/REFERENCE.md +90 -0
- package/integrations/openclaw/skills/agentmemory-config/SKILL.md +78 -0
- package/integrations/openclaw/skills/agentmemory-config/TROUBLESHOOTING.md +70 -0
- package/integrations/openclaw/skills/agentmemory-hooks/REFERENCE.md +20 -0
- package/integrations/openclaw/skills/agentmemory-hooks/SKILL.md +49 -0
- package/integrations/openclaw/skills/agentmemory-hooks/TROUBLESHOOTING.md +70 -0
- package/integrations/openclaw/skills/agentmemory-mcp-tools/REFERENCE.md +66 -0
- package/integrations/openclaw/skills/agentmemory-mcp-tools/SKILL.md +42 -0
- package/integrations/openclaw/skills/agentmemory-mcp-tools/TROUBLESHOOTING.md +70 -0
- package/integrations/openclaw/skills/agentmemory-rest-api/REFERENCE.md +158 -0
- package/integrations/openclaw/skills/agentmemory-rest-api/SKILL.md +49 -0
- package/integrations/openclaw/skills/agentmemory-rest-api/TROUBLESHOOTING.md +70 -0
- package/integrations/openclaw/skills/commit-context/EXAMPLES.md +71 -0
- package/integrations/openclaw/skills/commit-context/SKILL.md +64 -0
- package/integrations/openclaw/skills/commit-context/TROUBLESHOOTING.md +70 -0
- package/integrations/openclaw/skills/commit-history/EXAMPLES.md +71 -0
- package/integrations/openclaw/skills/commit-history/SKILL.md +62 -0
- package/integrations/openclaw/skills/commit-history/TROUBLESHOOTING.md +70 -0
- package/integrations/openclaw/skills/forget/EXAMPLES.md +40 -0
- package/integrations/openclaw/skills/forget/SKILL.md +73 -0
- package/integrations/openclaw/skills/forget/TROUBLESHOOTING.md +70 -0
- package/integrations/openclaw/skills/handoff/EXAMPLES.md +57 -0
- package/integrations/openclaw/skills/handoff/SKILL.md +75 -0
- package/integrations/openclaw/skills/handoff/TROUBLESHOOTING.md +70 -0
- package/integrations/openclaw/skills/lesson/SKILL.md +64 -0
- package/integrations/openclaw/skills/lesson/TROUBLESHOOTING.md +70 -0
- package/integrations/openclaw/skills/memory-discipline/SKILL.md +65 -0
- package/integrations/openclaw/skills/memory-discipline/TROUBLESHOOTING.md +70 -0
- package/integrations/openclaw/skills/recall/EXAMPLES.md +74 -0
- package/integrations/openclaw/skills/recall/SKILL.md +74 -0
- package/integrations/openclaw/skills/recall/TROUBLESHOOTING.md +70 -0
- package/integrations/openclaw/skills/recap/EXAMPLES.md +62 -0
- package/integrations/openclaw/skills/recap/SKILL.md +68 -0
- package/integrations/openclaw/skills/recap/TROUBLESHOOTING.md +70 -0
- package/integrations/openclaw/skills/remember/EXAMPLES.md +67 -0
- package/integrations/openclaw/skills/remember/SKILL.md +66 -0
- package/integrations/openclaw/skills/remember/TROUBLESHOOTING.md +70 -0
- package/integrations/openclaw/skills/session-history/EXAMPLES.md +59 -0
- package/integrations/openclaw/skills/session-history/SKILL.md +67 -0
- package/integrations/openclaw/skills/session-history/TROUBLESHOOTING.md +70 -0
- package/integrations/openclaw/skills/write-agentmemory-skill/SKILL.md +41 -0
- package/integrations/openclaw/skills/write-agentmemory-skill/TROUBLESHOOTING.md +70 -0
- package/integrations/pi/LICENSE +190 -0
- package/integrations/pi/README.md +45 -51
- package/integrations/pi/dist/index.mjs +1379 -0
- package/integrations/pi/index.ts +138 -171
- package/integrations/pi/package.json +16 -6
- package/integrations/pi/security.ts +6 -26
- package/integrations/pi/skills/agentmemory-agents/REFERENCE.md +32 -0
- package/integrations/pi/skills/agentmemory-agents/SKILL.md +48 -0
- package/integrations/pi/skills/agentmemory-agents/TROUBLESHOOTING.md +70 -0
- package/integrations/pi/skills/agentmemory-architecture/SKILL.md +33 -0
- package/integrations/pi/skills/agentmemory-architecture/TROUBLESHOOTING.md +70 -0
- package/integrations/pi/skills/agentmemory-config/REFERENCE.md +90 -0
- package/integrations/pi/skills/agentmemory-config/SKILL.md +78 -0
- package/integrations/pi/skills/agentmemory-config/TROUBLESHOOTING.md +70 -0
- package/integrations/pi/skills/agentmemory-hooks/REFERENCE.md +20 -0
- package/integrations/pi/skills/agentmemory-hooks/SKILL.md +49 -0
- package/integrations/pi/skills/agentmemory-hooks/TROUBLESHOOTING.md +70 -0
- package/integrations/pi/skills/agentmemory-mcp-tools/REFERENCE.md +66 -0
- package/integrations/pi/skills/agentmemory-mcp-tools/SKILL.md +42 -0
- package/integrations/pi/skills/agentmemory-mcp-tools/TROUBLESHOOTING.md +70 -0
- package/integrations/pi/skills/agentmemory-rest-api/REFERENCE.md +158 -0
- package/integrations/pi/skills/agentmemory-rest-api/SKILL.md +49 -0
- package/integrations/pi/skills/agentmemory-rest-api/TROUBLESHOOTING.md +70 -0
- package/integrations/pi/skills/commit-context/EXAMPLES.md +71 -0
- package/integrations/pi/skills/commit-context/SKILL.md +64 -0
- package/integrations/pi/skills/commit-context/TROUBLESHOOTING.md +70 -0
- package/integrations/pi/skills/commit-history/EXAMPLES.md +71 -0
- package/integrations/pi/skills/commit-history/SKILL.md +62 -0
- package/integrations/pi/skills/commit-history/TROUBLESHOOTING.md +70 -0
- package/integrations/pi/skills/forget/EXAMPLES.md +40 -0
- package/integrations/pi/skills/forget/SKILL.md +73 -0
- package/integrations/pi/skills/forget/TROUBLESHOOTING.md +70 -0
- package/integrations/pi/skills/handoff/EXAMPLES.md +57 -0
- package/integrations/pi/skills/handoff/SKILL.md +75 -0
- package/integrations/pi/skills/handoff/TROUBLESHOOTING.md +70 -0
- package/integrations/pi/skills/lesson/SKILL.md +64 -0
- package/integrations/pi/skills/lesson/TROUBLESHOOTING.md +70 -0
- package/integrations/pi/skills/memory-discipline/SKILL.md +65 -0
- package/integrations/pi/skills/memory-discipline/TROUBLESHOOTING.md +70 -0
- package/integrations/pi/skills/recall/EXAMPLES.md +74 -0
- package/integrations/pi/skills/recall/SKILL.md +74 -0
- package/integrations/pi/skills/recall/TROUBLESHOOTING.md +70 -0
- package/integrations/pi/skills/recap/EXAMPLES.md +62 -0
- package/integrations/pi/skills/recap/SKILL.md +68 -0
- package/integrations/pi/skills/recap/TROUBLESHOOTING.md +70 -0
- package/integrations/pi/skills/remember/EXAMPLES.md +67 -0
- package/integrations/pi/skills/remember/SKILL.md +66 -0
- package/integrations/pi/skills/remember/TROUBLESHOOTING.md +70 -0
- package/integrations/pi/skills/session-history/EXAMPLES.md +59 -0
- package/integrations/pi/skills/session-history/SKILL.md +67 -0
- package/integrations/pi/skills/session-history/TROUBLESHOOTING.md +70 -0
- package/integrations/pi/skills/write-agentmemory-skill/SKILL.md +41 -0
- package/integrations/pi/skills/write-agentmemory-skill/TROUBLESHOOTING.md +70 -0
- package/package.json +32 -11
- package/plugin/.claude-plugin/plugin.json +1 -1
- package/plugin/.codex-plugin/plugin.json +4 -3
- package/plugin/.devin-plugin/plugin.json +5 -3
- package/plugin/cursor/hooks.json +23 -8
- package/plugin/hooks.json +67 -0
- package/plugin/opencode/README.md +1 -1
- package/plugin/opencode/agentmemory-capture.ts +25 -11
- package/plugin/opencode/plugin.json +1 -1
- package/plugin/plugin.json +1 -1
- package/plugin/scripts/_capture.d.mts +5 -2
- package/plugin/scripts/_capture.d.mts.map +1 -1
- package/plugin/scripts/_capture.mjs +55 -19
- package/plugin/scripts/_capture.mjs.map +1 -1
- package/plugin/scripts/cursor/run-detached.d.mts +1 -0
- package/plugin/scripts/cursor/run-detached.mjs +786 -0
- package/plugin/scripts/cursor/run-detached.mjs.map +1 -0
- package/plugin/scripts/cursor/run-hook.d.mts +1 -0
- package/plugin/scripts/cursor/run-hook.mjs +704 -0
- package/plugin/scripts/cursor/run-hook.mjs.map +1 -0
- package/plugin/scripts/notification.mjs +20 -6
- package/plugin/scripts/notification.mjs.map +1 -1
- package/plugin/scripts/plugin-bridge.mjs +37 -6
- package/plugin/scripts/post-commit.mjs +25 -5
- package/plugin/scripts/post-commit.mjs.map +1 -1
- package/plugin/scripts/post-tool-failure.mjs +12 -4
- package/plugin/scripts/post-tool-failure.mjs.map +1 -1
- package/plugin/scripts/post-tool-use.mjs +12 -4
- package/plugin/scripts/post-tool-use.mjs.map +1 -1
- package/plugin/scripts/pre-compact.mjs +37 -10
- package/plugin/scripts/pre-compact.mjs.map +1 -1
- package/plugin/scripts/pre-tool-use.mjs +25 -5
- package/plugin/scripts/pre-tool-use.mjs.map +1 -1
- package/plugin/scripts/prompt-submit.mjs +12 -4
- package/plugin/scripts/prompt-submit.mjs.map +1 -1
- package/plugin/scripts/session-end.mjs +47 -16
- package/plugin/scripts/session-end.mjs.map +1 -1
- package/plugin/scripts/session-start.mjs +37 -10
- package/plugin/scripts/session-start.mjs.map +1 -1
- package/plugin/scripts/stop.mjs +74 -72
- package/plugin/scripts/stop.mjs.map +1 -1
- package/plugin/scripts/subagent-start.mjs +13 -5
- package/plugin/scripts/subagent-start.mjs.map +1 -1
- package/plugin/scripts/subagent-stop.mjs +18 -6
- package/plugin/scripts/subagent-stop.mjs.map +1 -1
- package/plugin/scripts/task-completed.mjs +13 -5
- package/plugin/scripts/task-completed.mjs.map +1 -1
- package/plugin/skills/_shared/TROUBLESHOOTING.md +21 -7
- package/plugin/skills/agentmemory-agents/REFERENCE.md +7 -6
- package/plugin/skills/agentmemory-agents/SKILL.md +19 -5
- package/plugin/skills/agentmemory-agents/TROUBLESHOOTING.md +70 -0
- package/plugin/skills/agentmemory-architecture/SKILL.md +4 -4
- package/plugin/skills/agentmemory-architecture/TROUBLESHOOTING.md +70 -0
- package/plugin/skills/agentmemory-config/REFERENCE.md +12 -15
- package/plugin/skills/agentmemory-config/SKILL.md +7 -3
- package/plugin/skills/agentmemory-config/TROUBLESHOOTING.md +70 -0
- package/plugin/skills/agentmemory-hooks/SKILL.md +15 -5
- package/plugin/skills/agentmemory-hooks/TROUBLESHOOTING.md +70 -0
- package/plugin/skills/agentmemory-mcp-tools/REFERENCE.md +4 -4
- package/plugin/skills/agentmemory-mcp-tools/SKILL.md +6 -3
- package/plugin/skills/agentmemory-mcp-tools/TROUBLESHOOTING.md +70 -0
- package/plugin/skills/agentmemory-rest-api/REFERENCE.md +9 -1
- package/plugin/skills/agentmemory-rest-api/SKILL.md +12 -6
- package/plugin/skills/agentmemory-rest-api/TROUBLESHOOTING.md +70 -0
- package/plugin/skills/commit-context/SKILL.md +1 -1
- package/plugin/skills/commit-context/TROUBLESHOOTING.md +70 -0
- package/plugin/skills/commit-history/SKILL.md +1 -1
- package/plugin/skills/commit-history/TROUBLESHOOTING.md +70 -0
- package/plugin/skills/forget/EXAMPLES.md +19 -54
- package/plugin/skills/forget/SKILL.md +16 -12
- package/plugin/skills/forget/TROUBLESHOOTING.md +70 -0
- package/plugin/skills/handoff/EXAMPLES.md +5 -4
- package/plugin/skills/handoff/SKILL.md +10 -5
- package/plugin/skills/handoff/TROUBLESHOOTING.md +70 -0
- package/plugin/skills/lesson/SKILL.md +1 -1
- package/plugin/skills/lesson/TROUBLESHOOTING.md +70 -0
- package/plugin/skills/memory-discipline/SKILL.md +1 -1
- package/plugin/skills/memory-discipline/TROUBLESHOOTING.md +70 -0
- package/plugin/skills/recall/SKILL.md +18 -7
- package/plugin/skills/recall/TROUBLESHOOTING.md +70 -0
- package/plugin/skills/recap/EXAMPLES.md +5 -3
- package/plugin/skills/recap/SKILL.md +11 -6
- package/plugin/skills/recap/TROUBLESHOOTING.md +70 -0
- package/plugin/skills/remember/EXAMPLES.md +3 -3
- package/plugin/skills/remember/SKILL.md +1 -1
- package/plugin/skills/remember/TROUBLESHOOTING.md +70 -0
- package/plugin/skills/session-history/EXAMPLES.md +2 -2
- package/plugin/skills/session-history/SKILL.md +10 -4
- package/plugin/skills/session-history/TROUBLESHOOTING.md +70 -0
- package/plugin/skills/write-agentmemory-skill/SKILL.md +2 -1
- package/plugin/skills/write-agentmemory-skill/TROUBLESHOOTING.md +70 -0
- package/dist/connect-B4_ca6BD.mjs.map +0 -1
- package/dist/docker-compose.yml +0 -73
- package/dist/iii-config.docker.yaml +0 -53
- package/dist/iii-config.yaml +0 -63
- package/dist/keyed-mutex-DchXsyfP.mjs.map +0 -1
- package/dist/secret-store-BnY3A50C.mjs.map +0 -1
- package/dist/src-Jsq9LCeH.mjs.map +0 -1
- package/dist/standalone-DKCdrf1d.mjs.map +0 -1
- package/dist/status-IRz7ta8-.mjs +0 -2344
- package/dist/status-IRz7ta8-.mjs.map +0 -1
- package/docker-compose.yml +0 -73
- package/iii-config.docker.yaml +0 -53
- package/iii-config.yaml +0 -63
|
@@ -0,0 +1,66 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: remember
|
|
3
|
+
description: Save an insight, decision, or learning to agentmemory's long-term storage with searchable concept tags. Use when the user says "remember this", "save this", "note that", "don't forget", or wants to preserve knowledge for future sessions.
|
|
4
|
+
argument-hint: "[what to remember]"
|
|
5
|
+
user-invocable: true
|
|
6
|
+
---
|
|
7
|
+
|
|
8
|
+
The user wants to save this to long-term memory: $ARGUMENTS
|
|
9
|
+
|
|
10
|
+
## Quick start
|
|
11
|
+
|
|
12
|
+
```json
|
|
13
|
+
memory_save {
|
|
14
|
+
"content": "We rotate JWT refresh tokens on every use; the old token is revoked server-side in auth/refresh.ts.",
|
|
15
|
+
"concepts": "jwt-refresh-rotation, token-revocation, auth-flow",
|
|
16
|
+
"files": "src/auth/refresh.ts"
|
|
17
|
+
}
|
|
18
|
+
```
|
|
19
|
+
|
|
20
|
+
Expected output:
|
|
21
|
+
|
|
22
|
+
```text
|
|
23
|
+
Saved memory abc12345 with 3 concepts: jwt-refresh-rotation, token-revocation, auth-flow.
|
|
24
|
+
```
|
|
25
|
+
|
|
26
|
+
## Why
|
|
27
|
+
|
|
28
|
+
A memory is only as useful as the terms that retrieve it. Tag with specific
|
|
29
|
+
concepts so a future `recall` finds it, and preserve the user's own phrasing.
|
|
30
|
+
|
|
31
|
+
## Workflow
|
|
32
|
+
|
|
33
|
+
1. Pull the core insight, decision, or fact out of `$ARGUMENTS`.
|
|
34
|
+
2. Extract 2-5 lowercased concept phrases. Prefer specific over generic
|
|
35
|
+
(`jwt-refresh-rotation` beats `auth`).
|
|
36
|
+
3. Extract referenced file paths (absolute or repo-relative). Empty if none.
|
|
37
|
+
4. Call `memory_save` with `content`, `concepts` (comma-separated string), and
|
|
38
|
+
`files` (comma-separated string). In a multi-agent setup pass `agentId` so
|
|
39
|
+
the memory lands in the right agent's scope.
|
|
40
|
+
5. Confirm the save and echo the concepts so the user knows the retrieval terms.
|
|
41
|
+
6. To update a fact, save the corrected version outright: near-duplicate content
|
|
42
|
+
supersedes the old record, which leaves recall but stays in the version chain.
|
|
43
|
+
|
|
44
|
+
## Anti-patterns
|
|
45
|
+
|
|
46
|
+
WRONG: `concepts: "stuff, code, notes"` (generic tags nothing can find later).
|
|
47
|
+
|
|
48
|
+
RIGHT: `concepts: "jwt-refresh-rotation, token-revocation"` (specific, retrievable).
|
|
49
|
+
|
|
50
|
+
## Checklist
|
|
51
|
+
|
|
52
|
+
- Content preserves the user's phrasing, not a paraphrase.
|
|
53
|
+
- Concepts are specific, lowercased, 2-5 items.
|
|
54
|
+
- File paths are real references, not guesses.
|
|
55
|
+
- Confirmation echoes the exact concepts tagged.
|
|
56
|
+
|
|
57
|
+
## See also
|
|
58
|
+
|
|
59
|
+
- `recall`: retrieve what you save here (the pair to this skill).
|
|
60
|
+
- `forget`: remove a memory you saved by mistake.
|
|
61
|
+
- `lesson`: behavioral rules from corrections; memories are for facts.
|
|
62
|
+
- `memory-discipline`: when to save unprompted.
|
|
63
|
+
|
|
64
|
+
## Troubleshooting
|
|
65
|
+
|
|
66
|
+
See [TROUBLESHOOTING.md](TROUBLESHOOTING.md) if `memory_save` is not available.
|
|
@@ -0,0 +1,70 @@
|
|
|
1
|
+
<!-- AUTOGEN:troubleshooting START - generated by scripts/skills/generate.ts, do not edit by hand -->
|
|
2
|
+
# Troubleshooting agentmemory skills
|
|
3
|
+
|
|
4
|
+
Recovery steps for separately installed skills. This document is generated into
|
|
5
|
+
each skill directory so native skill readers can open it without parent traversal.
|
|
6
|
+
|
|
7
|
+
## "MCP tool not available"
|
|
8
|
+
|
|
9
|
+
Missing tools can mean a stopped MCP process, a disconnected daemon, or an
|
|
10
|
+
explicitly reduced tool surface. Walk these in order:
|
|
11
|
+
|
|
12
|
+
1. Identify the host. In Claude Code, inspect `/plugin list` and `/mcp`.
|
|
13
|
+
In Hermes, inspect the configured memory provider and `mcp_servers` separately.
|
|
14
|
+
In OpenClaw, validate the host configuration and inspect its MCP servers and
|
|
15
|
+
native plugins separately. In Pi or OMP, inspect `/agentmemory-status` and the
|
|
16
|
+
MCP inventory separately; native save/search does not prove the broader tools
|
|
17
|
+
are connected. Do not run another host's setup commands.
|
|
18
|
+
2. Restart or reload the affected host connection after configuration changes.
|
|
19
|
+
3. Inspect the connected tool inventory. Hermes may namespace MCP tools; invoke
|
|
20
|
+
the actual advertised names and schemas. A native memory provider is not
|
|
21
|
+
proof that every MCP tool or shared skill is available.
|
|
22
|
+
4. Check `agentmemory status` and the daemon's `AGENTMEMORY_TOOLS` setting.
|
|
23
|
+
Codex's bundled bridge lists the daemon's enabled tools. The standalone shim
|
|
24
|
+
used by other hosts can fall back to seven basic tools with a separate store.
|
|
25
|
+
Do not claim full daemon functionality based on those seven tools.
|
|
26
|
+
5. If `agentmemory connect codex` and the Codex plugin are both enabled, choose
|
|
27
|
+
one MCP connection. Check `/hooks` before adding global hook fallbacks.
|
|
28
|
+
|
|
29
|
+
Hermes, OpenClaw, Pi and OMP connector installations bundle skills; other hosts
|
|
30
|
+
may install them separately. Check the host's skill inventory and open this file
|
|
31
|
+
from the installed skill directory. Test automatic capture with a real turn and
|
|
32
|
+
a recorded observation; tool connectivity alone does not establish lifecycle
|
|
33
|
+
capture.
|
|
34
|
+
|
|
35
|
+
An outage or timeout is not an empty search result. Report the failure. A write
|
|
36
|
+
may have committed before the response was lost; inspect state before retrying.
|
|
37
|
+
|
|
38
|
+
## REST fallback
|
|
39
|
+
|
|
40
|
+
When the MCP tools stay unavailable but the daemon is running, call the REST
|
|
41
|
+
API directly:
|
|
42
|
+
|
|
43
|
+
1. Set `AGENTMEMORY_URL` to the daemon base URL (default `http://localhost:3111`).
|
|
44
|
+
2. The REST API requires a bearer credential by default. Use the host's explicit
|
|
45
|
+
`AGENTMEMORY_SECRET`; for loopback URLs only, fall back to the secret in
|
|
46
|
+
`~/.agentmemory/.env` and then `~/.agentmemory/secret`. Load the value locally
|
|
47
|
+
without displaying it. Never send a local-file secret to a remote URL.
|
|
48
|
+
If `AGENTMEMORY_CREDENTIAL_MODE=explicit`, require the explicit host credential
|
|
49
|
+
and do not read local credential files.
|
|
50
|
+
Authenticated REST fallback requests require HTTPS for non-loopback
|
|
51
|
+
URLs; HTTP is allowed for loopback URLs (`localhost`, `127.0.0.0/8`, or `[::1]`).
|
|
52
|
+
Reject redirects on authenticated requests. Do not print or save the secret.
|
|
53
|
+
|
|
54
|
+
Endpoint map by skill:
|
|
55
|
+
|
|
56
|
+
| Skill | REST call |
|
|
57
|
+
| --------------- | --------------------------------------------------------------- |
|
|
58
|
+
| remember | `POST /agentmemory/remember` |
|
|
59
|
+
| recall | `POST /agentmemory/smart-search` |
|
|
60
|
+
| recap | `GET /agentmemory/sessions` + `POST /agentmemory/smart-search` |
|
|
61
|
+
| handoff | `GET /agentmemory/sessions` + `POST /agentmemory/smart-search` |
|
|
62
|
+
| session-history | `GET /agentmemory/sessions` |
|
|
63
|
+
| commit-context | `GET /agentmemory/session/by-commit?sha=<sha>` |
|
|
64
|
+
| commit-history | `GET /agentmemory/commits` (URL-encode every query param) |
|
|
65
|
+
|
|
66
|
+
The MCP host reads the plugin MCP configuration. Restart the daemon after
|
|
67
|
+
changing its configuration, then restart or reconnect the host MCP process after
|
|
68
|
+
changing its URL or explicit secret. The local bridge reads the credential files
|
|
69
|
+
for each request; it does not inherit other daemon `.env` settings.
|
|
70
|
+
<!-- AUTOGEN:troubleshooting END -->
|
|
@@ -0,0 +1,59 @@
|
|
|
1
|
+
# session-history worked examples
|
|
2
|
+
|
|
3
|
+
## 1. Standard timeline
|
|
4
|
+
|
|
5
|
+
User: "Show me the session history."
|
|
6
|
+
|
|
7
|
+
Invocation:
|
|
8
|
+
|
|
9
|
+
```json
|
|
10
|
+
memory_sessions { "project": "app", "limit": 20 }
|
|
11
|
+
```
|
|
12
|
+
|
|
13
|
+
Response:
|
|
14
|
+
|
|
15
|
+
```json
|
|
16
|
+
{
|
|
17
|
+
"sessions": [
|
|
18
|
+
{ "id": "7f3a9c21", "project": "app", "startedAt": "2026-06-07T09:00:00Z",
|
|
19
|
+
"status": "completed", "observationCount": 14,
|
|
20
|
+
"summary": "Reworked refresh rotation",
|
|
21
|
+
"highlights": [ { "type": "decision", "title": "Rotate refresh tokens on every use" } ] },
|
|
22
|
+
{ "id": "b21d004e", "project": "app", "startedAt": "2026-06-05T14:00:00Z",
|
|
23
|
+
"status": "completed", "observationCount": 9,
|
|
24
|
+
"highlights": [ { "type": "code", "title": "limit.ts counts per-IP" } ] }
|
|
25
|
+
]
|
|
26
|
+
}
|
|
27
|
+
```
|
|
28
|
+
|
|
29
|
+
Present:
|
|
30
|
+
|
|
31
|
+
> - `7f3a9c2` app, 2026-06-07 09:00, completed, 14 obs
|
|
32
|
+
> - decision: Rotate refresh tokens on every use (summary: Reworked refresh rotation)
|
|
33
|
+
> - `b21d004` app, 2026-06-05 14:00, completed, 9 obs
|
|
34
|
+
> - code: limit.ts counts per-IP
|
|
35
|
+
|
|
36
|
+
## 2. Session with no observations
|
|
37
|
+
|
|
38
|
+
If a returned session has `observationCount: 0`, list it but say so:
|
|
39
|
+
|
|
40
|
+
> - `c98f110` app, 2026-06-04 11:00, abandoned, 0 obs (no recorded work)
|
|
41
|
+
|
|
42
|
+
## 3. Empty history
|
|
43
|
+
|
|
44
|
+
User: "What did we do last time?"
|
|
45
|
+
|
|
46
|
+
```json
|
|
47
|
+
memory_sessions { "project": "app", "limit": 20 }
|
|
48
|
+
```
|
|
49
|
+
|
|
50
|
+
Response:
|
|
51
|
+
|
|
52
|
+
```json
|
|
53
|
+
{ "sessions": [] }
|
|
54
|
+
```
|
|
55
|
+
|
|
56
|
+
Present:
|
|
57
|
+
|
|
58
|
+
> No recorded sessions yet for this project. Once you work with memory capture
|
|
59
|
+
> on, they will show here. Use `remember` to save a note now.
|
|
@@ -0,0 +1,67 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: session-history
|
|
3
|
+
description: Show what happened in recent past sessions on this project as a clean timeline. Use when the user asks "what did we do last time", "session history", "past sessions", or wants an overview of previous work.
|
|
4
|
+
user-invocable: true
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
The user wants an overview of recent sessions on this project.
|
|
8
|
+
|
|
9
|
+
## Quick start
|
|
10
|
+
|
|
11
|
+
```json
|
|
12
|
+
memory_sessions { "project": "<current-project-id>", "limit": 20 }
|
|
13
|
+
```
|
|
14
|
+
|
|
15
|
+
Expected output:
|
|
16
|
+
|
|
17
|
+
```text
|
|
18
|
+
7f3a9c2 · app · 2026-06-07 09:00 · completed · 14 obs
|
|
19
|
+
- decision: Rotate refresh tokens on every use
|
|
20
|
+
b21d004 · app · 2026-06-05 14:00 · completed · 9 obs
|
|
21
|
+
- code: limit.ts counts per-IP
|
|
22
|
+
```
|
|
23
|
+
|
|
24
|
+
## Why
|
|
25
|
+
|
|
26
|
+
Only show sessions and observations the tool returned. An empty history is a
|
|
27
|
+
real answer, never a cue to invent past work.
|
|
28
|
+
|
|
29
|
+
## Workflow
|
|
30
|
+
|
|
31
|
+
1. Use the exact project identifier recorded by the host and pass it to
|
|
32
|
+
`memory_sessions`, with `agentId` when requested. If it is unknown, page
|
|
33
|
+
through sessions using `nextCursor` and match normalized `cwd` by directory
|
|
34
|
+
boundary before choosing the most recent 20. Never substitute another project.
|
|
35
|
+
2. Preserve scope filters on every page; stop at the requested count or a null
|
|
36
|
+
`nextCursor`. State when the displayed history is a partial page. Present in
|
|
37
|
+
reverse chronological order: session id (first 8), project, start
|
|
38
|
+
time, status.
|
|
39
|
+
3. For sessions with observations, show the key highlights (type plus title).
|
|
40
|
+
4. Note the total observation count per session.
|
|
41
|
+
5. When a session summary exists, surface its title and the key decisions.
|
|
42
|
+
|
|
43
|
+
## Anti-patterns
|
|
44
|
+
|
|
45
|
+
WRONG: the tool returns two sessions, you describe "several sessions of steady
|
|
46
|
+
progress" and add ones you remember from the conversation.
|
|
47
|
+
|
|
48
|
+
RIGHT: show exactly the two sessions returned, each with its real id, status, and
|
|
49
|
+
observation count.
|
|
50
|
+
|
|
51
|
+
## Checklist
|
|
52
|
+
|
|
53
|
+
- Every session shown came from the tool response.
|
|
54
|
+
- Project/directory scope was checked before selecting the displayed window.
|
|
55
|
+
- Order is reverse-chronological.
|
|
56
|
+
- Per-session observation counts match the response.
|
|
57
|
+
- No session or highlight was invented or merged.
|
|
58
|
+
|
|
59
|
+
## See also
|
|
60
|
+
|
|
61
|
+
- `recap`: same data grouped by date with highlights.
|
|
62
|
+
- `handoff`: jump straight into the most recent session.
|
|
63
|
+
- `recall`: search across all sessions by topic.
|
|
64
|
+
|
|
65
|
+
## Troubleshooting
|
|
66
|
+
|
|
67
|
+
See [TROUBLESHOOTING.md](TROUBLESHOOTING.md) if `memory_sessions` is not available.
|
|
@@ -0,0 +1,70 @@
|
|
|
1
|
+
<!-- AUTOGEN:troubleshooting START - generated by scripts/skills/generate.ts, do not edit by hand -->
|
|
2
|
+
# Troubleshooting agentmemory skills
|
|
3
|
+
|
|
4
|
+
Recovery steps for separately installed skills. This document is generated into
|
|
5
|
+
each skill directory so native skill readers can open it without parent traversal.
|
|
6
|
+
|
|
7
|
+
## "MCP tool not available"
|
|
8
|
+
|
|
9
|
+
Missing tools can mean a stopped MCP process, a disconnected daemon, or an
|
|
10
|
+
explicitly reduced tool surface. Walk these in order:
|
|
11
|
+
|
|
12
|
+
1. Identify the host. In Claude Code, inspect `/plugin list` and `/mcp`.
|
|
13
|
+
In Hermes, inspect the configured memory provider and `mcp_servers` separately.
|
|
14
|
+
In OpenClaw, validate the host configuration and inspect its MCP servers and
|
|
15
|
+
native plugins separately. In Pi or OMP, inspect `/agentmemory-status` and the
|
|
16
|
+
MCP inventory separately; native save/search does not prove the broader tools
|
|
17
|
+
are connected. Do not run another host's setup commands.
|
|
18
|
+
2. Restart or reload the affected host connection after configuration changes.
|
|
19
|
+
3. Inspect the connected tool inventory. Hermes may namespace MCP tools; invoke
|
|
20
|
+
the actual advertised names and schemas. A native memory provider is not
|
|
21
|
+
proof that every MCP tool or shared skill is available.
|
|
22
|
+
4. Check `agentmemory status` and the daemon's `AGENTMEMORY_TOOLS` setting.
|
|
23
|
+
Codex's bundled bridge lists the daemon's enabled tools. The standalone shim
|
|
24
|
+
used by other hosts can fall back to seven basic tools with a separate store.
|
|
25
|
+
Do not claim full daemon functionality based on those seven tools.
|
|
26
|
+
5. If `agentmemory connect codex` and the Codex plugin are both enabled, choose
|
|
27
|
+
one MCP connection. Check `/hooks` before adding global hook fallbacks.
|
|
28
|
+
|
|
29
|
+
Hermes, OpenClaw, Pi and OMP connector installations bundle skills; other hosts
|
|
30
|
+
may install them separately. Check the host's skill inventory and open this file
|
|
31
|
+
from the installed skill directory. Test automatic capture with a real turn and
|
|
32
|
+
a recorded observation; tool connectivity alone does not establish lifecycle
|
|
33
|
+
capture.
|
|
34
|
+
|
|
35
|
+
An outage or timeout is not an empty search result. Report the failure. A write
|
|
36
|
+
may have committed before the response was lost; inspect state before retrying.
|
|
37
|
+
|
|
38
|
+
## REST fallback
|
|
39
|
+
|
|
40
|
+
When the MCP tools stay unavailable but the daemon is running, call the REST
|
|
41
|
+
API directly:
|
|
42
|
+
|
|
43
|
+
1. Set `AGENTMEMORY_URL` to the daemon base URL (default `http://localhost:3111`).
|
|
44
|
+
2. The REST API requires a bearer credential by default. Use the host's explicit
|
|
45
|
+
`AGENTMEMORY_SECRET`; for loopback URLs only, fall back to the secret in
|
|
46
|
+
`~/.agentmemory/.env` and then `~/.agentmemory/secret`. Load the value locally
|
|
47
|
+
without displaying it. Never send a local-file secret to a remote URL.
|
|
48
|
+
If `AGENTMEMORY_CREDENTIAL_MODE=explicit`, require the explicit host credential
|
|
49
|
+
and do not read local credential files.
|
|
50
|
+
Authenticated REST fallback requests require HTTPS for non-loopback
|
|
51
|
+
URLs; HTTP is allowed for loopback URLs (`localhost`, `127.0.0.0/8`, or `[::1]`).
|
|
52
|
+
Reject redirects on authenticated requests. Do not print or save the secret.
|
|
53
|
+
|
|
54
|
+
Endpoint map by skill:
|
|
55
|
+
|
|
56
|
+
| Skill | REST call |
|
|
57
|
+
| --------------- | --------------------------------------------------------------- |
|
|
58
|
+
| remember | `POST /agentmemory/remember` |
|
|
59
|
+
| recall | `POST /agentmemory/smart-search` |
|
|
60
|
+
| recap | `GET /agentmemory/sessions` + `POST /agentmemory/smart-search` |
|
|
61
|
+
| handoff | `GET /agentmemory/sessions` + `POST /agentmemory/smart-search` |
|
|
62
|
+
| session-history | `GET /agentmemory/sessions` |
|
|
63
|
+
| commit-context | `GET /agentmemory/session/by-commit?sha=<sha>` |
|
|
64
|
+
| commit-history | `GET /agentmemory/commits` (URL-encode every query param) |
|
|
65
|
+
|
|
66
|
+
The MCP host reads the plugin MCP configuration. Restart the daemon after
|
|
67
|
+
changing its configuration, then restart or reconnect the host MCP process after
|
|
68
|
+
changing its URL or explicit secret. The local bridge reads the credential files
|
|
69
|
+
for each request; it does not inherit other daemon `.env` settings.
|
|
70
|
+
<!-- AUTOGEN:troubleshooting END -->
|
|
@@ -0,0 +1,41 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: write-agentmemory-skill
|
|
3
|
+
description: The house format and rules for writing or updating an agentmemory skill. Use when adding a new skill, restructuring an existing one, or reviewing a skill contribution for consistency.
|
|
4
|
+
user-invocable: false
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
agentmemory skills follow one tiered format so they stay skimmable, accurate, and current. Match it exactly.
|
|
8
|
+
|
|
9
|
+
## Directory layout
|
|
10
|
+
|
|
11
|
+
```text
|
|
12
|
+
plugin/skills/<name>/
|
|
13
|
+
SKILL.md (required, under 100 lines)
|
|
14
|
+
REFERENCE.md (optional, dense facts; auto-generate data tables)
|
|
15
|
+
EXAMPLES.md (optional, worked transcripts)
|
|
16
|
+
TROUBLESHOOTING.md (generated support file)
|
|
17
|
+
```
|
|
18
|
+
|
|
19
|
+
## SKILL.md rules
|
|
20
|
+
|
|
21
|
+
- Frontmatter: `name`, `description`, optional `argument-hint`, and `user-invocable`. Set `user-invocable: true` only for skills the user runs as a slash command; reference and knowledge skills are `false`.
|
|
22
|
+
- Description is two sentences and the only thing the agent sees when deciding to load the skill. Sentence one states the capability. Sentence two starts "Use when" and lists concrete triggers. Keep it distinct from sibling skills, under 1024 chars, third person.
|
|
23
|
+
- Body order: Quick start (one concrete example), Why (the governing principle), Workflow (numbered steps with decision gates), Anti-patterns (a WRONG vs RIGHT callout for the top mistake), Checklist, See also (cross-link siblings), Reference or Troubleshooting pointer.
|
|
24
|
+
- Stay under 100 lines. Move dense facts to REFERENCE.md and examples to EXAMPLES.md.
|
|
25
|
+
- Keep supporting files inside the skill directory so each skill works when installed separately. Link [TROUBLESHOOTING.md](TROUBLESHOOTING.md); the generator copies shared recovery instructions into each skill root.
|
|
26
|
+
|
|
27
|
+
## Keep it current
|
|
28
|
+
|
|
29
|
+
Facts that exist in source (tool names and parameters, REST endpoints, env vars, connect adapters, hook events) are generated, never hand-typed. Edit the source, then run `npm run skills:gen`. CI runs `npm run skills:check` and fails on drift, so generated tables cannot fall behind the code.
|
|
30
|
+
|
|
31
|
+
## Style
|
|
32
|
+
|
|
33
|
+
No external or competitor product names. No emojis. No em-dashes. No filler. State the thing and stop.
|
|
34
|
+
|
|
35
|
+
## Checklist
|
|
36
|
+
|
|
37
|
+
- Description has a "Use when" sentence with real triggers.
|
|
38
|
+
- SKILL.md is under 100 lines.
|
|
39
|
+
- No time-sensitive claims and no duplicated troubleshooting block.
|
|
40
|
+
- Concrete example present; generated facts come from the generator.
|
|
41
|
+
- Cross-links resolve and go one level deep.
|
|
@@ -0,0 +1,70 @@
|
|
|
1
|
+
<!-- AUTOGEN:troubleshooting START - generated by scripts/skills/generate.ts, do not edit by hand -->
|
|
2
|
+
# Troubleshooting agentmemory skills
|
|
3
|
+
|
|
4
|
+
Recovery steps for separately installed skills. This document is generated into
|
|
5
|
+
each skill directory so native skill readers can open it without parent traversal.
|
|
6
|
+
|
|
7
|
+
## "MCP tool not available"
|
|
8
|
+
|
|
9
|
+
Missing tools can mean a stopped MCP process, a disconnected daemon, or an
|
|
10
|
+
explicitly reduced tool surface. Walk these in order:
|
|
11
|
+
|
|
12
|
+
1. Identify the host. In Claude Code, inspect `/plugin list` and `/mcp`.
|
|
13
|
+
In Hermes, inspect the configured memory provider and `mcp_servers` separately.
|
|
14
|
+
In OpenClaw, validate the host configuration and inspect its MCP servers and
|
|
15
|
+
native plugins separately. In Pi or OMP, inspect `/agentmemory-status` and the
|
|
16
|
+
MCP inventory separately; native save/search does not prove the broader tools
|
|
17
|
+
are connected. Do not run another host's setup commands.
|
|
18
|
+
2. Restart or reload the affected host connection after configuration changes.
|
|
19
|
+
3. Inspect the connected tool inventory. Hermes may namespace MCP tools; invoke
|
|
20
|
+
the actual advertised names and schemas. A native memory provider is not
|
|
21
|
+
proof that every MCP tool or shared skill is available.
|
|
22
|
+
4. Check `agentmemory status` and the daemon's `AGENTMEMORY_TOOLS` setting.
|
|
23
|
+
Codex's bundled bridge lists the daemon's enabled tools. The standalone shim
|
|
24
|
+
used by other hosts can fall back to seven basic tools with a separate store.
|
|
25
|
+
Do not claim full daemon functionality based on those seven tools.
|
|
26
|
+
5. If `agentmemory connect codex` and the Codex plugin are both enabled, choose
|
|
27
|
+
one MCP connection. Check `/hooks` before adding global hook fallbacks.
|
|
28
|
+
|
|
29
|
+
Hermes, OpenClaw, Pi and OMP connector installations bundle skills; other hosts
|
|
30
|
+
may install them separately. Check the host's skill inventory and open this file
|
|
31
|
+
from the installed skill directory. Test automatic capture with a real turn and
|
|
32
|
+
a recorded observation; tool connectivity alone does not establish lifecycle
|
|
33
|
+
capture.
|
|
34
|
+
|
|
35
|
+
An outage or timeout is not an empty search result. Report the failure. A write
|
|
36
|
+
may have committed before the response was lost; inspect state before retrying.
|
|
37
|
+
|
|
38
|
+
## REST fallback
|
|
39
|
+
|
|
40
|
+
When the MCP tools stay unavailable but the daemon is running, call the REST
|
|
41
|
+
API directly:
|
|
42
|
+
|
|
43
|
+
1. Set `AGENTMEMORY_URL` to the daemon base URL (default `http://localhost:3111`).
|
|
44
|
+
2. The REST API requires a bearer credential by default. Use the host's explicit
|
|
45
|
+
`AGENTMEMORY_SECRET`; for loopback URLs only, fall back to the secret in
|
|
46
|
+
`~/.agentmemory/.env` and then `~/.agentmemory/secret`. Load the value locally
|
|
47
|
+
without displaying it. Never send a local-file secret to a remote URL.
|
|
48
|
+
If `AGENTMEMORY_CREDENTIAL_MODE=explicit`, require the explicit host credential
|
|
49
|
+
and do not read local credential files.
|
|
50
|
+
Authenticated REST fallback requests require HTTPS for non-loopback
|
|
51
|
+
URLs; HTTP is allowed for loopback URLs (`localhost`, `127.0.0.0/8`, or `[::1]`).
|
|
52
|
+
Reject redirects on authenticated requests. Do not print or save the secret.
|
|
53
|
+
|
|
54
|
+
Endpoint map by skill:
|
|
55
|
+
|
|
56
|
+
| Skill | REST call |
|
|
57
|
+
| --------------- | --------------------------------------------------------------- |
|
|
58
|
+
| remember | `POST /agentmemory/remember` |
|
|
59
|
+
| recall | `POST /agentmemory/smart-search` |
|
|
60
|
+
| recap | `GET /agentmemory/sessions` + `POST /agentmemory/smart-search` |
|
|
61
|
+
| handoff | `GET /agentmemory/sessions` + `POST /agentmemory/smart-search` |
|
|
62
|
+
| session-history | `GET /agentmemory/sessions` |
|
|
63
|
+
| commit-context | `GET /agentmemory/session/by-commit?sha=<sha>` |
|
|
64
|
+
| commit-history | `GET /agentmemory/commits` (URL-encode every query param) |
|
|
65
|
+
|
|
66
|
+
The MCP host reads the plugin MCP configuration. Restart the daemon after
|
|
67
|
+
changing its configuration, then restart or reconnect the host MCP process after
|
|
68
|
+
changing its URL or explicit secret. The local bridge reads the credential files
|
|
69
|
+
for each request; it does not inherit other daemon `.env` settings.
|
|
70
|
+
<!-- AUTOGEN:troubleshooting END -->
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@agentmemory/agentmemory",
|
|
3
|
-
"version": "0.9.
|
|
3
|
+
"version": "0.9.31",
|
|
4
4
|
"description": "Persistent memory for AI coding agents, powered by iii-engine's three primitives",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"main": "dist/index.mjs",
|
|
@@ -17,27 +17,43 @@
|
|
|
17
17
|
"agentmemory": "dist/cli.mjs"
|
|
18
18
|
},
|
|
19
19
|
"scripts": {
|
|
20
|
-
"build": "tsdown &&
|
|
20
|
+
"build": "tsdown && rm -f dist/iii-config.yaml dist/iii-config.docker.yaml dist/docker-compose.yml && (cp .env.example dist/ 2>/dev/null || true) && mkdir -p dist/viewer && cp src/viewer/index.html dist/viewer/ && cp src/viewer/favicon.svg dist/viewer/",
|
|
21
21
|
"dev": "tsx src/index.ts",
|
|
22
22
|
"start": "node dist/cli.mjs",
|
|
23
23
|
"migrate": "node dist/functions/migrate.js",
|
|
24
|
+
"pretest": "npm run build",
|
|
24
25
|
"test": "vitest run --exclude test/integration.test.ts",
|
|
25
26
|
"test:watch": "vitest --exclude test/integration.test.ts",
|
|
26
27
|
"test:integration": "vitest run test/integration.test.ts",
|
|
27
28
|
"test:all": "vitest run",
|
|
29
|
+
"test:vector-recovery:packaged": "node scripts/release-gate/vector-recovery.mjs",
|
|
30
|
+
"test:startup:packaged": "node scripts/release-gate/startup.mjs",
|
|
31
|
+
"test:summary-recovery:packaged": "node scripts/release-gate/summary-recovery.mjs",
|
|
32
|
+
"test:cli-diagnostics:packaged": "node scripts/release-gate/cli-diagnostics.mjs",
|
|
33
|
+
"test:graph-index:packaged": "node scripts/release-gate/graph-index.mjs",
|
|
34
|
+
"test:skills:packaged": "node scripts/release-gate/skills.mjs",
|
|
35
|
+
"test:openclaw:packaged": "node scripts/release-gate/openclaw.mjs",
|
|
28
36
|
"release:gate": "node scripts/release-gate/run.mjs",
|
|
37
|
+
"release:prepare": "node scripts/release/publish.mjs prepare",
|
|
38
|
+
"release:publish": "node scripts/release/publish.mjs publish",
|
|
29
39
|
"skills:gen": "tsx scripts/skills/generate.ts",
|
|
30
40
|
"engine:hashes": "node scripts/engine-hashes.mjs",
|
|
31
41
|
"skills:check": "tsx scripts/skills/generate.ts --check && tsx scripts/skills/check.ts",
|
|
32
42
|
"docs:sync": "tsx scripts/docs-sync.ts",
|
|
33
43
|
"docs:check": "tsx scripts/docs-sync.ts --check",
|
|
34
44
|
"plugin:pack:codex": "npm run build && node scripts/plugins/package-codex.mjs",
|
|
45
|
+
"plugin:pack:pi": "tsdown --filter pi-extension && node scripts/plugins/prepare-native.mjs && node -e \"require('node:fs').mkdirSync('dist/plugins', { recursive: true })\" && npm pack ./integrations/pi --pack-destination dist/plugins",
|
|
35
46
|
"plugin:verify:published": "node scripts/plugins/verify-published.mjs",
|
|
36
47
|
"test:plugin:live": "node scripts/plugins/test-live.mjs",
|
|
37
48
|
"bench:load": "node --import tsx benchmark/load-100k.ts",
|
|
38
49
|
"bench:capture-costs": "node --import tsx benchmark/capture-costs.ts",
|
|
39
|
-
"eval:longmemeval": "tsx eval/runner/longmemeval.ts",
|
|
40
|
-
"eval:coding-life": "tsx eval/runner/coding-life.ts"
|
|
50
|
+
"eval:longmemeval": "node --import tsx eval/runner/longmemeval.ts",
|
|
51
|
+
"eval:coding-life": "node --import tsx eval/runner/coding-life.ts",
|
|
52
|
+
"eval:lifecycle": "node --import tsx eval/runner/lifecycle.ts",
|
|
53
|
+
"eval:recall": "node --import tsx eval/runner/recall-quality.ts",
|
|
54
|
+
"eval:check": "tsc --noEmit --project tsconfig.eval.json && vitest run test/eval-adapters.test.ts test/eval-integrity.test.ts",
|
|
55
|
+
"prepack": "node scripts/plugins/prepare-native.mjs",
|
|
56
|
+
"plugin:pack:openclaw": "node scripts/plugins/prepare-native.mjs && mkdir -p dist/plugins && npm pack ./integrations/openclaw --pack-destination dist/plugins"
|
|
41
57
|
},
|
|
42
58
|
"keywords": [
|
|
43
59
|
"ai",
|
|
@@ -52,11 +68,12 @@
|
|
|
52
68
|
],
|
|
53
69
|
"files": [
|
|
54
70
|
"dist/",
|
|
71
|
+
"!dist/plugins/**",
|
|
55
72
|
"plugin/",
|
|
56
73
|
"integrations/pi/",
|
|
57
|
-
"
|
|
58
|
-
"
|
|
59
|
-
"
|
|
74
|
+
"integrations/omp/",
|
|
75
|
+
"integrations/hermes/",
|
|
76
|
+
"integrations/openclaw/",
|
|
60
77
|
".env.example",
|
|
61
78
|
"LICENSE",
|
|
62
79
|
"README.md",
|
|
@@ -73,10 +90,12 @@
|
|
|
73
90
|
"@anthropic-ai/sdk": "^0.100.1",
|
|
74
91
|
"@clack/prompts": "^1.2.0",
|
|
75
92
|
"dotenv": "^18.0.3",
|
|
76
|
-
"@iii-dev/helpers": "0.
|
|
77
|
-
"iii-sdk": "0.
|
|
93
|
+
"@iii-dev/helpers": "0.25.0",
|
|
94
|
+
"iii-sdk": "0.25.0",
|
|
78
95
|
"picocolors": "^1.1.1",
|
|
79
|
-
"zod": "^4.0.0"
|
|
96
|
+
"zod": "^4.0.0",
|
|
97
|
+
"yaml": "^2.8.1",
|
|
98
|
+
"json5": "^2.2.3"
|
|
80
99
|
},
|
|
81
100
|
"optionalDependencies": {
|
|
82
101
|
"@huggingface/transformers": "^4.2.0",
|
|
@@ -85,10 +104,12 @@
|
|
|
85
104
|
},
|
|
86
105
|
"devDependencies": {
|
|
87
106
|
"@types/node": "^26.6.2",
|
|
107
|
+
"sigstore": "4.1.1",
|
|
88
108
|
"tsdown": "^0.21.10",
|
|
89
109
|
"tsx": "^4.19.0",
|
|
90
110
|
"typescript": "^6.0.3",
|
|
91
|
-
"vitest": "^4.1.6"
|
|
111
|
+
"vitest": "^4.1.6",
|
|
112
|
+
"ws": "^8.21.0"
|
|
92
113
|
},
|
|
93
114
|
"overrides": {
|
|
94
115
|
"qs": "^6.15.2",
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "agentmemory",
|
|
3
|
-
"version": "0.9.
|
|
3
|
+
"version": "0.9.31",
|
|
4
4
|
"description": "Persistent memory for AI coding agents -- captures tool usage, compresses via LLM, injects context into future sessions. 12 hooks, 54 MCP tools, 17 skills, real-time viewer.",
|
|
5
5
|
"author": {
|
|
6
6
|
"name": "Rohit Ghumare",
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "agentmemory",
|
|
3
|
-
"version": "0.9.
|
|
3
|
+
"version": "0.9.31",
|
|
4
4
|
"description": "Local persistent memory for coding agents. Recall decisions, resume sessions, learn from corrections, and manage memory through 54 MCP tools and 17 skills. Optional capture through 6 Codex hooks.",
|
|
5
5
|
"author": {
|
|
6
6
|
"name": "Rohit Ghumare",
|
|
@@ -15,9 +15,10 @@
|
|
|
15
15
|
"interface": {
|
|
16
16
|
"displayName": "Agent Memory",
|
|
17
17
|
"shortDescription": "Memory across coding sessions",
|
|
18
|
-
"longDescription": "Recall past decisions, resume work, save useful context, and learn from corrections across
|
|
18
|
+
"longDescription": "Recall past decisions, resume work, save useful context, and learn from corrections across your coding sessions using one local Agent Memory daemon. Includes search, session history, lessons, graph queries, memory maintenance, export, and deletion workflows. Requires Node.js 20+ and a running Agent Memory daemon. Basic keyword recall needs no model key. Embeddings and model-based features require configuration; external providers may receive selected data when enabled. Automatic capture requires trusted, supported hooks. Designed for local Codex sessions.",
|
|
19
19
|
"developerName": "Rohit Ghumare",
|
|
20
|
-
"websiteURL": "https://
|
|
20
|
+
"websiteURL": "https://www.agent-memory.dev",
|
|
21
|
+
"privacyPolicyURL": "https://www.agent-memory.dev/privacy",
|
|
21
22
|
"supportURL": "https://github.com/rohitg00/agentmemory/issues",
|
|
22
23
|
"category": "Developer Tools",
|
|
23
24
|
"capabilities": ["Local persistent memory", "Session handoff", "Lessons and recall", "Memory management"],
|
|
@@ -1,7 +1,9 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "agentmemory",
|
|
3
|
-
"
|
|
4
|
-
"
|
|
3
|
+
"displayName": "agentmemory",
|
|
4
|
+
"version": "0.9.31",
|
|
5
|
+
"description": "Persistent memory for Devin CLI and Devin Desktop. Captures every session automatically, recalls with hybrid BM25 + vector + graph search, and exposes 54 memory tools over MCP. Keyless by default, runs on your machine. Not supported in cloud sessions.",
|
|
6
|
+
"logo": "assets/icon.svg",
|
|
5
7
|
"author": {
|
|
6
8
|
"name": "Rohit Ghumare",
|
|
7
9
|
"email": "ghumare64@gmail.com"
|
|
@@ -21,7 +23,7 @@
|
|
|
21
23
|
"command": "npx",
|
|
22
24
|
"args": [
|
|
23
25
|
"-y",
|
|
24
|
-
"@agentmemory/mcp"
|
|
26
|
+
"@agentmemory/mcp@0.9.31"
|
|
25
27
|
],
|
|
26
28
|
"env": {
|
|
27
29
|
"AGENTMEMORY_URL": "${AGENTMEMORY_URL:-http://localhost:3111}",
|