Skip to main content
1

Start the server

One process starts the engine, the memory worker, the REST API on port 3111, and the viewer on port 3113.
npx caches per-version: a bare npx @agentmemory/agentmemory can serve a stale release from ~/.npm/_npx/. The global install avoids this; otherwise force fresh with npx -y @agentmemory/agentmemory@latest.
2

Wire up an agent

No argument opens an interactive picker over agents detected on your machine. connect <agent> wires one directly. Each adapter backs up the target config, writes the right integration (hooks for Claude Code, a capture plugin path for OpenCode, MCP wiring for the rest), and verifies the entry after writing. See Connectors for the flags and the full agent list.
3

Restart the agent

Wired agents pick up MCP servers and hooks on the next session. Restart the agent or open a new session; Claude Code and Copilot also reload after running /mcp inside a session.
4

Verify with a first recall

Generate some memory by running one prompt in the wired agent, or seed sample data:
Then search it:
A JSON result list means capture, indexing, and hybrid recall are all working. Open http://localhost:3113 and check the Sessions tab to watch observations arrive live.
No LLM key is required for any of the above: capture, indexing, and recall run keyless. A provider key adds compression, summarization, and consolidation; see Configuration.
Last modified on August 15, 2026