chore: import upstream snapshot with attribution

2026-07-13 13:01:18 +08:00
commit 979fb22d7c
613 changed files with 113494 additions and 0 deletions
@@ -0,0 +1,38 @@
+# Troubleshooting agentmemory skills
+
+Shared recovery steps for all user-invocable agentmemory skills. Each skill's
+Troubleshooting section points here instead of duplicating the block.
+
+## "MCP tool not available"
+
+If a `memory_*` MCP tool does not appear, the stdio MCP shim never started.
+Walk these in order:
+
+1. Run `/plugin list` in the host and confirm `agentmemory` shows as enabled.
+2. Restart the host. The plugin's `.mcp.json` is only read on startup, so a
+   freshly installed or re-enabled plugin will not register tools mid-session.
+3. Check `/mcp` and confirm the `agentmemory` server shows a live connection.
+
+## REST fallback
+
+When the MCP tools stay unavailable but the daemon is running, call the REST
+API directly:
+
+1. Set `AGENTMEMORY_URL` to the daemon base URL (default `http://localhost:3111`).
+2. Add `Authorization: Bearer $AGENTMEMORY_SECRET` ONLY when `AGENTMEMORY_SECRET`
+   is set. The default localhost daemon is open and rejects a stray header.
+
+Endpoint map by skill:
+
+| Skill           | REST call                                                        |
+| --------------- | --------------------------------------------------------------- |
+| remember        | `POST /agentmemory/remember`                                     |
+| recall          | `POST /agentmemory/smart-search`                                 |
+| recap           | `GET /agentmemory/sessions` + `POST /agentmemory/smart-search`   |
+| handoff         | `GET /agentmemory/sessions` + `POST /agentmemory/smart-search`   |
+| session-history | `GET /agentmemory/sessions`                                      |
+| commit-context  | `GET /agentmemory/session/by-commit?sha=<sha>`                   |
+| commit-history  | `GET /agentmemory/commits` (URL-encode every query param)       |
+
+The daemon reads `.mcp.json` on startup only, so any port or auth change needs a
+restart before either transport sees it.