Agentmemory Rest Api
Look up every AgentMemory REST path and auth pattern when wiring your agent stack to the local memory server on port 3111.
Overview
agentmemory-rest-api is an agent skill for the Build phase that documents the full AgentMemory REST API on localhost:3111 for programmatic memory operations.
Install
npx skills add https://github.com/rohitg00/agentmemory --skill agentmemory-rest-apiWhat is this skill?
- Autogenerated catalog of 117 registered REST endpoints from src/triggers/api.ts
- Base URL http://localhost:3111 with optional AGENTMEMORY_SECRET Bearer auth
- Covers actions, checkpoints, consolidate pipelines, crystals, context, branch/worktree, and Claude-bridge routes
- Regenerate docs via npm run skills:gen after endpoint changes—do not hand-edit the autogen block
Adoption & trust: 3 installs on skills.sh; 21.9k GitHub stars; trending (+300% hot-view momentum).
What problem does it solve?
You are coding against AgentMemory but lack a single authoritative list of paths, methods, and auth headers.
Who is it for?
Solo builders shipping agent tooling who need HTTP-level integration with AgentMemory from scripts, services, or custom UIs.
Skip if: Teams that only need one-click MCP connect adapters without writing HTTP clients—use agentmemory-agents instead.
When should I use this skill?
You need exact Method and Path for AgentMemory HTTP calls or auth behavior on port 3111.
What do I get? / Deliverables
You can call the correct POST/GET routes for memory actions, consolidation, and bridges without spelunking src/triggers/api.ts.
- Correct REST path and method for a given memory operation
- Auth header pattern for secured installs
Recommended Skills
Journey fit
Canonical shelf is Build → integrations because this skill is the HTTP contract for connecting products and scripts to AgentMemory—not a launch or ops runbook. Integrations subphase covers third-party and first-party service hooks; a 117-endpoint REST map is the primary integration surface for memory CRUD, consolidation, and bridges.
How it compares
API reference skill for the memory server, not an MCP-only connect wizard.
Common Questions / FAQ
Who is agentmemory-rest-api for?
Indie developers and small teams building on AgentMemory who implement REST clients, webhooks, or debug calls outside MCP.
When should I use agentmemory-rest-api?
During Build integrations when you wire consolidate, checkpoints, or context endpoints; also in Operate when you script diagnostics or audit GETs against a running :3111 instance.
Is agentmemory-rest-api safe to install?
Treat it as documentation for a local service that can read and mutate agent memory; review the Security Audits panel on this Prism page and lock down AGENTMEMORY_SECRET before exposing the port.
Workflow Chain
Then invoke: agentmemory agents
SKILL.md
READMESKILL.md - Agentmemory Rest Api
# agentmemory REST API reference Generated from `src/triggers/api.ts`. Do not edit the block below by hand; run `npm run skills:gen` after changing the registered endpoints. <!-- AUTOGEN:rest START - generated by scripts/skills/generate.ts, do not edit by hand --> The REST API is the primary surface. All paths are under `http://localhost:3111` (override with `--port`). When `AGENTMEMORY_SECRET` is set, send `Authorization: Bearer $AGENTMEMORY_SECRET`; localhost is otherwise open. 117 registered endpoints: | Method | Path | | --- | --- | | POST | `/agentmemory/actions` | | POST | `/agentmemory/actions/edges` | | GET | `/agentmemory/actions/get` | | POST | `/agentmemory/actions/update` | | GET | `/agentmemory/audit` | | POST | `/agentmemory/auto-forget` | | GET | `/agentmemory/branch/detect` | | GET | `/agentmemory/branch/sessions` | | GET | `/agentmemory/branch/worktrees` | | POST | `/agentmemory/cascade-update` | | POST | `/agentmemory/checkpoints` | | POST | `/agentmemory/checkpoints/resolve` | | GET | `/agentmemory/claude-bridge/read` | | POST | `/agentmemory/claude-bridge/sync` | | GET | `/agentmemory/commits` | | POST | `/agentmemory/compress-file` | | GET | `/agentmemory/config/flags` | | POST | `/agentmemory/consolidate` | | POST | `/agentmemory/consolidate-pipeline` | | POST | `/agentmemory/context` | | GET | `/agentmemory/crystals` | | POST | `/agentmemory/crystals/auto` | | POST | `/agentmemory/crystals/create` | | POST | `/agentmemory/diagnostics` | | GET | `/agentmemory/diagnostics/followup` | | POST | `/agentmemory/diagnostics/heal` | | POST | `/agentmemory/enrich` | | POST | `/agentmemory/evict` | | POST | `/agentmemory/evolve` | | GET | `/agentmemory/export` | | POST | `/agentmemory/facets` | | POST | `/agentmemory/facets/query` | | POST | `/agentmemory/facets/remove` | | GET | `/agentmemory/facets/stats` | | POST | `/agentmemory/file-context` | | POST | `/agentmemory/flow/compress` | | POST | `/agentmemory/forget` | | GET | `/agentmemory/frontier` | | POST | `/agentmemory/generate-rules` | | POST | `/agentmemory/governance/bulk-delete` | | DELETE | `/agentmemory/governance/memories` | | POST | `/agentmemory/graph/build` | | POST | `/agentmemory/graph/extract` | | POST | `/agentmemory/graph/query` | | POST | `/agentmemory/graph/reset` | | POST | `/agentmemory/graph/snapshot-rebuild` | | GET | `/agentmemory/graph/stats` | | GET | `/agentmemory/health` | | POST | `/agentmemory/import` | | GET | `/agentmemory/insights` | | POST | `/agentmemory/insights/search` | | POST | `/agentmemory/leases/acquire` | | POST | `/agentmemory/leases/release` | | POST | `/agentmemory/leases/renew` | | POST | `/agentmemory/lessons` | | POST | `/agentmemory/lessons/search` | | POST | `/agentmemory/lessons/strengthen` | | GET | `/agentmemory/livez` | | GET | `/agentmemory/memories` | | GET | `/agentmemory/memories/:id` | | GET | `/agentmemory/mesh/export` | | POST | `/agentmemory/mesh/peers` | | POST | `/agentmemory/mesh/receive` | | POST | `/agentmemory/mesh/sync` | | POST | `/agentmemory/migrate` | | GET | `/agentmemory/next` | | GET | `/agentmemory/observations` | | POST | `/agentmemory/observe` | | POST | `/agentmemory/obsidian/export` | | POST | `/agentmemory/patterns` | | GET | `/agentmemory/procedural` | | GET | `/agentmemory/profile` | | POST | `/agentmemory/reflect` | | POST | `/agentmemory/relations` | | POST | `/agentmemory/remember` | | POST | `/agentmemory/replay/import-jsonl` | | GET | `/agentmemory/replay/load` | | GET | `/agentmemory/replay/sessions` | | POST | `/agentmemory/routines` | | POST | `/agentmemory/routines/run` | | GET | `/agentmemory/routines/status` | | POST | `/agentmemory/search` | | GET | `/agentmemory/semantic` | | POST | `/agentmemory/sentinels` | | POST | `/agentmemory/sentinels/cancel` | | POST | `/agentmemory/sentinels/check` | | POST | `/agentmemory/sentinels/trigger` | | GET | `/agentmemory/session/by-commit` | | POST | `/agentmemory/session/commit` | | POST | `/agentmemory/session/end` | | POS