agentmemory-rest-api

Agent Skills › rohitg00/agentmemory › agentmemory-rest-api

agentmemory-rest-api

GitHub

提供 agentmemory 的 HTTP REST API 交互指南，涵盖快速启动、认证机制及响应约定。用于在 MCP 不可用或集成不支持 MCP 的主机时，作为调用内存服务器的备用协议。

plugin/skills/agentmemory-rest-api/SKILL.md rohitg00/agentmemory

Trigger Scenarios

需要直接通过 HTTP 调用 agentmemory 接口 MCP 协议不可用需使用 REST 替代方案集成不支持 MCP 协议的主机系统

Install

npx skills add rohitg00/agentmemory --skill agentmemory-rest-api -g -y

More Options

Non-standard path

npx skills add https://github.com/rohitg00/agentmemory/tree/main/plugin/skills/agentmemory-rest-api -g -y

Use without installing

npx skills use rohitg00/agentmemory@agentmemory-rest-api

指定 Agent (Claude Code)

npx skills add rohitg00/agentmemory --skill agentmemory-rest-api -a claude-code -g -y

安装 repo 全部 skill

npx skills add rohitg00/agentmemory --all -g -y

预览 repo 内 skill

npx skills add rohitg00/agentmemory --list

SKILL.md

Frontmatter

{
    "name": "agentmemory-rest-api",
    "description": "The agentmemory HTTP REST API surface, the primary protocol for talking to the memory server. Use when calling agentmemory over HTTP, when MCP is unavailable and you need a fallback, or when integrating a host that does not speak MCP.",
    "user-invocable": false
}

REST is agentmemory's primary surface. MCP is a bridge on top of it. Every memory operation has an HTTP endpoint under http://localhost:3111/agentmemory/*.

Quick start

# liveness
curl -fsS http://localhost:3111/agentmemory/livez

# For this fixed loopback URL only. Do not print the value or enable shell tracing.
agentmemory_secret="${AGENTMEMORY_SECRET:-$(cat "$HOME/.agentmemory/secret")}"
test -n "$agentmemory_secret" || exit 1

# save
curl -fsS -X POST http://localhost:3111/agentmemory/remember \
  -H "Authorization: Bearer $agentmemory_secret" \
  -H "Content-Type: application/json" \
  -d '{"content":"chose JWT refresh rotation","concepts":["jwt-refresh-rotation"]}'

# recall
curl -fsS -X POST http://localhost:3111/agentmemory/smart-search \
  -H "Authorization: Bearer $agentmemory_secret" \
  -H "Content-Type: application/json" \
  -d '{"query":"auth token strategy","limit":5}'

Auth

Every endpoint except liveness requires Authorization: Bearer <secret>, including on localhost. The server always has a secret: AGENTMEMORY_SECRET when you set one, otherwise one it generates at first start. Requests without the header get 401. Liveness is public. The example uses an explicit environment secret or the generated local secret file; if the daemon uses a secret from its .env, load that value locally without displaying it. For a remote daemon, require an explicit credential for that endpoint and HTTPS. Never forward a local-file secret or follow an authenticated redirect to another host. See TROUBLESHOOTING.md.

Conventions

Save returns 201, reads return 200, validation errors return 400.
Use documented fields only. A successful response does not prove an unsupported field was applied.
The REST port defaults to 3111 and is configurable with --port or --instance. The viewer defaults to 3113; the internal engine WebSocket defaults to 49134.

Reference

The full endpoint list with methods lives in REFERENCE.md, generated from src/triggers/api.ts.

Version History

4f758ef Current 2026-11-07 15:19
c6c476d 2026-11-02 19:01
e01540e 2026-10-19 02:22
强化插件与安全机制，新增 Bearer Token 认证要求，明确 localhost 默认需鉴权及远程 HTTPS 安全规范。
a8e7d19 2026-07-24 11:39

Metadata

Files: 0
Version: 4f758ef
Hash: e5254980
Indexed: 2026-07-24 11:39

agentmemory-rest-api