agentmemory reads configuration from the environment and from ~/.agentmemory/.env (one KEY=value per line, no export prefix). Restart the server after changing it.

Quick start

Enable richer memory and set a provider key in ~/.agentmemory/.env:

ANTHROPIC_API_KEY=sk-ant-...
AGENTMEMORY_AUTO_COMPRESS=true
AGENTMEMORY_INJECT_CONTEXT=true

Defaults worth knowing

• No API key is required. Without one, agentmemory runs zero-LLM with BM25 plus local embeddings.
• Token-spending features ship OFF on purpose: AGENTMEMORY_AUTO_COMPRESS (LLM summaries) and AGENTMEMORY_INJECT_CONTEXT (auto context injection) both cost tokens proportional to tool-use frequency.
• Tool visibility: AGENTMEMORY_TOOLS=all (default) or core for the lean set.
• Auth: set AGENTMEMORY_SECRET to require Authorization: Bearer on the REST API.

Ports

REST is the anchor at 3111. Streams = N+1 (3112), viewer = N+2 (3113), engine = N+46023 (49134). Relocate the whole block with --port <N> or --instance <N>.

See also

• agentmemory-rest-api for how the secret is used.
• agentmemory-architecture for the port quartet rationale.

Reference

The full recognized-variable list lives in REFERENCE.md, generated by scanning src/.