Skip to Content
remimem

Configuration

Every setting in .remimem/config.json, with its default and what it does.

Configuration is optional. It lives in .remimem/config.json in the project, which remimem init creates empty. Every field has a default, and the file is validated on load: unknown keys are rejected, so a typo does not silently fall back to a default.

.remimem/config.json
{
  "include": ["src/**"],
  "exclude": ["**/*.test.ts"],
  "embedding": { "provider": "local" },
  "retrieval": { "defaultBudgetTokens": 6000 }
}

Changes take effect on the next command. A running MCP server reads the config once at start, so restart it from your client.

Files

Prop

Type

Globs are matched against paths relative to the project root, with forward slashes, using Node.js's path.matchesGlob. The built-in rules (vendored folders, lockfiles, generated files, binaries, secrets) always apply; see Indexing.

embedding

Prop

Type

API keys come from OPENAI_API_KEY and VOYAGE_API_KEY, never from this file. After changing provider or model, run remimem index --full. See Embedding providers.

Prop

Type

retrieval: answers

Prop

Type

retrieval: call graph

Prop

Type

retrieval: memory

Prop

Type

watch

Prop

Type

telemetry

Prop

Type

Where the defaults come from

The search, graph, and memory defaults were chosen on the training split of the benchmark and checked on held-out tasks. textFileWeight and memoryMinSimilarity were changed by that tuning; the rest held up as first chosen. Run npx . bench --tune from a checkout to try your own values.

Errors

An invalid file stops every command with a message that names the field:

error: Invalid .remimem/config.json:
  Unrecognized key: "rrfk"
  at retrieval

(The real output also prefixes the first line of each problem with a cross mark and the second with an arrow.) A file that is not valid JSON says so, with the position of the error:

error: .remimem/config.json is not valid JSON: SyntaxError: Expected property name or '}' in JSON at position 2 (line 1 column 3)

Fix the file, or delete it to go back to the defaults.

On this page