#1 Persistent memory for AI coding agents based on real-world benchmarks
TypeScript agentmemoryagentsaiclaudeclaudecodecodexcopilotcursorgenaiharnesshermesmemoryompopenclawopencodepi
docs: clarify env file setup (#321)
Aqil Azizec6282382be0
diff --git a/README.md b/README.mdindex 840a75c4..7fc7c306 100644--- a/README.md+++ b/README.md@@ -1059,7 +1059,7 @@ Full registry: [workers.iii.dev](https://workers.iii.dev). Every worker there co### LLM Providers-agentmemory auto-detects from your environment. No API key needed if you have a Claude subscription.+agentmemory auto-detects from your environment. By default, no LLM calls are made unless you configure a provider or explicitly opt in to the Claude subscription fallback.| Provider | Config | Notes ||----------|--------|-------|@@ -1070,6 +1070,33 @@ agentmemory auto-detects from your environment. No API key needed if you have a| OpenRouter | `OPENROUTER_API_KEY` | Any model || Claude subscription fallback | `AGENTMEMORY_ALLOW_AGENT_SDK=true` | Opt-in only. Spawns `@anthropic-ai/claude-agent-sdk` sessions — used to cause unbounded Stop-hook recursion (#149 follow-up) so it is no longer the default. |+### Config File++Put agentmemory runtime configuration in `~/.agentmemory/.env` instead of exporting variables in every shell. If the viewer shows a setup hint like `export ANTHROPIC_API_KEY=...`, copy it into this file as `ANTHROPIC_API_KEY=...` without the `export` prefix, then restart agentmemory.++Process environment variables still work and take precedence over values in the file.++On Windows, the same file lives at `%USERPROFILE%\.agentmemory\.env`:++```powershell+New-Item -ItemType Directory -Force $HOME\.agentmemory+notepad $HOME\.agentmemory\.env+```++To test with a Claude Code Pro/Max subscription instead of an API key, opt in explicitly:++```env+AGENTMEMORY_ALLOW_AGENT_SDK=true+AGENTMEMORY_AUTO_COMPRESS=true+```++Turn on graph or consolidation features in the same file if you want them:++```env+GRAPH_EXTRACTION_ENABLED=true+CONSOLIDATION_ENABLED=true+```+### Environment VariablesCreate `~/.agentmemory/.env`: