Environment Variables

Both memtomem (LTM) and memtomem-stm (STM) use pydantic-settings with env_prefix + env_nested_delimiter="__". Nested settings use double underscore — MEMTOMEM_EMBEDDING__PROVIDER, not MEMTOMEM_EMBEDDING_PROVIDER.

Resolution order (highest priority first): CLI flags → environment variables → config file → built-in defaults.

This public reference tracks the complete memtomem 0.3.12 and memtomem-stm 0.1.41 configuration surfaces. Options are intentionally mirrored here rather than reduced to a curated subset.

LTM (memtomem) — prefix MEMTOMEM_

Storage

Variable	Description	Default
MEMTOMEM_STORAGE__BACKEND	Storage backend	sqlite
MEMTOMEM_STORAGE__SQLITE_PATH	SQLite database file path	~/.memtomem/memtomem.db
MEMTOMEM_STORAGE__COLLECTION_NAME	Logical collection name	memories

Embedding

Variable	Description	Default
MEMTOMEM_EMBEDDING__PROVIDER	none / onnx / ollama / openai	none (keyword-only until mm init runs)
MEMTOMEM_EMBEDDING__MODEL	Model name for the chosen provider	""
MEMTOMEM_EMBEDDING__DIMENSION	Vector dimension (must match model)	provider-specific
MEMTOMEM_EMBEDDING__BASE_URL	Ollama / OpenAI-compatible endpoint	—
MEMTOMEM_EMBEDDING__API_KEY	API key for paid providers	—
MEMTOMEM_EMBEDDING__BATCH_SIZE	Texts per embedding batch	64
MEMTOMEM_EMBEDDING__ONNX_BATCH_SIZE	Texts per local FastEmbed/ONNX inference batch; runtime-mutable	8
MEMTOMEM_EMBEDDING__MAX_SEQUENCE_TOKENS	Actual-token cap per local ONNX input; 0 restores the model limit. Restart after changing it and force-reindex existing content so vectors use one policy.	1024
MEMTOMEM_EMBEDDING__ONNX_CPU_MEM_ARENA	Reuse ONNX CPU allocations. Restart required; this allocator-only switch does not require re-indexing.	false
MEMTOMEM_EMBEDDING__MAX_CONCURRENT_BATCHES	Max parallel embedding batches	4
MEMTOMEM_EMBEDDING__THREADS	ONNX Runtime thread cap (0 = ORT default)	4
MEMTOMEM_EMBEDDING__PROGRESS_THRESHOLD	Emit per-chunk progress only when a file produces more chunks than this threshold; 0 always emits	32

Indexing

Variable	Description	Default
MEMTOMEM_INDEXING__MEMORY_DIRS	Directories reactively re-indexed by the long-running memtomem-server file watcher (JSON list). Pre-existing files are not auto-scanned — seed them once with mm index <dir>, then the watcher picks up further edits. Populated by mm init when you opt in to AI agent memory enrollment.	["~/.memtomem/memories"] plus selected provider folders
MEMTOMEM_INDEXING__PROJECT_MEMORY_DIRS	Project-tier memory roots under .memtomem/memories or .memtomem/memories.local	[]
MEMTOMEM_INDEXING__SUPPORTED_EXTENSIONS	File extensions to index (JSON list)	[".md", ".json", ".yaml", ".yml", ".toml", ".py", ".js", ".ts", ".tsx", ".jsx"]
MEMTOMEM_INDEXING__MAX_CHUNK_TOKENS	Maximum tokens per chunk	512
MEMTOMEM_INDEXING__MIN_CHUNK_TOKENS	Merge threshold for short chunks	128
MEMTOMEM_INDEXING__AUTO_DISCOVER	Deprecated one-shot migration trigger. Existing configs convert detected provider directories into explicit memory_dirs, persist them, and flip this field to false; new installs skip the migration. Use mm init --include-provider ... for new configuration.	true compatibility default
MEMTOMEM_INDEXING__EXCLUDE_PATTERNS	.gitignore-syntax patterns (JSON list) that stack on top of the built-in credential denylist (oauth_creds.json, credentials*, id_rsa*, *.pem, *.key, .ssh/**, …). User !negation cannot override the built-in secret patterns.	[]
MEMTOMEM_INDEXING__TARGET_CHUNK_TOKENS	Greedy semantic-pack target for short sibling sections. Set 0 to disable the pack pass.	384
MEMTOMEM_INDEXING__CHUNK_OVERLAP_TOKENS	Token overlap between adjacent chunks	0
MEMTOMEM_INDEXING__STRUCTURED_CHUNK_MODE	JSON/YAML/TOML chunking mode: original or recursive	original
MEMTOMEM_INDEXING__PARAGRAPH_SPLIT_THRESHOLD	Split long prose into paragraphs above this token count	800
MEMTOMEM_INDEXING__STARTUP_BACKFILL	On server start, run a one-shot scan over memory_dirs to catch files added while the server was down	false
MEMTOMEM_INDEXING__AUTO_SUMMARIZE	Generate AI per-source summaries when LLM is configured	false
MEMTOMEM_INDEXING__SUMMARY_LANGUAGE	Output language for AI source summaries	en
MEMTOMEM_INDEXING__SUMMARY_MAX_INPUT_CHARS	Max source chars sent to the summary LLM	3000
MEMTOMEM_INDEXING__SUMMARY_MAX_TOKENS	Summary output token cap	256

Namespace Policy Rules

Path-glob → namespace mappings that auto-tag files at index time, so you don’t pass namespace= on every mem_index call.

Variable	Description	Default
MEMTOMEM_NAMESPACE__RULES	JSON list of {path_glob, namespace} objects. pathspec.GitIgnoreSpec patterns, case-insensitive. {parent} and {ancestor:N} placeholders expand from the matched file path. Resolution order: explicit namespace= param → rules (first match) → enable_auto_ns → default_namespace.	[]
MEMTOMEM_NAMESPACE__DEFAULT_NAMESPACE	Default namespace for new chunks	default
MEMTOMEM_NAMESPACE__ENABLE_AUTO_NS	Derive namespace from a file’s immediate parent folder when no explicit namespace or rule applies	false

Example (via config.d/namespace.json, APPEND-merged):

{"namespace": {"rules": [
  {"path_glob": "docs/**", "namespace": "docs"},
  {"path_glob": "projects/{parent}/**", "namespace": "proj/{parent}"}
]}}

Reranking

Cross-encoder reranking runs fully locally by default — no external API required.

Variable	Description	Default
MEMTOMEM_RERANK__ENABLED	Enable reranking of hybrid search results	false
MEMTOMEM_RERANK__PROVIDER	fastembed (local ONNX) / cohere (external API)	fastembed
MEMTOMEM_RERANK__MODEL	Model name. Use jinaai/jina-reranker-v2-base-multilingual for non-English content.	Xenova/ms-marco-MiniLM-L-6-v2
MEMTOMEM_RERANK__API_KEY	Only required when provider=cohere	—
MEMTOMEM_RERANK__OVERSAMPLE	Pool multiplier over response_top_k. Pool size is max(min_pool, min(max_pool, int(oversample * response_top_k))).	2.0
MEMTOMEM_RERANK__MIN_POOL	Floor — reranker never sees fewer candidates than this	20
MEMTOMEM_RERANK__MAX_POOL	Cap — prevents runaway cost at large top_k	200
MEMTOMEM_RERANK__TOP_K	Deprecated legacy pool size; migrates to min_pool when present	20

Search

Variable	Description	Default
MEMTOMEM_SEARCH__DEFAULT_TOP_K	Default result count	10
MEMTOMEM_SEARCH__BM25_CANDIDATES	BM25 candidate pool size	50
MEMTOMEM_SEARCH__DENSE_CANDIDATES	Dense vector candidate pool size	50
MEMTOMEM_SEARCH__RRF_K	Reciprocal Rank Fusion constant	60
MEMTOMEM_SEARCH__ENABLE_BM25	Enable keyword retriever	true
MEMTOMEM_SEARCH__ENABLE_DENSE	Enable semantic vector retriever	true
MEMTOMEM_SEARCH__RRF_WEIGHTS	RRF weights for [BM25, Dense] (JSON list, REPLACE merge)	[1.0, 1.0]
MEMTOMEM_SEARCH__TOKENIZER	FTS tokenizer: unicode61 or kiwipiepy	unicode61
MEMTOMEM_SEARCH__CACHE_TTL	Search result cache TTL in seconds	30.0
MEMTOMEM_SEARCH__SYSTEM_NAMESPACE_PREFIXES	Namespace prefixes hidden from default namespace=None search (JSON list, APPEND merge)	["archive:", "agent-runtime:"]

Decay (time-based scoring)

Half-life decay multiplier applied to hybrid-search scores. Gradually deprioritises older chunks.

Variable	Description	Default
MEMTOMEM_DECAY__ENABLED	Enable time-based decay weighting	false
MEMTOMEM_DECAY__HALF_LIFE_DAYS	Half-life in days — a chunk’s contribution halves every interval	30.0

MMR (diversity rerank)

Maximal Marginal Relevance rerank. Reduces redundancy among top results and mixes in alternate angles.

Variable	Description	Default
MEMTOMEM_MMR__ENABLED	Enable MMR diversity rerank	false
MEMTOMEM_MMR__LAMBDA_PARAM	0.0–1.0. 0.0 = max diversity, 1.0 = max relevance	0.7

Access (frequency boost)

Frequency-based multiplier that promotes chunks which have been accessed often.

Variable	Description	Default
MEMTOMEM_ACCESS__ENABLED	Enable access-frequency boost	false
MEMTOMEM_ACCESS__MAX_BOOST	Score multiplier ceiling (must be >= 1.0)	1.5

Importance (metadata boost)

Multiplier derived from chunk metadata features (tags, size, position, …) applied on top of the search score.

Variable	Description	Default
MEMTOMEM_IMPORTANCE__ENABLED	Enable importance boost	false
MEMTOMEM_IMPORTANCE__MAX_BOOST	Score multiplier ceiling (must be >= 1.0)	1.5
MEMTOMEM_IMPORTANCE__WEIGHTS	Importance-feature weight vector (JSON list, REPLACE merge)	[0.3, 0.2, 0.3, 0.2]

Query expansion

Augments the original query with related tags, headings, or LLM-generated terms to improve recall. strategy=llm uses the LLM section below.

Variable	Description	Default
MEMTOMEM_QUERY_EXPANSION__ENABLED	Enable query expansion	false
MEMTOMEM_QUERY_EXPANSION__MAX_TERMS	Max additional terms to append	3
MEMTOMEM_QUERY_EXPANSION__STRATEGY	tags / headings / both / llm	tags

Context window

Small-to-big retrieval: returns ±N adjacent chunks around each search hit. Useful for recovering fragmented context in long documents.

Variable	Description	Default
MEMTOMEM_CONTEXT_WINDOW__ENABLED	Enable context-window expansion	false
MEMTOMEM_CONTEXT_WINDOW__WINDOW_SIZE	±N adjacent chunks per hit (0–10)	2

LLM (summarisation · query-expansion backend)

Shared LLM backend used by query_expansion.strategy=llm, consolidation summaries, and other LLM-powered features.

Variable	Description	Default
MEMTOMEM_LLM__ENABLED	Enable LLM-powered features	false
MEMTOMEM_LLM__PROVIDER	ollama / openai / anthropic / compatible endpoint	ollama
MEMTOMEM_LLM__MODEL	Model name. Empty = provider-specific default	""
MEMTOMEM_LLM__BASE_URL	Endpoint URL	http://localhost:11434
MEMTOMEM_LLM__API_KEY	API key for paid providers	—
MEMTOMEM_LLM__MAX_TOKENS	Generation token cap	1024
MEMTOMEM_LLM__TIMEOUT	Request timeout in seconds	60.0

Tool exposure

Variable	Description	Default
MEMTOMEM_TOOL_MODE	core (9 names incl. mem_do) / standard (38) / full (99 current tools + deprecated mem_context_migrate alias)	core

Web UI

Variable	Description	Default
MEMTOMEM_WEB__MODE	prod (standard Simple/Advanced pages, including Namespaces under Settings) / dev (also adds maintainer pages: Sessions, Search Runs, Quality Lab, Working Memory, Procedures, Health Report, Redaction). mm web --mode and mm web --dev override this at launch.	prod
MEMTOMEM_WEB__HOST	Bind address for mm web; overridden by --host	127.0.0.1
MEMTOMEM_WEB__PORT	Bind port for mm web; overridden by --port	8080
MEMTOMEM_WEB__CSRF_ENFORCE	Enforce CSRF protection on mutating Web UI endpoints. Disable only as an emergency rollback.	true

Lifecycle policies & webhooks

Variable	Description	Default
MEMTOMEM_POLICY__ENABLED	Run PolicyScheduler (auto_archive / auto_promote / auto_expire / auto_tag)	false
MEMTOMEM_POLICY__SCHEDULER_INTERVAL_MINUTES	Scheduler tick interval	60.0
MEMTOMEM_POLICY__MAX_ACTIONS_PER_RUN	Cumulative action cap per scheduled policy run	100
MEMTOMEM_WEBHOOK__ENABLED	Enable outbound webhooks for memory events	false
MEMTOMEM_WEBHOOK__URL	Webhook target URL	—
MEMTOMEM_WEBHOOK__EVENTS	Event types to send (JSON list, APPEND merge)	["add", "delete", "search"]
MEMTOMEM_WEBHOOK__SECRET	HMAC signing secret	—
MEMTOMEM_WEBHOOK__TIMEOUT_SECONDS	HTTP timeout	10.0

Consolidation schedule

Background job that periodically groups near-duplicate memories and compresses them into archive summaries.

Variable	Description	Default
MEMTOMEM_CONSOLIDATION_SCHEDULE__ENABLED	Run the consolidation scheduler	false
MEMTOMEM_CONSOLIDATION_SCHEDULE__INTERVAL_HOURS	Scheduler interval (hours)	24.0
MEMTOMEM_CONSOLIDATION_SCHEDULE__MIN_GROUP_SIZE	Minimum group size to consolidate	3
MEMTOMEM_CONSOLIDATION_SCHEDULE__MAX_GROUPS	Max groups processed per run	10

Warmup

Variable	Description	Default
MEMTOMEM_WARMUP__ENABLED	Pre-load local embedding/reranker models in a background task at MCP server startup. Remote providers are skipped.	false

Health watchdog

Background loop for periodic health checks, orphan-record cleanup, and automatic maintenance.

Variable	Description	Default
MEMTOMEM_HEALTH_WATCHDOG__ENABLED	Run the health watchdog	false
MEMTOMEM_HEALTH_WATCHDOG__HEARTBEAT_INTERVAL_SECONDS	Heartbeat interval	60.0
MEMTOMEM_HEALTH_WATCHDOG__DIAGNOSTIC_INTERVAL_SECONDS	Diagnostic-check interval	300.0
MEMTOMEM_HEALTH_WATCHDOG__DEEP_INTERVAL_SECONDS	Deep-scan interval	3600.0
MEMTOMEM_HEALTH_WATCHDOG__MAX_SNAPSHOTS	Snapshot retention cap	1000
MEMTOMEM_HEALTH_WATCHDOG__ORPHAN_CLEANUP_THRESHOLD	Orphan-record cleanup threshold	10
MEMTOMEM_HEALTH_WATCHDOG__AUTO_MAINTENANCE	Perform automatic maintenance	true

Scheduler

Variable	Description	Default
MEMTOMEM_SCHEDULER__ENABLED	Enable cron dispatch for registered maintenance jobs	false
MEMTOMEM_SCHEDULER__MAX_CONCURRENT_JOBS	Max concurrently running scheduled jobs	1
MEMTOMEM_SCHEDULER__DEFAULT_TIMEZONE	Schedule timezone; Phase A honors utc	utc
MEMTOMEM_SCHEDULER__RUNNER_TIMEOUT_SECONDS	Timeout for one scheduled job run	300.0

Session summary

Variable	Description	Default
MEMTOMEM_SESSION_SUMMARY__AUTO	Auto-generate an LLM summary on mem_session_end when enough chunks were added	true
MEMTOMEM_SESSION_SUMMARY__MIN_CHUNKS	Minimum chunks before auto-summary runs	5
MEMTOMEM_SESSION_SUMMARY__MAX_SUMMARY_TOKENS	Output token cap	500
MEMTOMEM_SESSION_SUMMARY__MAX_INPUT_CHARS	Skip auto-summary above this assembled input size	60000
MEMTOMEM_SESSION_SUMMARY__MAX_SUMMARY_LINKS	Cap summary-to-source chunk links	50
MEMTOMEM_SESSION_SUMMARY__EXPANSION_LOOKUP_TOP_K	Session-summary chunks considered for search rescue	3
MEMTOMEM_SESSION_SUMMARY__EXPANSION_SCORE_THRESHOLD	Minimum summary score for rescue expansion	0.3
MEMTOMEM_SESSION_SUMMARY__EXPANSION_RESCUE_WEIGHT	RRF input weight for rescued source-file hits	0.5

Session tracing

Traces session command execution to a JSONL file and, optionally, to Langfuse. Off by default. payload_mode defaults to metadata, which records no payload body; redacted keeps a secret-masked body, and full keeps the entire body.

Variable	Description	Default
MEMTOMEM_SESSION_TRACE__ENABLED	Enable session execution tracing	false
MEMTOMEM_SESSION_TRACE__JSONL_ENABLED	Write to the JSONL sink	true
MEMTOMEM_SESSION_TRACE__JSONL_PATH	JSONL output file path	~/.memtomem/traces/session-traces.jsonl
MEMTOMEM_SESSION_TRACE__LANGFUSE_ENABLED	Emit traces to the Langfuse sink	false
MEMTOMEM_SESSION_TRACE__LANGFUSE_PUBLIC_KEY	Langfuse public key	""
MEMTOMEM_SESSION_TRACE__LANGFUSE_SECRET_KEY	Langfuse secret key	""
MEMTOMEM_SESSION_TRACE__LANGFUSE_HOST	Langfuse host URL	""
MEMTOMEM_SESSION_TRACE__SAMPLING_RATE	0.0–1.0. Fraction of sessions recorded	1.0
MEMTOMEM_SESSION_TRACE__PAYLOAD_MODE	metadata (no body) / redacted (secret-masked body) / full (entire body)	metadata
MEMTOMEM_SESSION_TRACE__MAX_PAYLOAD_CHARS	Char cap on payload retained in a trace	10000

Setting langfuse_enabled=true requires the langfuse extra installed and both the public and secret keys set; otherwise startup validation fails.

Logging

Variable	Description	Default
MEMTOMEM_LOG_LEVEL	DEBUG / INFO / WARNING / ERROR	INFO
MEMTOMEM_LOG_FORMAT	Log format	—

Hooks / Context Gateway

Variable	Description	Default
MEMTOMEM_HOOKS__TARGET_SCOPE	Scope for memtomem-managed Claude Code settings hooks: user, project_shared, or project_local	user
MEMTOMEM_CONTEXT_GATEWAY__KNOWN_PROJECTS_PATH	Web UI project registry for Context Gateway	~/.memtomem/known_projects.json
MEMTOMEM_CONTEXT_GATEWAY__EXPERIMENTAL_CLAUDE_PROJECTS_SCAN	Decode ~/.claude/projects/<encoded> directory names back into project roots and scan them (includes unverified candidates)	false
MEMTOMEM_CONTEXT_GATEWAY__AUTO_DISPLAY_CONFIGURED_PROJECTS	Auto-display a scanned project only when its root carries a recognized runtime marker (.claude/.gemini/.codex/.agents/.kimi/.memtomem)	true

User-tier writes are protected by explicit host-write confirmation; there is no USER_TIER_ENABLED configuration field.

Advanced / operator paths

These process-level variables are not part of the layered config.json / config.d model.

Variable	Description	Default
MEMTOMEM_WIKI_PATH	Override the wiki store location	~/.memtomem-wiki
MEMTOMEM_FASTEMBED_CACHE	Override the ONNX / FastEmbed model cache	platform cache directory
MEMTOMEM_INDEX_DEBOUNCE_QUEUE	Override the file-watcher debounce queue file	state directory

Embedding provider comparison

Provider	GPU	Cost	Notes
onnx	No	Free	Built-in via fastembed. ~270 MB on first run
ollama	No	Free	Requires Ollama. ollama pull nomic-embed-text
openai	No	Paid	Requires API key

Full list: configuration.md in the upstream repo.

STM (memtomem-stm) — prefix MEMTOMEM_STM_

STM settings are organized into root fields plus PROXY__*, SURFACING__*, FORMATION__*, HOOK__*, DAEMON__*, and LANGFUSE__*. Compression, caching, metrics, auto-indexing, and extraction all live under PROXY__.

~/.memtomem/stm_proxy.json loads ProxyConfig only. Root, surfacing, formation, hook, daemon, and Langfuse settings are environment/default-only; placing those blocks in the JSON file has no effect. proxy.consumer_model propagation into surfacing budget resolution is the documented exception.

General

Variable	Description	Default
MEMTOMEM_STM_DATA_DIR	Daemon handshake, ownership lock, and detached log directory	~/.memtomem
MEMTOMEM_STM_LOG_LEVEL	Log level	WARNING
MEMTOMEM_STM_LOG_FILE	Optional rotating log file; files use 0600, 2 MiB rotation, and three backups	unset
MEMTOMEM_STM_ADVERTISE_OBSERVABILITY_TOOLS	When true, advertises eight observability/admin tools (stm_proxy_stats, stm_proxy_health, stm_proxy_cache_clear, stm_surfacing_stats, stm_selection_stats, stm_compression_stats, stm_progressive_stats, stm_tuning_recommendations). The four model-facing tools remain visible when false.	false
MEMTOMEM_STM_FORMATION__ENABLED	Advertise the opt-in stm_memory_propose tool. This flag alone controls advertisement; upstream LTM support for review-first proposals is checked at call time (an incompatible core returns formation_unsupported).	false
MEMTOMEM_STM_FORMATION__MAX_CONTENT_CHARS	Maximum review-first candidate content size; larger proposals are rejected	2000

Proxy

Variable	Description	Default
MEMTOMEM_STM_PROXY__ENABLED	Master switch for the proxy pipeline	false
MEMTOMEM_STM_PROXY__CONFIG_PATH	Proxy JSON configuration path	~/.memtomem/stm_proxy.json
MEMTOMEM_STM_PROXY__UPSTREAM_SERVERS	Complete upstream-server map as a JSON object; the file-backed form is usually easier to maintain	{}
MEMTOMEM_STM_PROXY__DEFAULT_COMPRESSION	Default compression strategy	auto
MEMTOMEM_STM_PROXY__DEFAULT_MAX_RESULT_CHARS	Per-response char budget	16000
MEMTOMEM_STM_PROXY__MAX_UPSTREAM_CHARS	OOM guard on upstream response size	10000000
MEMTOMEM_STM_PROXY__MIN_RESULT_RETENTION	Retention floor (0.0–1.0)	0.65
MEMTOMEM_STM_PROXY__MAX_DESCRIPTION_CHARS	Maximum advertised tool-description length	200
MEMTOMEM_STM_PROXY__STRIP_SCHEMA_DESCRIPTIONS	Remove nested JSON-schema descriptions from advertised tools	false
MEMTOMEM_STM_PROXY__ADVERTISE_CONTEXT_QUERY	Advertise the optional _context_query argument used for relevance scoring	false
MEMTOMEM_STM_PROXY__CONSUMER_MODEL	Client model identifier used to resolve its context-window budget	""
MEMTOMEM_STM_PROXY__CONTEXT_BUDGET_RATIO	Fraction of the consumer context window available to a proxied result	0.05
MEMTOMEM_STM_PROXY__CHARS_PER_TOKEN	Static character-to-token estimate used for token budgets	3.5
MEMTOMEM_STM_PROXY__TOKEN_ESTIMATION_MODE	Token estimate mode: static or Unicode-aware unicode	static

Proxy → Cache

Variable	Description	Default
MEMTOMEM_STM_PROXY__CACHE__ENABLED	Enable response caching	true
MEMTOMEM_STM_PROXY__CACHE__DEFAULT_TTL_SECONDS	Cache TTL	3600
MEMTOMEM_STM_PROXY__CACHE__DB_PATH	Cache DB location	~/.memtomem/proxy_cache.db
MEMTOMEM_STM_PROXY__CACHE__MAX_ENTRIES	Cache eviction ceiling	10000
MEMTOMEM_STM_PROXY__CACHE__TOOL_ANNOTATION_POLICY	How MCP tool annotations affect caching: conservative, strict, or ignore	conservative

Cache schema 4 stores the canonical MCP content envelope, including structuredContent and _meta. On an incompatible older schema, STM performs its documented one-time cache reset rather than serving a mixed envelope.

Proxy → Auto-Index (Stage 4)

Variable	Description	Default
MEMTOMEM_STM_PROXY__AUTO_INDEX__ENABLED	Index tool responses into LTM	false
MEMTOMEM_STM_PROXY__AUTO_INDEX__BACKGROUND	Run indexing in the background, off the request path	false
MEMTOMEM_STM_PROXY__AUTO_INDEX__MIN_CHARS	Minimum response size to index	2000
MEMTOMEM_STM_PROXY__AUTO_INDEX__MEMORY_DIR	Output directory	~/.memtomem/proxy_index
MEMTOMEM_STM_PROXY__AUTO_INDEX__NAMESPACE	Namespace for auto-indexed memories	proxy-{server}

The bundled mms server reads from LTM but, by design, does not write back to it. These auto_index and extraction fields are therefore accepted as valid config but have no effect on its behavior.

Proxy → Extraction

Variable	Description	Default
MEMTOMEM_STM_PROXY__EXTRACTION__ENABLED	Stage 4b EXTRACT (fact extraction)	false
MEMTOMEM_STM_PROXY__EXTRACTION__STRATEGY	Extraction strategy: none, llm, heuristic, or hybrid	llm
MEMTOMEM_STM_PROXY__EXTRACTION__LLM__PROVIDER	Extraction LLM provider: openai, anthropic, or ollama	openai
MEMTOMEM_STM_PROXY__EXTRACTION__LLM__MODEL	Extraction LLM model	gpt-4.1-mini
MEMTOMEM_STM_PROXY__EXTRACTION__LLM__API_KEY	Extraction LLM API key	""
MEMTOMEM_STM_PROXY__EXTRACTION__LLM__BASE_URL	Extraction LLM endpoint override	""
MEMTOMEM_STM_PROXY__EXTRACTION__LLM__SYSTEM_PROMPT	Extraction system-prompt template	built-in template
MEMTOMEM_STM_PROXY__EXTRACTION__LLM__MAX_TOKENS	Extraction LLM output-token cap	500
MEMTOMEM_STM_PROXY__EXTRACTION__LLM__LLM_TIMEOUT_SECONDS	Extraction LLM timeout	60.0
MEMTOMEM_STM_PROXY__EXTRACTION__LLM__PRIVACY_SCAN_ENABLED	Scan content before sending it to a remote extraction LLM	true
MEMTOMEM_STM_PROXY__EXTRACTION__MAX_FACTS	Maximum extracted facts per response	10
MEMTOMEM_STM_PROXY__EXTRACTION__MIN_RESPONSE_CHARS	Minimum response size eligible for extraction	500
MEMTOMEM_STM_PROXY__EXTRACTION__DEDUP_THRESHOLD	Extracted-fact similarity threshold	0.92
MEMTOMEM_STM_PROXY__EXTRACTION__MEMORY_DIR	Extracted-fact output directory	~/.memtomem/extracted_facts
MEMTOMEM_STM_PROXY__EXTRACTION__NAMESPACE	Extracted-fact namespace template	facts-{server}
MEMTOMEM_STM_PROXY__EXTRACTION__BACKGROUND	Run extraction outside the request path	true
MEMTOMEM_STM_PROXY__EXTRACTION__MAX_INPUT_CHARS	Maximum response text considered for extraction	20000

Proxy → Metrics / feedback / relevance scorer

Variable	Description	Default
MEMTOMEM_STM_PROXY__METRICS__ENABLED	Record call metrics	true
MEMTOMEM_STM_PROXY__METRICS__DB_PATH	Proxy metrics SQLite path	~/.memtomem/proxy_metrics.db
MEMTOMEM_STM_PROXY__METRICS__MAX_HISTORY	Maximum retained metrics rows	10000
MEMTOMEM_STM_PROXY__RELEVANCE_SCORER__SCORER	Scorer backend	—
MEMTOMEM_STM_PROXY__RELEVANCE_SCORER__EMBEDDING_PROVIDER	Embedding provider for semantic relevance scoring	ollama
MEMTOMEM_STM_PROXY__RELEVANCE_SCORER__EMBEDDING_MODEL	Relevance embedding model	nomic-embed-text
MEMTOMEM_STM_PROXY__RELEVANCE_SCORER__EMBEDDING_BASE_URL	Relevance embedding endpoint	unset
MEMTOMEM_STM_PROXY__RELEVANCE_SCORER__EMBEDDING_TIMEOUT	Relevance embedding request timeout	10.0
MEMTOMEM_STM_PROXY__COMPRESSION_FEEDBACK__ENABLED	Persist stm_compression_feedback	true
MEMTOMEM_STM_PROXY__COMPRESSION_FEEDBACK__DB_PATH	Compression feedback SQLite path	~/.memtomem/stm_feedback.db
MEMTOMEM_STM_PROXY__COMPRESSION_FEEDBACK__RETENTION_DAYS	Compression feedback retention	90
MEMTOMEM_STM_PROXY__PROGRESSIVE_READS__ENABLED	Record progressive-delivery read telemetry (surfaces via stm_progressive_stats)	true
MEMTOMEM_STM_PROXY__PROGRESSIVE_READS__DB_PATH	Progressive-read telemetry SQLite path	~/.memtomem/stm_feedback.db
MEMTOMEM_STM_PROXY__PROGRESSIVE_READS__RETENTION_DAYS	Progressive-read telemetry retention	90
MEMTOMEM_STM_PROXY__LOCK_TIMEOUT_SECONDS	Internal lock-acquisition ceiling; a timeout signals a deadlock/stuck holder rather than a slow upstream	30.0

Proxy → Tool exposure

An STM-native filter that decides, at tool-advertisement time, which of an upstream’s tools the agent gets to see. Tools that fail consistently, carry credentials, or duplicate another tool’s name are kept out of the advertised list. Health signals are evaluated once at proxy startup, so the advertised set stays stable for the session.

Variable	Description	Default
MEMTOMEM_STM_PROXY__EXPOSURE__PROFILE	strict (signal rules hard-reject) / review (demote in ranking instead of rejecting, recorded in telemetry) / explore (signal rules off)	strict
MEMTOMEM_STM_PROXY__EXPOSURE__HEALTH_WINDOW_HOURS	Look-back window over the metrics store for per-tool health	24.0
MEMTOMEM_STM_PROXY__EXPOSURE__HEALTH_MIN_CALLS	Minimum calls in the window before health is judged; below this a tool is presumed healthy	5
MEMTOMEM_STM_PROXY__EXPOSURE__HEALTH_ERROR_RATE_THRESHOLD	Upstream-attributable error rate at or above which a tool is flagged unhealthy	0.95
MEMTOMEM_STM_PROXY__EXPOSURE__REVIEW_RISK_PENALTY	Ranking-demotion multiplier applied to signal-flagged tools under the review profile	0.5

Proxy → Selection telemetry / Tool relevance

Records one selection + execution entry per proxied call as JSONL, and BM25-ranks the advertised tool set against the call’s query signal. Ranking is recorded into telemetry only — it never changes exposure.

Variable	Description	Default
MEMTOMEM_STM_PROXY__SELECTION_TELEMETRY__ENABLED	Enable per-call selection/execution JSONL records	false
MEMTOMEM_STM_PROXY__SELECTION_TELEMETRY__PATH	JSONL log path	~/.memtomem/stm_selection_log.jsonl
MEMTOMEM_STM_PROXY__SELECTION_TELEMETRY__SAMPLE_RATE	0.0–1.0. Fraction of calls recorded	1.0
MEMTOMEM_STM_PROXY__SELECTION_TELEMETRY__MAX_BYTES	Rotate the log at this size	50000000
MEMTOMEM_STM_PROXY__SELECTION_TELEMETRY__MAX_BACKUPS	Rotated files kept (0 truncates instead)	3
MEMTOMEM_STM_PROXY__TOOL_RELEVANCE__ENABLED	Record per-call BM25 tool ranking; only takes effect when selection_telemetry is on	true
MEMTOMEM_STM_PROXY__TOOL_RELEVANCE__TOP_N	Ranked candidates recorded per selection event	20

Proxy → Tool-graph eligibility (optional)

Consults a separate tool-graph MCP server for cross-server authorization / data-flow eligibility and feeds the verdict into the exposure filter as an extra rule source. Off by default. The graph server is consulted, never proxied — the client never sees its tools.

Variable	Description	Default
MEMTOMEM_STM_PROXY__TOOLGRAPH__ENABLED	Enable the external tool-graph eligibility provider	false
MEMTOMEM_STM_PROXY__TOOLGRAPH__SOURCE	Policy source: live stdio consult or signed bundle file	stdio
MEMTOMEM_STM_PROXY__TOOLGRAPH__BUNDLE_PATH	Local policy-bundle path used when source=bundle	~/.memtomem/toolgraph/policy-bundle.json
MEMTOMEM_STM_PROXY__TOOLGRAPH__COMMAND	Launch command for the stdio tool-graph MCP server	toolgraph
MEMTOMEM_STM_PROXY__TOOLGRAPH__ARGS	Command args (JSON list)	["serve"]
MEMTOMEM_STM_PROXY__TOOLGRAPH__ENV	Extra environment for the graph server (e.g. NEO4J_*, JSON object)	null
MEMTOMEM_STM_PROXY__TOOLGRAPH__AGENT_ID	Identity (registered in the graph) that eligibility is authorized against	stm-proxy
MEMTOMEM_STM_PROXY__TOOLGRAPH__SERVER_NAME_MAP	Map STM upstream names to graph server identities (JSON object)	{}
MEMTOMEM_STM_PROXY__TOOLGRAPH__QUERY_PROFILE	Profile passed to the graph consult	strict
MEMTOMEM_STM_PROXY__TOOLGRAPH__ON_UNREACHABLE	Graph unreachable: open (advertise per STM-native rules) / closed (withhold every tool the graph did not bless)	open
MEMTOMEM_STM_PROXY__TOOLGRAPH__ON_TOOL_NOT_FOUND	Candidate not in the graph: open / closed	open
MEMTOMEM_STM_PROXY__TOOLGRAPH__ON_AGENT_NOT_FOUND	agent_id unknown (usually a typo): fail_start / open / closed	fail_start
MEMTOMEM_STM_PROXY__TOOLGRAPH__ON_PROTOCOL_ERROR	Graph response contract violation: fail_start / open / closed	fail_start
MEMTOMEM_STM_PROXY__TOOLGRAPH__RISK_PENALTY_SCALE	Ranking-demotion multiplier for eligible-but-risky tools	1.0
MEMTOMEM_STM_PROXY__TOOLGRAPH__TIMEOUT_SECONDS	Per-consult timeout	5.0
MEMTOMEM_STM_PROXY__TOOLGRAPH__CONSULT_CACHE_ENABLED	Disk-cache a successful consult’s verdict	true
MEMTOMEM_STM_PROXY__TOOLGRAPH__CONSULT_CACHE_PATH	SQLite path for the consult cache	~/.memtomem/toolgraph_consult.db
MEMTOMEM_STM_PROXY__TOOLGRAPH__CONSULT_CACHE_MAX_SCOPES	Maximum cached tool-set scopes	64

A typed backend_unavailable result follows on_unreachable; unknown or malformed result envelopes follow on_protocol_error.

Per-upstream (UpstreamServerConfig)

These live on per-upstream UpstreamServerConfig entries in ~/.memtomem/stm_proxy.json (set per server, not via individual scalar env vars). Every accepted field is listed below.

Field	Description	Default
command	stdio server executable	""
args	stdio server arguments	[]
env	additional server environment	null
cwd	server working directory	null
prefix	required namespace segment used in composed tool names	required
transport	stdio, sse, or streamable_http	stdio
url	endpoint for a network transport	""
headers	static headers for a network transport	null
compression	default compression strategy for this upstream	auto
max_result_chars	result character budget	8000
max_result_tokens	optional token-equivalent result budget	null
chars_per_token	optional per-upstream character/token estimate	null (inherits proxy)
token_estimation_mode	optional static / unicode estimator override	null (inherits proxy)
retention_floor	optional minimum compression-retention fraction	null (inherits proxy)
llm	per-upstream LLM compressor settings	null
selective	selective-compressor settings	null
hybrid	hybrid-compressor settings	null
progressive	cursor-based progressive-delivery settings	null
cleaning	pre-compression cleaning settings	null
tool_overrides	per-tool ToolOverrideConfig map	{}
auto_index	override the global accepted compatibility setting	null
extraction	override the global accepted compatibility setting	null
cache	override response caching	null
cache_ttl_seconds	override response-cache TTL	null
expose_in_profiles	exposure profiles allowed for the upstream	null
surfacing_enabled	Opt this upstream’s responses in/out of proactive surfacing. false suppresses surfacing for every tool on this server.	true
max_retries	reconnect/call retries after the first attempt	3
reconnect_delay_seconds	initial reconnect delay	1.0
max_reconnect_delay_seconds	reconnect backoff ceiling	30.0
connect_timeout_seconds	upstream connection timeout	30.0
call_timeout_seconds	Per-attempt timeout for session.call_tool(). On timeout the session is force-reset and the retry loop proceeds.	90.0
overall_deadline_seconds	Total wall-clock budget across all retry attempts. Prevents call_timeout × (max_retries+1) worst-case blowout.	180.0
circuit_max_failures	failures before opening this upstream’s circuit	3
circuit_reset_seconds	open-circuit reset interval	60.0
max_description_chars	per-upstream tool-description cap	200
strip_schema_descriptions	per-upstream nested schema-description stripping	false
origin	Import-provenance block written by mms add --import/mms init and used by mms eject; CLI JSON output redacts the stored original entry.	null

Compression sub-configs

The same sub-config shapes are used under an upstream and, where noted, inside each tool_overrides.<tool> entry.

Block / field	Description	Default
llm.provider	openai, anthropic, or ollama	openai
llm.model	summarization model	gpt-4.1-mini
llm.api_key	provider API key	""
llm.base_url	provider endpoint override	""
llm.system_prompt	summary prompt template containing {max_chars}	built-in template
llm.max_tokens	summary output-token cap	500
llm.llm_timeout_seconds	summary timeout; timeout falls back to truncate	60.0
llm.privacy_scan_enabled	scan before a remote LLM call	true
selective.max_pending	in-flight selection record cap	100
selective.pending_ttl_seconds	pending selection TTL	300.0
selective.json_depth	JSON outline depth	1
selective.min_section_chars	minimum retained section size	50
selective.pending_store	memory or sqlite	memory
selective.pending_store_path	SQLite pending-selection path	~/.memtomem/pending_selections.db
hybrid.head_chars	preferred leading-content budget	5000
hybrid.tail_mode	toc or truncate	toc
hybrid.min_toc_budget	minimum table-of-contents budget	200
hybrid.min_head_chars	minimum leading-content budget	100
hybrid.head_ratio	fraction assigned to leading content	0.6
progressive.chunk_size	characters per progressive chunk	4000
progressive.max_stored	pending progressive payload cap	200
progressive.ttl_seconds	pending payload TTL	1800.0
progressive.include_structure_hint	include remaining-content structure metadata	true
cleaning.enabled	enable the cleaning stage	true
cleaning.strip_html	remove HTML markup	true
cleaning.deduplicate	remove duplicate blocks	true
cleaning.collapse_links	collapse verbose links	true

Per-tool overrides

Each tool_overrides.<tool> accepts compression, max_result_chars, max_result_tokens, chars_per_token, token_estimation_mode, retention_floor, and the llm, selective, hybrid, progressive, and cleaning blocks above. It also accepts every field below.

Field	Description	Default
auto_index	override accepted auto-index compatibility config	null
extraction	override accepted extraction compatibility config	null
cache	override caching	null
cache_ttl_seconds	override cache TTL	null
hidden	never advertise this tool	false
description_override	replace the advertised description	null
expose_in_profiles	exposure profiles allowed for this tool	null

Surfacing (Stage 3)

Variable	Description	Default
MEMTOMEM_STM_SURFACING__ENABLED	Enable proactive surfacing from LTM	true
MEMTOMEM_STM_SURFACING__USE_DAEMON	Route standalone surfacing through the shared daemon, with no private fallback	false
MEMTOMEM_STM_SURFACING__WARMUP_ENABLED	Warm the LTM client in the background	true
MEMTOMEM_STM_SURFACING__FEEDBACK_DB_PATH	Surfacing feedback and dedup SQLite path	~/.memtomem/stm_feedback.db
MEMTOMEM_STM_SURFACING__MIN_SCORE	Minimum relevance score	0.03
MEMTOMEM_STM_SURFACING__MAX_RESULTS	Max memories injected per call	3
MEMTOMEM_STM_SURFACING__MIN_RESPONSE_CHARS	Skip surfacing on tiny responses	5000
MEMTOMEM_STM_SURFACING__MIN_QUERY_TOKENS	Min tokens in extracted query	3
MEMTOMEM_STM_SURFACING__COOLDOWN_SECONDS	Minimum interval between repeated surfacing work	5.0
MEMTOMEM_STM_SURFACING__TIMEOUT_SECONDS	LTM surfacing request timeout	3.0
MEMTOMEM_STM_SURFACING__INJECTION_MODE	Placement: prepend, append, or section	append
MEMTOMEM_STM_SURFACING__SECTION_HEADER	Heading used by section injection mode	## Relevant Memories
MEMTOMEM_STM_SURFACING__DEFAULT_NAMESPACE	Optional namespace used when a tool rule does not override it	unset
MEMTOMEM_STM_SURFACING__EXCLUDE_TOOLS	Tool-name denylist (JSON list)	[]
MEMTOMEM_STM_SURFACING__WRITE_TOOL_PATTERNS	Patterns classified as write tools and therefore not surfaced by default (JSON list)	*write*, *create*, *delete*, *push*, *send*, *remove*
MEMTOMEM_STM_SURFACING__CONTEXT_TOOLS	Per-tool enabled, query_template, namespace, min_score, and max_results overrides (JSON object)	{}
MEMTOMEM_STM_SURFACING__DEDUP_TTL_SECONDS	Cross-session dedup window	604800 (7 days)
MEMTOMEM_STM_SURFACING__FEEDBACK_ENABLED	Accept stm_surfacing_feedback	true
MEMTOMEM_STM_SURFACING__MAX_SURFACINGS_PER_MINUTE	Process-local surfacing rate limit	15
MEMTOMEM_STM_SURFACING__CACHE_TTL_SECONDS	In-process surfacing result cache TTL	60.0
MEMTOMEM_STM_SURFACING__CIRCUIT_MAX_FAILURES	Consecutive LTM failures before opening the circuit	3
MEMTOMEM_STM_SURFACING__CIRCUIT_RESET_SECONDS	Open-circuit reset interval	60.0
MEMTOMEM_STM_SURFACING__AUTO_TUNE_ENABLED	Per-tool threshold auto-tuning	true
MEMTOMEM_STM_SURFACING__AUTO_TUNE_MIN_SAMPLES	Minimum feedback samples before tuning	20
MEMTOMEM_STM_SURFACING__AUTO_TUNE_SCORE_INCREMENT	Threshold adjustment step	0.002
MEMTOMEM_STM_SURFACING__AUTO_TUNE_SCORE_FLOOR	Default lower auto-tune bound; validation widens it to include an explicit min_score	0.005
MEMTOMEM_STM_SURFACING__AUTO_TUNE_SCORE_CEILING	Default upper auto-tune bound; validation widens it to include an explicit min_score	0.05
MEMTOMEM_STM_SURFACING__INCLUDE_SESSION_CONTEXT	Include available session context in the generated query	true
MEMTOMEM_STM_SURFACING__FIRE_WEBHOOK	Ask LTM to fire its configured webhook for surfaced results	true
MEMTOMEM_STM_SURFACING__MAX_INJECTION_CHARS	Total injected-memory character cap	3000
MEMTOMEM_STM_SURFACING__CONTEXT_WINDOW_SIZE	Adjacent LTM chunks requested around each hit	0
MEMTOMEM_STM_SURFACING__RESULT_CONTENT_MAX_CHARS	Content cap per structured result	500
MEMTOMEM_STM_SURFACING__PREVIEW_MAX_CHARS	Content cap per compact preview	300
MEMTOMEM_STM_SURFACING__QUERY_RETENTION_DAYS	Days to retain raw query text in the feedback DB before clearing the column; 0 disables cleanup	30
MEMTOMEM_STM_SURFACING__STATS_RETENTION_DAYS	Aggregated surfacing-stat retention	90
MEMTOMEM_STM_SURFACING__PERSIST_QUERY_TEXT	Store raw query text when true; store sha256:<16-hex> digests when false	true
MEMTOMEM_STM_SURFACING__FEEDBACK_DEMOTION_ENABLED	Locally filter memories with repeated negative feedback before injection	true
MEMTOMEM_STM_SURFACING__FEEDBACK_DEMOTION_NEGATIVE_THRESHOLD	Distinct negative surfacing events before local demotion applies	3
MEMTOMEM_STM_SURFACING__CONSUMER_MODEL	Surfacing-specific consumer model; empty inherits proxy.consumer_model	""
MEMTOMEM_STM_SURFACING__RESULT_FORMAT	LTM response mode: compact or structured	structured
MEMTOMEM_STM_SURFACING__RERANK	Whether LTM should rerank surfaced candidates; null delegates to LTM configuration	false
MEMTOMEM_STM_SURFACING__SCALE_GATED_MIN_SCORE	Apply score_scale-aware normalization before the minimum-score gate	true
MEMTOMEM_STM_SURFACING__LTM_MCP_TRANSPORT	LTM MCP transport: stdio, sse, or streamable_http	stdio
MEMTOMEM_STM_SURFACING__LTM_MCP_COMMAND	MCP command launching the LTM server for stdio transport	memtomem-server
MEMTOMEM_STM_SURFACING__LTM_MCP_ARGS	Args for the LTM command (JSON list)	[]
MEMTOMEM_STM_SURFACING__LTM_MCP_URL	LTM endpoint URL for sse / streamable_http	""
MEMTOMEM_STM_SURFACING__LTM_MCP_HEADERS	Optional static headers for network LTM transport (JSON object)	null

Surfacing applies only to calls routed through STM or supported host hooks. It is not a provider-memory layer and does not silently inject into unrelated direct MCP calls.

Hook / Daemon

Variable	Description	Default
MEMTOMEM_STM_HOOK__USE_DAEMON	Route mms hook surfacing through a resident local daemon instead of a fresh in-process path each call	true
MEMTOMEM_STM_HOOK__DAEMON_TIMEOUT_SECONDS	Hook-to-daemon round-trip timeout	2.5
MEMTOMEM_STM_HOOK__FALLBACK	Behavior when daemon is unavailable: skip (skip surfacing) or cold (handle via the in-process path)	skip
MEMTOMEM_STM_HOOK__AUTO_SPAWN	Start a daemon asynchronously on the first eligible hook call (does not wait for it)	true
MEMTOMEM_STM_HOOK__RECORD_FEEDBACK_EVENTS	Persist hook surfacing feedback/query events; default keeps dedup without storing raw query text	false
MEMTOMEM_STM_HOOK__METRICS_ENABLED	Record size/timing-only hook metrics	true
MEMTOMEM_STM_HOOK__COMPRESSION__ENABLED	Enable built-in Bash updatedToolOutput compression	false
MEMTOMEM_STM_HOOK__COMPRESSION__MAX_CHARS	Target char budget for Bash output replacement	16000
MEMTOMEM_STM_HOOK__COMPRESSION__MIN_RETENTION	Minimum retained fraction for built-in Bash output compression	0.65
MEMTOMEM_STM_HOOK_SURFACE_TOOLS	Direct-read comma-separated canonical hook-tool allowlist, separate from the nested settings model. Host adapters map names such as Claude Read / Bash to read / shell.	read,grep,glob,shell
MEMTOMEM_STM_DAEMON__HOST	Local daemon bind address; keep it loopback-only	127.0.0.1
MEMTOMEM_STM_DAEMON__ALLOW_NON_LOOPBACK	Explicitly permit a non-loopback daemon bind address	false
MEMTOMEM_STM_DAEMON__IDLE_TIMEOUT_SECONDS	Stop the daemon after this many idle seconds; 0 disables idle shutdown	900.0
MEMTOMEM_STM_DAEMON__MAX_PENDING_REQUESTS	Bound admitted hook and standalone surfacing requests	32

Langfuse (observability)

Variable	Description	Default
MEMTOMEM_STM_LANGFUSE__ENABLED	Emit spans	false
MEMTOMEM_STM_LANGFUSE__PUBLIC_KEY	Langfuse public key	—
MEMTOMEM_STM_LANGFUSE__SECRET_KEY	Langfuse secret key	—
MEMTOMEM_STM_LANGFUSE__HOST	Langfuse host URL	—
MEMTOMEM_STM_LANGFUSE__SAMPLING_RATE	0.0–1.0	1.0

Setting MEMTOMEM_STM_LANGFUSE__ENABLED=true without the [langfuse] extra installed raises a ValueError at startup (fail-fast since v0.1.16). Install the extra first, or leave enabled=false. The old silent-disable-with-WARNING behavior is gone, so a typo no longer leaves tracing quietly off.

Compression strategies (MEMTOMEM_STM_PROXY__DEFAULT_COMPRESSION)

Strategy	Use for
auto	Default — picks per content type
hybrid	Markdown (structure + summarize non-essentials)
selective	Keep only query-relevant sections
progressive	Large content; cursor-based delivery (zero loss)
extract_fields	JSON dictionaries
schema_pruning	Large JSON arrays
skeleton	API docs (schema-only)
llm_summary	LLM-based summarization (OpenAI / Anthropic / Ollama)
truncate	Fallback truncation
none	Pass-through

Full list: configuration.md in the upstream repo.