본문으로 건너뛰기
cccskills
무료GitHub에 공개

agentmemory-rest-api

Guides HTTP integration with the agentmemory server for saving and searching knowledge. It explains authentication, request conventions, and endpoint references, including how to connect systems that do not support MCP, the agent tool connection protocol.

한국어 요약은 준비 중입니다. 영어 요약을 표시하고 있습니다.

원문원문 설명 보기

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.

설치 방법 보기

이럴 때 유용합니다

  • Saving and searching knowledge over HTTP
  • Connecting a host that does not support MCP
  • Checking authentication and response conventions
  • Checking whether the memory server is running

포함된 파일(3)

  • SKILL.md2.2 KB
  • REFERENCE.md6.0 KB
  • TROUBLESHOOTING.md3.7 KB

SKILL.md(원문)

설치하기 전에 에이전트에게 전달되는 지시 내용을 확인할 수 있습니다.

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

Protected endpoints require bearer authentication by default, including localhost. 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 port is configurable with --port or --instance; streams, viewer, and engine derive from it.

See also

  • agentmemory-mcp-tools for the MCP equivalents.
  • agentmemory-config for the port quartet and the secret.

Reference

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

리뷰

아직 리뷰가 없습니다. 사용해 본 소감을 남겨 주세요.

댓글

로그인 없이 쓸 수 있습니다. 사용 후기, 질문, 작동하지 않은 환경 등을 편하게 남겨 주세요.

아직 댓글이 없습니다. 첫 댓글을 남겨 보세요.

보내면 바로 공개됩니다. 이메일 주소나 전화번호 같은 개인 정보는 쓰지 마세요. URL은 2개까지입니다.

0 / 1,000자

이 양식은 reCAPTCHA로 보호되며 Google 개인정보처리방침 및 서비스 약관이 적용됩니다.

같은 저장소의 스킬

Connect agentmemory to coding agents such as Claude Code and Codex while preserving existing server settings. It guides configuration, host restarts, and checks that memory tools are available and can save and retrieve information.

한국어 요약은 준비 중입니다. 영어 요약을 표시하고 있습니다.

  • Connecting agentmemory to a coding agent
  • Checking supported agents and connection methods
  • Investigating an incorrect configuration path
rohitg00/agentmemory3만2026년 10월 18일 업데이트

Explain how agentmemory stores and retrieves coding agents’ memories, including its engine, search methods, memory lifecycle, ports, and web viewer. Useful for understanding the system or planning extensions to its functions.

한국어 요약은 준비 중입니다. 영어 요약을 표시하고 있습니다.

  • Understand how agent memories are stored and retrieved
  • Plan extensions to agentmemory
  • Check memory capture in the web viewer
rohitg00/agentmemory3만2026년 10월 18일 업데이트

Set up and troubleshoot a local agentmemory server by checking MCP connections, authentication, ports, and environment settings. Understand which optional memory features require additional configuration, model downloads, or token usage before enabling them.

한국어 요약은 준비 중입니다. 영어 요약을 표시하고 있습니다.

  • Set up a local agentmemory connection
  • Diagnose MCP connection failures
  • Review authentication and custom ports
rohitg00/agentmemory3만2026년 10월 18일 업데이트

Understand how agentmemory automatically records tool activity, prompts, and session boundaries through hooks, actions triggered by session events. Use it to check integration setup, investigate missing records, and distinguish capture from optional summaries and context injection.

한국어 요약은 준비 중입니다. 영어 요약을 표시하고 있습니다.

  • Understanding automatic session recording
  • Investigating missing observations
  • Checking capture and summary settings
rohitg00/agentmemory3만2026년 10월 18일 업데이트

Helps agents choose the right agentmemory tool through MCP, a protocol for connecting agents to tools. It explains tool roles and points to parameter references for saving, retrieving, organizing, and maintaining stored knowledge.

한국어 요약은 준비 중입니다. 영어 요약을 표시하고 있습니다.

  • Choosing a tool to save or retrieve knowledge
  • Checking tool names and required parameters
  • Reviewing available memory management operations
rohitg00/agentmemory3만2026년 10월 18일 업데이트

Trace a file, function, or line through Git history to the agent session linked to its commit. It presents recorded commit details, session summaries, and important observations to help explain the change.

한국어 요약은 준비 중입니다. 영어 요약을 표시하고 있습니다.

  • Investigating why a particular line changed
  • Finding the agent session behind a function change
  • Checking a file's latest commit and author
rohitg00/agentmemory3만2026년 10월 18일 업데이트

rohitg00의 스킬 모두 보기

이 스킬의 문제 신고