Agent skill

Agentmemory REST API

by rohitg00 in rohitg00/agentmemory

Covers the HTTP REST endpoints of the agentmemory server, its primary interface, for hosts without MCP or when MCP is unavailable.

Apache-2.0Auto-check passedBackend & APIs

Install Agentmemory REST API

skills CLI
$ npx skills add rohitg00/agentmemory --skill agentmemory-rest-api -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install rohitg00/agentmemory agentmemory-rest-api --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/rohitg00/agentmemory.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugin/skills/agentmemory-rest-api .claude/skills/agentmemory-rest-api && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
agentmemory-rest-api
GitHub stars
29k
Token cost
~404 tokens
SKILL.md length
117 words
Files
2
Skills in repo
17
Repo updated
First seen
Licence
Apache-2.0

At a glance

Covers the HTTP REST endpoints of the agentmemory server, its primary interface, for hosts without MCP or when MCP is unavailable.

  • Calling agentmemory over HTTP from a script or service
  • SKILL.md covers Quick start, Auth, Conventions and See also, plus 1 more section
  • Calls curl; needs AGENTMEMORY_SECRET
  • Falling back to REST when the MCP server is unavailable

What it does

REST is the primary surface of agentmemory and MCP is a bridge on top of it, so every memory operation has an endpoint under http://localhost:3111/agentmemory/. The skill gives a curl liveness check and points to REFERENCE.md for the full endpoint list with methods, which is generated from the API source.

By default localhost is open and needs no auth, but when AGENTMEMORY_SECRET is set every request must carry an Authorization Bearer header. Saves return 201, reads return 200 and validation errors return 400. Handlers whitelist body fields and drop unknown ones, so extra keys are ignored, and the port can be changed with --port or --instance, with the stream, viewer and engine ports derived from it.

When your agent uses it

  • Calling agentmemory over HTTP from a script or service
  • Falling back to REST when the MCP server is unavailable
  • Integrating a host application that does not speak MCP

Example prompts

  • “Check that the agentmemory server is alive with a curl request.”
  • “Save a memory through the agentmemory REST API and read it back.”
  • “The agentmemory secret is set. Show me how to add the Authorization header.”

Requirements

  • A running agentmemory server
  • The AGENTMEMORY_SECRET value if one is set

What it can do on your machine

Read from SKILL.md and the folder at commit 007a1a7. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • curl

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use curl, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • AGENTMEMORY_SECRET

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Agentmemory REST API loads about 404 tokens when it runs. Until then it costs about 64 tokens; SKILL.md has 117 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~64
When it runs · the whole SKILL.md, loaded when a task matches
~404

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from rohitg00/agentmemory at commit 007a1a7, republished under its Apache-2.0 licence (© rohitg00). 117 words, ~404 tokens.

Download SKILL.mdSave it as .claude/skills/agentmemory-rest-api/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
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

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

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

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

Auth

By default localhost is open and no auth is needed. When AGENTMEMORY_SECRET is set, every request needs Authorization: Bearer $AGENTMEMORY_SECRET. See agentmemory-config.

Conventions

  • Save returns 201, reads return 200, validation errors return 400.
  • Handlers whitelist body fields and drop unknown ones, so passing extra keys is safe but ignored.
  • 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.

© rohitg00, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file in plugin/skills/agentmemory-rest-api of rohitg00/agentmemory.

  • SKILL.md
  • REFERENCE.md

Open the folder on GitHubat commit 007a1a7

Compare with similar skills

Agentmemory REST API next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Agentmemory REST API compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Agentmemory REST API this skillrohitg00/agentmemory29k—~404Automated safety check: PassApache-2.0
Browser Gui Inspectautomateyournetwork/netclaw674—~3.9kAutomated safety check: PassApache-2.0
Nevermined PaymentsLeoYeAI/openclaw-master-skills2.2k—~4.5kAutomated safety check: NotesMIT
Pixiu MCP Gatewayapache/dubbo-go-pixiu568—~3.1kAutomated safety check: PassApache-2.0
MCP API Key AuthenticationYourdaylight/stock_datasource188—~1.2kAutomated safety check: PassMIT
Atlassian MCP ExpertJeffallan/claude-skills12k—~1.3kAutomated safety check: PassMIT

Similar skills

  • Browser Gui Inspect

    automateyournetwork/netclaw

    Controller-agnostic browser automation and inspection — navigate, read, click, fill, and capture network traffic on any web GUI using a persistent, manually-authenticated Chrome profile.

    674 GitHub stars~3.9k tokensUpdated 2 days ago
    Backend & APIsAuto-check passed
  • Nevermined Payments

    LeoYeAI/openclaw-master-skills

    Integrates Nevermined payment infrastructure into AI agents, MCP servers, Google A2A agents, and REST APIs.

    2.2k GitHub stars~4.5k tokensUpdated 2 mo ago
    Backend & APIsAuto-check: notes
  • Pixiu MCP Gateway

    apache/dubbo-go-pixiu

    Creates and validates dubbo-go-pixiu MCP gateway conf.yaml. An agent skill from apache/dubbo-go-pixiu.

    568 GitHub stars~3.1k tokensUpdated 4 days ago
    Backend & APIsAuto-check passed
  • MCP API Key Authentication

    Yourdaylight/stock_datasource

    Sets up and troubleshoots MCP API key authentication for a stock data service, covering key creation, client configuration and per-tool usage statistics.

    188 GitHub stars~1.2k tokensUpdated 29 days ago
    Backend & APIsAuto-check passed
  • Atlassian MCP Expert

    Jeffallan/claude-skills

    Queries and edits Jira issues and Confluence pages through an MCP server, covering JQL and CQL queries, server setup, authentication and sprint or backlog workflows.

    12k GitHub stars~1.3k tokensUpdated 4 days ago
    Backend & APIsAuto-check passed
  • AWS Lambda Durable Functions

    awslabs/agent-plugins

    Official

    Build resilient, long-running, multi-step applications with AWS Lambda durable functions with automatic state persistence, retry logic, and orchestration for long-running executions.

    912 GitHub stars~2.3k tokensUpdated 2 days ago
    Backend & APIsAuto-check passed

More from rohitg00/agentmemory

All 17 skills in this repo
  • Sets up and troubleshoots a local agentmemory install, covering the MCP connection, environment variables, ports, authentication and optional feature flags.

    29k GitHub stars~1k tokensUpdated yesterday
    Auto-check: notes
  • Commit Context Lookup

    rohitg00/agentmemory

    Traces a file, function or line back to the agent session behind its current commit, using git blame and a memory lookup, and reports only what the records show.

    29k GitHub stars~522 tokensUpdated yesterday
    Auto-check passed
  • Agent Commit History

    rohitg00/agentmemory

    Lists recent git commits linked to agent sessions, filterable by branch, repository or a result limit, showing the session id and observation count behind each one.

    29k GitHub stars~524 tokensUpdated yesterday
    Auto-check passed
  • Agentmemory Forget

    rohitg00/agentmemory

    Deletes chosen memories from agentmemory only after showing the matches and getting an explicit yes, for privacy requests and cleanup of outdated notes.

    29k GitHub stars~612 tokensUpdated yesterday
    Auto-check passed
  • Session Handoff Resume

    rohitg00/agentmemory

    Resumes the most recent agent session for the current directory, leading with any question left unanswered and ending with a concrete next step.

    29k GitHub stars~678 tokensUpdated yesterday
    Auto-check passed
  • Lesson Memory Recorder

    rohitg00/agentmemory

    Distills a user correction or hard-won rule into a confidence-weighted lesson that resurfaces automatically before similar future work.

    29k GitHub stars~721 tokensUpdated yesterday
    Auto-check passed

Questions about Agentmemory REST API

What does Agentmemory REST API do?

Covers the HTTP REST endpoints of the agentmemory server, its primary interface, for hosts without MCP or when MCP is unavailable. REST is the primary surface of agentmemory and MCP is a bridge on top of it, so every memory operation has an endpoint under http://localhost:3111/agentmemory/.md for the full endpoint list with methods, which is generated from the API source.

When should I use Agentmemory REST API?

Agentmemory REST API fits situations like: calling agentmemory over HTTP from a script or service; falling back to REST when the MCP server is unavailable; integrating a host application that does not speak MCP.

How do I install Agentmemory REST API in Claude Code?

Run `npx skills add rohitg00/agentmemory --skill agentmemory-rest-api -a claude-code`. Or copy the skill folder (plugin/skills/agentmemory-rest-api in rohitg00/agentmemory) into .claude/skills/agentmemory-rest-api in your project. Claude Code loads it when a task matches its description.

How do I install Agentmemory REST API in Codex?

Run `npx skills add rohitg00/agentmemory --skill agentmemory-rest-api -a codex`. Or copy the skill folder (plugin/skills/agentmemory-rest-api in rohitg00/agentmemory) into .agents/skills/agentmemory-rest-api in your project. Codex loads it when a task matches its description.

Can I use Agentmemory REST API in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add rohitg00/agentmemory --skill agentmemory-rest-api -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/agentmemory-rest-api, .gemini/skills/agentmemory-rest-api, .github/skills/agentmemory-rest-api and .opencode/skills/agentmemory-rest-api in your project.

What does Agentmemory REST API need to run?

Going by SKILL.md and its folder, Agentmemory REST API needs the command-line tools its instructions call (curl) and credentials named AGENTMEMORY_SECRET. Our summary lists: A running agentmemory server; The AGENTMEMORY_SECRET value if one is set.

Does Agentmemory REST API access the network?

SKILL.md contains no URLs. Its commands use curl, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Agentmemory REST API safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Agentmemory REST API use?

Agentmemory REST API is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Agentmemory REST API use?

About 404 tokens (SKILL.md is roughly 1.6k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Agentmemory REST API?

Skills that share tags, products or a category with Agentmemory REST API: Browser Gui Inspect (automateyournetwork/netclaw, 674 stars), Nevermined Payments (LeoYeAI/openclaw-master-skills, 2.2k stars), Pixiu MCP Gateway (apache/dubbo-go-pixiu, 568 stars) and MCP API Key Authentication (Yourdaylight/stock_datasource, 188 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Agentmemory REST API?

rohitg00 (a GitHub user) maintains it in rohitg00/agentmemory, which has 29,188 GitHub stars. The repository holds 17 skills in this directory. The repository was last updated on October 6, 2026.

Source: rohitg00/agentmemory on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.