Configuration

memsearch uses a layered TOML config system. Most users don't need to configure anything — the defaults work out of the box.

Config Locations (priority low → high)

1. ~/.memsearch/config.toml — global defaults
2. <project>/.memsearch.toml — project-level overrides
3. CLI flags — highest priority

Quick Setup

# Interactive config wizard
memsearch config init

# Or set individual values
memsearch config set embedding.provider onnx
memsearch config set milvus.uri http://localhost:19530

Embedding Provider

Provider	Install	API Key	Notes
onnx (default)	pip install memsearch[onnx]	No	Local, free, ~100MB model download
openai	pip install memsearch[openai]	OPENAI_API_KEY	Best quality
google	pip install memsearch[google]	GOOGLE_API_KEY	Gemini embeddings
voyage	pip install memsearch[voyage]	VOYAGE_API_KEY	High quality
jina	pip install memsearch[jina]	JINA_API_KEY	jina-embeddings-v4, multilingual, long context
mistral	pip install memsearch[mistral]	MISTRAL_API_KEY	EU-based, GDPR-friendly
ollama	pip install memsearch[ollama]	No	Local, any model

# Switch provider
memsearch config set embedding.provider openai
memsearch index --force   # re-index with new provider

Milvus Backend

Backend	Config	Notes
Milvus Lite (default) — zero config, single file. Great for getting started:

# Works out of the box, no setup needed
memsearch config get milvus.uri   # → ~/.memsearch/milvus.db

⭐ Zilliz Cloud (recommended) — fully managed, free tier available. No Docker, no ops. Concurrent access and real-time indexing:

memsearch config set milvus.uri "https://in03-xxx.api.gcp-us-west1.zillizcloud.com"
memsearch config set milvus.token "your-api-key"

Sign up for a free Zilliz Cloud cluster

You can sign up on Zilliz Cloud to get a free cluster and API key.

Self-hosted Milvus Server (Docker) — for advanced users

For multi-user or team environments. Requires Docker. See the official installation guide.

memsearch config set milvus.uri http://localhost:19530

View Current Config

memsearch config list          # show all settings
memsearch config get milvus.uri  # show specific value

Plugin Summarization Routing

Plugins keep their existing native/default summarizer unless you set a platform-specific override. These settings do not fall back to llm.model.

memsearch config set plugins.claude-code.summarize.model haiku
memsearch config set plugins.codex.summarize.model gpt-5.1-codex-mini
memsearch config set plugins.opencode.summarize.model anthropic/claude-haiku
memsearch config set plugins.openclaw.summarize.model qwen3-coder

To route plugin summarization through a memsearch-managed API provider, define a named provider and point a plugin at it:

memsearch config set llm.providers.openai.type openai
memsearch config set llm.providers.openai.model gpt-5-mini
memsearch config set llm.providers.openai.api_key env:OPENAI_API_KEY
memsearch config set plugins.codex.summarize.provider openai

Set plugins.<platform>.summarize.provider to native, or leave it empty, to preserve the current plugin behavior.

You can disable automatic capture for a single project while keeping the plugin installed:

memsearch config set plugins.codex.summarize.enabled false --project

Advanced Plugin Maintenance

Plugins can optionally maintain higher-level markdown files in the background. This is disabled by default.

Task	Default output	Purpose
project_review	.memsearch/PROJECT.md	Durable project state: active threads, decisions, risks, next steps
user_profile	.memsearch/USER.md	Reusable user preferences, working style, recurring goals, background context

Example project-level setup for Codex:

memsearch config set plugins.codex.project_review.enabled true --project
memsearch config set plugins.codex.project_review.provider native --project
memsearch config set plugins.codex.project_review.min_interval_hours 24 --project
memsearch config set plugins.codex.project_review.input_dir .memsearch/memory --project
memsearch config set plugins.codex.project_review.output_file .memsearch/PROJECT.md --project

memsearch config set plugins.codex.user_profile.enabled true --project
memsearch config set plugins.codex.user_profile.provider native --project
memsearch config set plugins.codex.user_profile.output_file .memsearch/USER.md --project

Equivalent TOML:

[plugins.codex.summarize]
enabled = true
provider = ""  # empty/native keeps the plugin-native summarizer
model = ""

[plugins.codex.project_review]
enabled = true
provider = "native"
model = ""
min_interval_hours = 24
input_dir = ".memsearch/memory"
output_file = ".memsearch/PROJECT.md"

[plugins.codex.user_profile]
enabled = true
provider = "native"
model = ""
min_interval_hours = 24
input_dir = ".memsearch/memory"
output_file = ".memsearch/USER.md"

input_dir and output_file can be relative or absolute. Relative paths are resolved from the current project directory. The default input is the daily memory journal directory.

Maintenance tasks run when the plugin wakes them and all of these are true:

• the task is enabled
• the input markdown digest changed
• min_interval_hours has elapsed since the last successful run

Set provider = "native" to reuse the agent's own non-interactive model path. To use a memsearch-managed API provider instead, define a named provider and reference it from the task:

memsearch config set llm.providers.openai.type openai
memsearch config set llm.providers.openai.model gpt-5-mini
memsearch config set llm.providers.openai.api_key env:OPENAI_API_KEY
memsearch config set plugins.codex.project_review.provider openai --project

Custom maintenance prompts are configured globally or per project:

memsearch config set prompts.project_review .memsearch/prompts/project-review.txt --project
memsearch config set prompts.user_profile .memsearch/prompts/user-profile.txt --project

The plugin-installed memory-config skill can inspect current config, memory files, and index health; explain these settings; and make safe project-scoped changes from natural-language requests.

Platform-Specific Config

Each plugin may have additional configuration. See:

• Claude Code Plugin
• OpenClaw Plugin
• OpenCode Plugin
• Codex CLI Plugin