om-memory-system 5.9.1 → 5.10.1

package/README.md

@@ -23,7 +23,7 @@ for model choices and privacy controls.
 ## Set up
 
 Use Node.js **22.14 or later** for the terminal command and Claude Code hooks.
-OpenCode v1 needs **1.18.29 or later**. OMMS also supports OpenCode v2 and the
+OMMS supports OpenCode v2, Claude Code and the
 [Pi coding agent](https://www.npmjs.com/package/@earendil-works/pi-coding-agent).
 
 > Automatic history import is enabled by default and makes model calls.
@@ -35,19 +35,11 @@ OpenCode v1 needs **1.18.29 or later**. OMMS also supports OpenCode v2 and the
 Add the package to `~/.config/opencode/opencode.json`. Keep your existing settings.
 On Windows, use `%USERPROFILE%\.config\opencode\opencode.json`.
 
-**OpenCode v2:**
-
 ```json
 { "plugins": ["om-memory-system"] }
 ```
 
-**OpenCode v1:**
-
-```json
-{ "plugin": ["om-memory-system"] }
-```
-
-OpenCode v2 also supports:
+Or run:
 
 ```bash
 opencode plugin add om-memory-system
@@ -121,6 +113,10 @@ cannot be saved.
 
 Keep separate stores for separate lines of work. The Spaces item in the web app sidebar opens a page with one card for each space. Switching a space applies to every host. Memories can be copied or moved between spaces, exported to a shareable file and imported into a new space, and a space can read the spaces it links. See [Memory spaces](docs/memory-spaces.md).
 
+### Memorisations
+
+Save an exact note on purpose and fetch it later by ID, such as `ms-4k7q2p`, or by a close description. A memorisation stays out of automatic recall and cleanup, and the Memorisation page lists, labels, filters and deletes them. See [Memorise and recall](docs/using-memory.md#memorise-and-recall).
+
 ### Settings
 
 Choose models and manage access. Diagnostics show capture outcomes and component health.
@@ -131,7 +127,7 @@ Choose models and manage access. Diagnostics show capture outcomes and component
 
 | Guide                                       | Covers                                                            |
 | ------------------------------------------- | ----------------------------------------------------------------- |
-| [Using memory](docs/using-memory.md)        | Daily use, capture, recall and the user profile                   |
+| [Using memory](docs/using-memory.md)        | Daily use, capture, recall, memorisations and the user profile    |
 | [Web UI](docs/web-ui.md)                    | Starting the app, browsing memories and safe network access       |
 | [Memory page](docs/web-ui-memory.md)        | One card per host, imports, shared settings and avatars           |
 | [Settings page](docs/web-ui-settings.md)    | Models, credentials, diagnostics and profile identities           |

package/dist/adapters/opencode/conversation.js

@@ -1,5 +1,5 @@
 import { boundToolInput, readToolPath } from "../../core/tool-input.js";
-import { opencodeToolOutcome } from "../../core/tool-outcome.js";
+import { opencodeMemorise, opencodeToolOutcome } from "../../core/tool-outcome.js";
 function formatToolInput(inputValue) {
     if (!inputValue)
         return "";
@@ -40,13 +40,15 @@ export function extractOpenCodeConversation(messages, promptMessageId) {
                 .trim());
         }
         for (const tool of message.parts.filter((part) => part.type === "tool")) {
-            const name = tool.tool || "unknown";
+            // V1 parts name the tool `tool`; the V2 plugin API names it `name`.
+            const name = tool.tool || tool.name || "unknown";
             const input = boundToolInput(formatToolInput(tool.state?.input));
             const path = readToolPath(name, tool.state?.input);
             toolCalls.push({
                 name,
                 input,
                 ...opencodeToolOutcome(tool.state),
+                ...opencodeMemorise(name, tool.state?.input, tool.state),
                 ...(path === undefined ? {} : { path }),
             });
         }

package/dist/adapters/opencode/memory-tool.d.ts

@@ -0,0 +1,4 @@
+import { type ToolDefinition } from "@opencode-ai/plugin";
+import { type MemoryOperationContext } from "../../core/memory-operations.js";
+/** The OpenCode V1 `memory` tool. V2 reaches it through the V1 plugin's `tool.memory`. */
+export declare function opencodeMemoryTool(description: string, base: Pick<MemoryOperationContext, "directory" | "tags">): ToolDefinition;

package/dist/adapters/opencode/memory-tool.js

@@ -0,0 +1,53 @@
+import { tool } from "@opencode-ai/plugin";
+import { executeMemoryOperation, } from "../../core/memory-operations.js";
+/** The OpenCode V1 `memory` tool. V2 reaches it through the V1 plugin's `tool.memory`. */
+export function opencodeMemoryTool(description, base) {
+    return tool({
+        description,
+        args: {
+            mode: tool.schema
+                .enum([
+                "add",
+                "memorise",
+                "memorize",
+                "recall",
+                "search",
+                "profile",
+                "list",
+                "forget",
+                "help",
+                "migrate",
+                "list-shards",
+                "export",
+                "import",
+            ])
+                .optional(),
+            content: tool.schema.string().optional(),
+            query: tool.schema.string().optional(),
+            tags: tool.schema.string().optional(),
+            type: tool.schema.string().optional(),
+            topic: tool.schema.string().optional(),
+            done: tool.schema.string().optional(),
+            doing: tool.schema.string().optional(),
+            next: tool.schema.string().optional(),
+            memoryId: tool.schema.string().optional(),
+            limit: tool.schema.number().optional(),
+            scope: tool.schema.enum(["project", "all-projects"]).optional(),
+            fromPath: tool.schema.string().optional(),
+            fromHash: tool.schema.string().optional(),
+            outputPath: tool.schema.string().optional(),
+            inputPath: tool.schema.string().optional(),
+            dryRun: tool.schema.boolean().optional(),
+            allowLinkedSource: tool.schema.boolean().optional(),
+        },
+        async execute(args, context) {
+            // The session ID lets `memorise` replace its own snapshot.
+            const result = await executeMemoryOperation(args, {
+                ...base,
+                host: "opencode",
+                hostSessionId: context?.sessionID,
+            });
+            return JSON.stringify(result);
+        },
+    });
+}

package/dist/adapters/opencode/package-skills.d.ts

@@ -9,7 +9,7 @@ export declare function packageSkillsFolder(moduleUrl?: string): string;
  * SDK `Config` type has no `skills` key, although OpenCode reads it.
  */
 export declare function applySkillsPathConfig(config: object, folder?: string): void;
-/** V2: add the omms-memory skill to the plugin's skill list once. */
+/** V2: add the package's skills to the plugin's skill list once. */
 export declare function addPackageSkill(editor: {
     get(id: string): unknown;
     add(skill: any): void;

package/dist/adapters/opencode/package-skills.js

@@ -2,7 +2,7 @@ import { existsSync, readFileSync } from "node:fs";
 import { dirname, join } from "node:path";
 import { fileURLToPath } from "node:url";
 import { log } from "../../services/logger.js";
-const SKILL_NAME = "omms-memory";
+const SKILL_NAMES = ["omms-memory", "omms-remember"];
 /**
  * The package's `skills` folder: the nearest parent folder whose
  * `package.json` names om-memory-system. Walking up also works when a host
@@ -34,7 +34,7 @@ const defaultFolder = packageSkillsFolder();
 export function applySkillsPathConfig(config, folder = defaultFolder) {
     const cfg = config;
     if (!existsSync(folder)) {
-        log("OMMS skills folder not found; the omms-memory skill is not loaded", { folder });
+        log("OMMS skills folder not found; the packaged skills are not loaded", { folder });
         return;
     }
     const paths = cfg.skills?.paths ?? [];
@@ -42,19 +42,21 @@ export function applySkillsPathConfig(config, folder = defaultFolder) {
         return;
     cfg.skills = { ...cfg.skills, paths: [...paths, folder] };
 }
-/** V2: add the omms-memory skill to the plugin's skill list once. */
+/** V2: add the package's skills to the plugin's skill list once. */
 export function addPackageSkill(editor, folder = defaultFolder) {
-    if (editor.get(SKILL_NAME))
-        return;
-    const path = join(folder, SKILL_NAME, "SKILL.md");
-    let content;
-    try {
-        content = readFileSync(path, "utf8");
-    }
-    catch {
-        log("OMMS skill file not found; the omms-memory skill is not loaded", { path });
-        return;
+    for (const name of SKILL_NAMES) {
+        if (editor.get(name))
+            continue;
+        const path = join(folder, name, "SKILL.md");
+        let content;
+        try {
+            content = readFileSync(path, "utf8");
+        }
+        catch {
+            log("OMMS skill file not found; the skill is not loaded", { path });
+            continue;
+        }
+        const description = content.match(/^description: (.+)$/m)?.[1]?.trim();
+        editor.add({ id: name, name, description, path, content });
     }
-    const description = content.match(/^description: (.+)$/m)?.[1]?.trim();
-    editor.add({ id: SKILL_NAME, name: SKILL_NAME, description, path, content });
 }

package/dist/adapters/pi/extension.js

@@ -22,6 +22,9 @@ const GLOBAL_PI_BACKFILL_KEY = Symbol.for("omms.pi.backfill.scheduled");
 const OMMS_STATUS_KEY = "omms";
 const MEMORY_TOOL_MODES = [
     "add",
+    "memorise",
+    "memorize",
+    "recall",
     "search",
     "profile",
     "list",
@@ -355,6 +358,10 @@ export default function ommsPiExtension(pi) {
             query: Type.Optional(Type.String()),
             tags: Type.Optional(Type.String()),
             type: Type.Optional(Type.String()),
+            topic: Type.Optional(Type.String()),
+            done: Type.Optional(Type.String()),
+            doing: Type.Optional(Type.String()),
+            next: Type.Optional(Type.String()),
             memoryId: Type.Optional(Type.String()),
             limit: Type.Optional(Type.Number()),
             scope: Type.Optional(Type.Union([Type.Literal("project"), Type.Literal("all-projects")])),

package/dist/cli/memory-command.d.ts

@@ -16,6 +16,8 @@ interface ParsedMemoryCommand {
     help: boolean;
     args: MemoryOperationArgs;
     directory?: string;
+    /** From `--session-id`; becomes the operation context's `hostSessionId`. */
+    hostSessionId?: string;
 }
 /** Parse `<mode> [options]` into memory tool arguments. Throws on bad input. */
 export declare function parseMemoryCommandArgs(argv: string[]): ParsedMemoryCommand;

package/dist/cli/memory-command.js

@@ -1,6 +1,9 @@
 import { resolve } from "node:path";
 const MODES = {
     add: "Store a memory (--content, optional --type and --tags)",
+    memorise: "Save an exact memorisation (text, or --topic --done --doing --next; optional --tags)",
+    memorize: "Same as memorise",
+    recall: "Fetch memorisations by ms- ID, text or label (argument or --query, optional --tags)",
     search: "Search project memories (query as an argument or --query)",
     profile: "Show the user profile, or save a preference with --content",
     list: "List recent memories (--limit, default 20)",
@@ -17,6 +20,11 @@ const VALUE_FLAGS = {
     "--query": "query",
     "--type": "type",
     "--tags": "tags",
+    "--topic": "topic",
+    "--done": "done",
+    "--doing": "doing",
+    "--next": "next",
+    "--session-id": "hostSessionId",
     "--id": "memoryId",
     "--limit": "limit",
     "--scope": "scope",
@@ -43,10 +51,15 @@ ${Object.entries(MODES)
     .join("\n")}
 
 Options:
-  --content <text>        Memory text (add) or preference text (profile)
-  --query <text>          Search text (search)
+  --content <text>        Memory text (add), exact text (memorise) or preference text (profile)
+  --query <text>          Search text (search), or an ms- ID or text (recall)
   --type <type>           Memory type, for example decision or bug-fix (add)
-  --tags <a,b>            Comma-separated tags (add)
+  --tags <a,b>            Comma-separated tags (add, memorise, recall)
+  --topic <text>          Snapshot topic (memorise)
+  --done <text>           Snapshot: what is done (memorise)
+  --doing <text>          Snapshot: what is in progress (memorise)
+  --next <text>           Snapshot: what comes next (memorise)
+  --session-id <id>       Host session ID, so a repeat snapshot can replace its earlier one (memorise)
   --id <id>               Memory id (forget)
   --limit <n>             Maximum results (search, list)
   --scope <scope>         project or all-projects (search, list)
@@ -65,7 +78,10 @@ Text inside <private>...</private> is removed before storage.
 
 Examples:
   om-memory-system memory search "database choice"
-  om-memory-system memory add --content "Use libSQL for the store" --type decision`;
+  om-memory-system memory add --content "Use libSQL for the store" --type decision
+  om-memory-system memory memorise --topic "Auth" --doing "Token refresh" --next "Tests"
+  om-memory-system memory recall ms-4k7q2p
+  om-memory-system memory recall --tags release,wip "token refresh"`;
 function isMode(value) {
     return Object.hasOwn(MODES, value);
 }
@@ -129,10 +145,16 @@ export function parseMemoryCommandArgs(argv) {
         }
     }
     else if (positionals.length > 0) {
-        if (mode !== "search" || positionals.length > 1 || values.query !== undefined) {
+        // One positional: search and recall read it as the query, memorise as the text.
+        const target = mode === "search" || mode === "recall"
+            ? "query"
+            : mode === "memorise" || mode === "memorize"
+                ? "content"
+                : undefined;
+        if (!target || positionals.length > 1 || values[target] !== undefined) {
             throw new Error(`Unexpected argument "${positionals[0]}"`);
         }
-        values.query = positionals[0];
+        values[target] = positionals[0];
     }
     for (const [key, value] of Object.entries(values)) {
         if (key === "limit") {
@@ -148,11 +170,11 @@ export function parseMemoryCommandArgs(argv) {
             }
             args.scope = value;
         }
-        else if (key !== "directory") {
+        else if (key !== "directory" && key !== "hostSessionId") {
             args[key] = value;
         }
     }
-    return { help: false, args, directory: values.directory };
+    return { help: false, args, directory: values.directory, hostSessionId: values.hostSessionId };
 }
 /** Run `om-memory-system memory ...` and return the process exit code. */
 export async function runMemoryCommand(argv, io = {}) {
@@ -183,7 +205,11 @@ export async function runMemoryCommand(argv, io = {}) {
         const { executeMemoryOperation } = await import("../core/memory-operations.js");
         const { memoryClient } = await import("../services/client.js");
         try {
-            result = await executeMemoryOperation(parsed.args, { directory, host: "claude-code" });
+            result = await executeMemoryOperation(parsed.args, {
+                directory,
+                host: "claude-code",
+                hostSessionId: parsed.hostSessionId,
+            });
         }
         finally {
             // Release the store so the process can exit once the reply is printed.

package/dist/config-paths.d.ts

@@ -0,0 +1,5 @@
+/** Global config and data locations. Kept apart from config assembly. */
+export declare const OMMS_CONFIG_DIR: string;
+export declare const DATA_DIR: string;
+export declare const LEGACY_CONFIG_FILES: string[];
+export declare const CONFIG_FILES: string[];

package/dist/config-paths.js

@@ -0,0 +1,15 @@
+import { join } from "node:path";
+import { homedir } from "node:os";
+/** Global config and data locations. Kept apart from config assembly. */
+export const OMMS_CONFIG_DIR = join(homedir(), ".config", "omms");
+export const DATA_DIR = join(homedir(), ".omms");
+export const LEGACY_CONFIG_FILES = [
+    join(homedir(), ".config", "opencode", "opencode-mem.jsonc"),
+    join(homedir(), ".config", "opencode", "opencode-mem.json"),
+];
+// Dual-read: the omms config wins; a legacy config is read only without an omms file.
+export const CONFIG_FILES = [
+    join(OMMS_CONFIG_DIR, "omms.jsonc"),
+    join(OMMS_CONFIG_DIR, "omms.json"),
+    ...LEGACY_CONFIG_FILES,
+];

package/dist/config-template.d.ts

@@ -3,4 +3,4 @@
  * src/config.ts until that file reached its size ceiling; the text is
  * unchanged. Shared by config.ts and the global settings writer.
  */
-export declare const CONFIG_TEMPLATE = "{\n  // ============================================\n  // omms (Opinionated Modular Memory System) Configuration\n  // ============================================\n  \n  // Storage location for the vector database. Leave unset to use the\n  // default ~/.omms/data (a legacy ~/.opencode-mem/data store is migrated\n  // there automatically on first start; see docs/omms-migration.md).\n  // \"storagePath\": \"~/.omms/data\",\n\n  \"userEmailOverride\": \"\",\n  \"userNameOverride\": \"\",\n  \n  // ============================================\n  // Embedding Model (for similarity search)\n  // ============================================\n  // Local = Hugging Face / ONNX via @huggingface/transformers (not Apple MLX).\n  // Remote = set embeddingApiUrl (OpenAI-compatible /embeddings); embeddingApiKey is optional.\n  \n  // Default: Nomic Embed v1 (768 dimensions, 8192 context, multilingual)\n  \"embeddingModel\": \"Xenova/nomic-embed-text-v1\",\n\n  // Opt-in Nomic task prefixes (search_document: / search_query:). After enabling,\n  // re-index existing memories so store and query vectors stay aligned.\n  // \"embeddingUseTaskPrefixes\": true,\n  \n  // Auto-detected dimensions (no need to set manually)\n  // \"embeddingDimensions\": 768,\n  \n  // Other recommended local models:\n  // \"embeddingModel\": \"Xenova/jina-embeddings-v2-base-en\",  // 768 dims, English-only, 8192 context\n  // \"embeddingModel\": \"Xenova/jina-embeddings-v2-small-en\", // 512 dims, faster, 8192 context\n  // \"embeddingModel\": \"Xenova/all-MiniLM-L6-v2\",            // 384 dims, very fast, 512 context\n  // \"embeddingModel\": \"Xenova/all-mpnet-base-v2\",           // 768 dims, good quality, 512 context\n  \n  // Optional: OpenAI-compatible API for embeddings (URL required; key only if the server needs one)\n  // \"embeddingApiUrl\": \"https://api.openai.com/v1\",\n  // \"embeddingApiKey\": \"env://OPENAI_API_KEY\",  // or \"sk-...\" / \"file:///path/to/key\"\n  // \"embeddingModel\": \"text-embedding-3-small\",  // 1536 dims, auto-detected\n \n  // ============================================\n  // Web Server Settings\n  // ============================================\n  \n  // Start a background import of past chats on each host's next start.\n  \"autoBackfill\": true,\n  // \"piBackfillModel\": \"inherit\", // or \"external\", or \"provider/model\"\n  // \"opencodeBackfillModel\": \"inherit\", // or \"external\", or \"provider/model\"\n  // Directory maps for history recorded in moved or deleted directories.\n  // \"importPathMaps\": [{ \"from\": \"~/code/app-feat-x\", \"to\": \"~/code/app\" }],\n  // Unresolved directories to hide on the Directory maps page. They stay unimported.\n  // \"importIgnoredDirectories\": [\"/private/tmp/scratch\"],\n  // Claude Code's folder, when it is not ~/.claude (like CLAUDE_CONFIG_DIR).\n  // \"claudeConfigDir\": \"~/.claude-work\",\n\n  // Register the web app to start when you log in.\n  \"webServerAutoStart\": true,\n  // Enable web UI for managing memories (accessible at http://localhost:4747)\n  \"webServerEnabled\": true,\n  \n  // Port for web UI server\n  \"webServerPort\": 4747,\n  \n  // Host address for web UI (use 127.0.0.1 for local only, 0.0.0.0 for network access)\n  \"webServerHost\": \"127.0.0.1\",\n\n  // Optional HTTP Basic Auth for the web UI. Accepts literal, env://, or file:// secrets.\n  // \"webServerAuthPassword\": \"\",\n  // \"webServerAuthUsername\": \"\",\n\n  // Deprecated: imported once into the API token table, then no longer read.\n  // Create API tokens on the Settings page (Keys and access) instead.\n  // \"webServerApiToken\": \"env://OMMS_WEB_TOKEN\",\n  \n  // ============================================\n  // Database Settings\n  // ============================================\n  \n  // Maximum vectors per database shard (auto-creates new shard when limit reached)\n  \"maxVectorsPerShard\": 50000,\n  \n  // Automatically delete old memories based on retention period\n  \"autoCleanupEnabled\": true,\n  \n  // Days to keep memories before auto-cleanup (only if autoCleanupEnabled is true)\n  \"autoCleanupRetentionDays\": 30,\n  \n  // Automatically detect and remove duplicate memories\n  \"deduplicationEnabled\": true,\n  \n   // Similarity threshold (0-1) for detecting duplicates (higher = stricter)\n   \"deduplicationSimilarityThreshold\": 0.90,\n   \n  // ============================================\n  // Memory Scope Settings\n  // ============================================\n\n  // Default scope for memory list/search queries\n  // \"project\" keeps queries within the current project, \"all-projects\" searches across all project shards\n  \"memory\": {\n    \"defaultScope\": \"project\"\n  },\n\n  // ============================================\n  // Model for auto-capture and profile learning (same rule in OpenCode and Pi)\n  // ============================================\n\n   // Which model summarises your work, in this order:\n   //   1. The host model below: opencodeProvider/opencodeModel in OpenCode,\n   //      piProvider/piModel in Pi. Set the model to \"inherit\" to follow\n   //      whatever model the session is using, or to \"external\" to send\n   //      every call to the external API below.\n   //   2. If no host model is set: the external API (memoryModel/memoryApiUrl/\n   //      memoryApiKey further down).\n   //   3. If neither is set: the session's own model.\n   // If the host model fails and the external API is configured, the external\n   // API is used instead.\n   //\n   // Host models go through OpenCode's or Pi's own sign-in (OAuth like Claude\n   // Pro/Max, GitHub Copilot, ChatGPT, or your own key there), so no separate API\n   // key is needed here.\n   //\n   // Examples (OpenCode names from 'opencode providers list'; Pi names from its model list):\n   //   \"opencodeProvider\": \"anthropic\",    \"opencodeModel\": \"claude-haiku-4-5-20251001\"\n   //   \"opencodeProvider\": \"openai\",       \"opencodeModel\": \"inherit\"\n   //   \"piProvider\": \"openai-codex\",       \"piModel\": \"gpt-5.6-luna\"\n   //\n   // \"opencodeProvider\": \"anthropic\",\n   // \"opencodeModel\": \"claude-haiku-4-5-20251001\",\n   // \"piProvider\": \"openai-codex\",\n   // \"piModel\": \"gpt-5.6-luna\",\n\n   // ============================================\n   // Auto-Capture Settings\n   // ============================================\n  \n  // Auto-capture runs in the background without blocking your main session.\n  // Note: Ollama may not support tool calling. Use OpenAI, Anthropic, or Groq for best results.\n  \n  \"autoCaptureEnabled\": true,\n  \n  // Provider type: \"openai-chat\" | \"openai-responses\" | \"anthropic\" | \"minimax\" | \"orcarouter\" | \"google-gemini\"\n  // Note: \"openai-chat\" is a generic OpenAI API-compatible mode.\n  // Any service that follows the OpenAI Chat Completions API can use it via custom \"memoryApiUrl\".\n  \"memoryProvider\": \"openai-chat\",\n  \n  // External API (step 2 above, and the fallback when a host model fails).\n  // Uncomment all 3 lines and replace memoryApiKey before use:\n  // \"memoryModel\": \"gpt-4o-mini\",\n  // \"memoryApiUrl\": \"https://api.openai.com/v1\",\n  // \"memoryApiKey\": \"sk-...\",\n\n  // API Key Formats:\n  // Direct value:        \"sk-...\"\n  // From file:           \"file://~/.config/litellm-key.txt\"\n  // From env variable:   \"env://LITELLM_API_KEY\"\n  \n  // Examples for different providers:\n  // Any OpenAI-compatible endpoint can use the \"openai-chat\" provider pattern below.\n  // Common examples: DeepSeek, Qwen (via Alibaba Cloud ModelStudio),\n  // Zhipu GLM (BigModel platform), and Kimi (Moonshot AI platform).\n\n  // OpenAI Chat Completion (default, backward compatible):\n  //   \"memoryProvider\": \"openai-chat\"\n  //   \"memoryModel\": \"gpt-4o-mini\"\n  //   \"memoryApiUrl\": \"https://api.openai.com/v1\"\n  //   \"memoryApiKey\": \"sk-...\"\n\n  // DeepSeek (OpenAI-compatible example):\n  //   \"memoryProvider\": \"openai-chat\"\n  //   \"memoryModel\": \"deepseek-chat\"\n  //   \"memoryApiUrl\": \"https://api.deepseek.com/v1\"\n  //   \"memoryApiKey\": \"sk-...\"\n  \n  // OpenAI Responses API (recommended, with session support):\n  //   \"memoryProvider\": \"openai-responses\"\n  //   \"memoryModel\": \"gpt-4o\"\n  //   \"memoryApiUrl\": \"https://api.openai.com/v1\"\n  //   \"memoryApiKey\": \"sk-...\"\n  \n  // Anthropic (with session support):\n  //   \"memoryProvider\": \"anthropic\"\n  //   \"memoryModel\": \"claude-3-5-haiku-20241022\"\n  //   \"memoryApiUrl\": \"https://api.anthropic.com/v1\"\n  //   \"memoryApiKey\": \"sk-ant-...\"\n\n  // MiniMax (Anthropic Messages-compatible endpoint, with session support):\n  //   \"memoryProvider\": \"minimax\"\n  //   \"memoryModel\": \"MiniMax-M3\"\n  //   \"memoryApiUrl\": \"https://api.minimax.io\"        // global endpoint\n  //   \"memoryApiKey\": \"<MiniMax API key>\"\n  //   // China endpoint: \"memoryApiUrl\": \"https://api.minimaxi.com\"\n  //   // Optional adaptive thinking for MiniMax-M3:\n  //   \"memoryExtraParams\": { \"thinking\": { \"type\": \"adaptive\" } }\n\n  // OrcaRouter (OpenAI-compatible gateway, namespaced model IDs, with session support):\n  //   \"memoryProvider\": \"orcarouter\"\n  //   \"memoryApiKey\": \"<OrcaRouter API key>\"\n  //   // memoryApiUrl and memoryModel are optional \u2014 they default to\n  //   // https://api.orcarouter.ai/v1 and \"orcarouter/auto\" (a routing alias).\n  //   // OrcaRouter rejects bare model names, so if you set memoryModel, use a\n  //   // namespaced ID such as \"openai/gpt-5.5\" or \"deepseek/deepseek-v4-flash\".\n  //   \"memoryModel\": \"openai/gpt-5.5\"\n\n  // Groq (OpenAI-compatible, use openai-chat provider):\n  //   \"memoryProvider\": \"openai-chat\"\n  //   \"memoryModel\": \"llama-3.3-70b-versatile\"\n  //   \"memoryApiUrl\": \"https://api.groq.com/openai/v1\"\n  //   \"memoryApiKey\": \"gsk_...\"\n  \n  // Maximum iterations for multi-turn AI analysis (for openai-responses, anthropic, and minimax)\n  \"autoCaptureMaxIterations\": 5,\n   \n  // Timeout per iteration in milliseconds (30 seconds default)\n  \"autoCaptureIterationTimeout\": 30000,\n\n  // Tries for one turn's capture, on Pi and OpenCode, 2 and 4 seconds apart. After the\n  // last one fails, a turn the model could not reach goes to the capture retry queue.\n  \"autoCaptureMaxRetries\": 3,\n\n  // Maximum UTF-8 bytes for the auto-capture markdown context sent to the summary model.\n  // Prevents HTTP 400 context overflows on models with ~131K token windows (e.g. Groq Llama).\n  // Rough guide: tokens \u2248 bytes / 4 for mixed code/prose.\n  \"autoCaptureMaxContextBytes\": 131072,\n   \n  // Days to keep AI session history before cleanup\n  \"aiSessionRetentionDays\": 7,\n\n  // Capture diagnostics: every capture attempt always writes one metadata line\n  // (model, stop reason, sizes, outcome) to ~/.omms/omms.log, with no\n  // conversation text. Set captureTrace to true to also write each attempt's\n  // prompt and raw reply to ~/.omms/traces/ for debugging. Traces can contain\n  // conversation content: <private> text and common API key formats are\n  // redacted, files are readable only by you, and they are deleted after\n  // captureTraceRetentionDays. Only this global file can turn tracing on.\n  // \"captureTrace\": false,\n  // \"captureTraceRetentionDays\": 7,\n  // \"captureAttemptRetentionDays\": 30,\n\n  // Skill learning: record each full turn (prompt, replies, tool calls with\n  // their outcome, and the skills used) in ~/.omms/data/skills.db, so OMMS can\n  // rank your skills and draft better versions. Off by default. A project config\n  // can turn it off but never on. No model call is made to record a turn.\n  // \"skillLearning\": false,\n  // Remove <private> text and common API key formats before a turn is stored.\n  // Global config only. Turning this off stores text as written.\n  // \"skillLearningRedact\": true,\n  // Folders OMMS reads skills from. Absolute or starting with ~/. Global config\n  // only. Unset: ~/.agents/skills and the Claude Code folder's skills folder.\n  // \"skillFolders\": [\"~/.agents/skills\"],\n\n  // Visible recall: the OpenCode terminal TUI and Pi's interactive terminal draw\n  // a row for each memory recall. On by default. A project config can turn it\n  // off but never on.\n  // \"visibleRecall\": true,\n\n  // Memory injection, on OpenCode V2, Pi and Claude Code. Each prompt gets the\n  // memories that match it. openingContext also searches memory with\n  // openingContextQuery and adds the matches to the\n  // first message of a new session. The query is global only, trimmed, and\n  // 500 characters at most. subagentMemory gives each subagent the memories\n  // that match its task. For both switches, a project config can only turn these off.\n  // \"openingContext\": false,\n  // \"openingContextQuery\": \"project architecture, setup, conventions and key decisions\",\n  // \"subagentMemory\": true,\n\n  // Capture retry queue: when a live capture fails because the model cannot be\n  // reached (network error, timeout, HTTP 408, 429 or 5xx), OMMS keeps a copy of\n  // the turn in ~/.omms/data and tries it again later. The copy has <private>\n  // text and common API key formats removed. Turns are deleted when the retry\n  // ends or after captureRetryRetentionHours (0 to 720). 0 turns the queue off.\n  // Only this global file can set it.\n  // \"captureRetryRetentionHours\": 72,\n\n  // Temperature for AI API requests (set to false to omit parameter for models that don't support it)\n  // Some reasoning models (like o1, o3, gpt-5) don't support temperature parameter\n  // Set to false and add \"memoryTemperature\": false in config when using such models\n  \"memoryTemperature\": 0.3,\n\n  // Extra parameters to include in API request body\n  // Useful for local inference servers (e.g. llama-server with --jinja) that support\n  // additional parameters like disabling thinking/reasoning mode\n  // Example for Qwen3 models: { \"enable_thinking\": false }\n  // \"memoryExtraParams\": {},\n\n  // Language for auto-capture summaries (default: \"auto\" for auto-detection)\n  // Options: \"auto\", \"en\", \"id\", \"zh\", \"ja\", \"es\", \"fr\", \"de\", \"ru\", \"pt\", \"ar\", \"ko\"\n  // \"autoCaptureLanguage\": \"auto\",\n\n  // ============================================\n  // Toast Notifications\n  // ============================================\n\n  // Show toast when memory is auto-captured\n  \"showAutoCaptureToasts\": true,\n\n  // Show toast when user profile is updated\n  \"showUserProfileToasts\": true,\n\n  // Show toast for error messages\n  \"showErrorToasts\": true,\n\n  // ============================================\n  // User Profile System\n  // ============================================\n\n  // Analyze user prompts every N prompts to build/update your user profile\n  // When N uncaptured prompts accumulate, AI will analyze them to identify:\n  // - User preferences (code style, communication style, tool preferences)\n  // - User patterns (recurring topics, problem domains, technical interests)\n  // - User workflows (development habits, sequences, learning style)\n  // - Skill level (overall and per-domain assessment)\n  \"userProfileAnalysisInterval\": 10,\n\n  // Days before inactive items (all types) are eligible for removal\n  \"userProfileStaleDays\": 2,\n\n  // Days before an inactive workflow is eligible for removal. A workflow seen\n  // userProfileMinEvidenceForRetention times or more is kept.\n  \"userProfileWorkflowStaleDays\": 30,\n\n  // Number of preferences shown in UI\n  \"userProfileDisplayPreferences\": 20,\n  \n  // Number of patterns shown in UI\n  \"userProfileDisplayPatterns\": 15,\n  \n  // Number of workflows shown in UI\n  \"userProfileDisplayWorkflows\": 10,\n  \n  // Number of preferences injected into LLM conversation context\n  // Keep this small \u2014 the strongest signals are enough; more dilute LLM attention\n  \"userProfileInjectPreferences\": 5,\n  \n  // Number of patterns injected into LLM conversation context\n  \"userProfileInjectPatterns\": 5,\n  \n  // Number of workflows injected into LLM conversation context\n  \"userProfileInjectWorkflows\": 3,\n  \n  // Days before preference confidence starts to decay (if not reinforced)\n  // Preferences that aren't seen again will gradually lose confidence and be removed\n  \"userProfileConfidenceDecayDays\": 30,\n  \n  // Number of profile versions to keep in changelog (for rollback/debugging)\n  // Older versions are automatically cleaned up\n  \"userProfileChangelogRetentionCount\": 5,\n\n  // Minimum evidence count for a preference/pattern to survive confidence decay\n  // Items confirmed fewer times are more likely to be pruned when confidence decays\n  \"userProfileMinEvidenceForRetention\": 3,\n\n  // Merge duplicate or vague profile items every N analysed prompts (about 1 model call per 100 items)\n  \"userProfileAutoCleanupEnabled\": true,\n  \"userProfileAutoCleanupInterval\": 500,\n\n  // Enable LLM validation of existing preferences against recent behavior.\n  // When enabled, each analysis round checks if top-5 preferences still match recent prompts.\n  // Experimental \u2014 disabled by default.\n  \"userProfileValidationEnabled\": false,\n\n  // ============================================\n  // Search Settings\n  // ============================================\n   \n  // Minimum similarity score (0-1) for memory search results. Leave unset to\n  // follow the default for your embedding model: 0.5 for qwen3-embedding:0.6b\n  // (the only model measured), 0.6 for every other embedder.\n  // \"similarityThreshold\": 0.5,\n\n  // Maximum number of memories to return in search results.\n  // Manual searches can ask for fewer; prompt retrieval uses this ceiling.\n  \"maxMemories\": 10,\n\n  // ============================================\n  // Memory Context Controls\n  // ============================================\n\n  // Recent memories added at fresh session start (OpenCode V1 and Claude Code).\n  // Pi and OpenCode V2 search the store with each prompt instead.\n  \"chatMessage\": {\n    \"enabled\": true,\n    // Recent memories injected at session start.\n    \"maxMemories\": 3,\n    \"excludeCurrentSession\": true,\n    // When to inject: \"first\" message of a session or \"always\".\n    // \"injectOn\": \"first\",\n  },\n\n  // OpenCode profile-learning input limit, in UTF-8 bytes. Smaller values can\n  // omit prompts from that input. Does not limit Pi or Claude Code profile input.\n  \"userProfileMaxContextBytes\": 32768,\n\n  // Shared budget for automatic memory context (profile text, memories, and\n  // formatting) across all hosts, in approximate tokens: ceil(UTF-8 bytes / 4).\n  // Covers prompt retrieval, recent-memory injection, and session-memory\n  // restoration. Not an exact provider token limit or a spending limit.\n  \"retrievalMaxTokens\": 2000,\n\n  // Restore a session's own memories after compaction and after resume, on\n  // OpenCode V2, Pi and Claude Code. memoryLimit is the most memories to\n  // restore. A project config can turn it on or off.\n  // \"compaction\": { \"enabled\": true, \"memoryLimit\": 10 },\n\n  // ============================================\n  // Advanced Settings\n  // ============================================\n  \n  // Inject user profile into AI context (preferences, patterns, workflows)\n  \"injectProfile\": true\n}\n";
+export declare const CONFIG_TEMPLATE = "{\n  // ============================================\n  // omms (Opinionated Modular Memory System) Configuration\n  // ============================================\n  \n  // Storage location for the vector database. Leave unset to use the\n  // default ~/.omms/data (a legacy ~/.opencode-mem/data store is migrated\n  // there automatically on first start; see docs/omms-migration.md).\n  // \"storagePath\": \"~/.omms/data\",\n\n  \"userEmailOverride\": \"\",\n  \"userNameOverride\": \"\",\n  \n  // ============================================\n  // Embedding Model (for similarity search)\n  // ============================================\n  // Local = Hugging Face / ONNX via @huggingface/transformers (not Apple MLX).\n  // Remote = set embeddingApiUrl (OpenAI-compatible /embeddings); embeddingApiKey is optional.\n  \n  // Default: Nomic Embed v1 (768 dimensions, 8192 context, multilingual)\n  \"embeddingModel\": \"Xenova/nomic-embed-text-v1\",\n\n  // Opt-in Nomic task prefixes (search_document: / search_query:). After enabling,\n  // re-index existing memories so store and query vectors stay aligned.\n  // \"embeddingUseTaskPrefixes\": true,\n  \n  // Auto-detected dimensions (no need to set manually)\n  // \"embeddingDimensions\": 768,\n  \n  // Other recommended local models:\n  // \"embeddingModel\": \"Xenova/jina-embeddings-v2-base-en\",  // 768 dims, English-only, 8192 context\n  // \"embeddingModel\": \"Xenova/jina-embeddings-v2-small-en\", // 512 dims, faster, 8192 context\n  // \"embeddingModel\": \"Xenova/all-MiniLM-L6-v2\",            // 384 dims, very fast, 512 context\n  // \"embeddingModel\": \"Xenova/all-mpnet-base-v2\",           // 768 dims, good quality, 512 context\n  \n  // Optional: OpenAI-compatible API for embeddings (URL required; key only if the server needs one)\n  // \"embeddingApiUrl\": \"https://api.openai.com/v1\",\n  // \"embeddingApiKey\": \"env://OPENAI_API_KEY\",  // or \"sk-...\" / \"file:///path/to/key\"\n  // \"embeddingModel\": \"text-embedding-3-small\",  // 1536 dims, auto-detected\n \n  // ============================================\n  // Web Server Settings\n  // ============================================\n  \n  // Start a background import of past chats on each host's next start.\n  \"autoBackfill\": true,\n  // \"piBackfillModel\": \"inherit\", // or \"external\", or \"provider/model\"\n  // \"opencodeBackfillModel\": \"inherit\", // or \"external\", or \"provider/model\"\n  // Directory maps for history recorded in moved or deleted directories.\n  // \"importPathMaps\": [{ \"from\": \"~/code/app-feat-x\", \"to\": \"~/code/app\" }],\n  // Unresolved directories to hide on the Directory maps page. They stay unimported.\n  // \"importIgnoredDirectories\": [\"/private/tmp/scratch\"],\n  // Claude Code's folder, when it is not ~/.claude (like CLAUDE_CONFIG_DIR).\n  // \"claudeConfigDir\": \"~/.claude-work\",\n\n  // Register the web app to start when you log in.\n  \"webServerAutoStart\": true,\n  // Enable web UI for managing memories (accessible at http://localhost:4747)\n  \"webServerEnabled\": true,\n  \n  // Port for web UI server\n  \"webServerPort\": 4747,\n  \n  // Host address for web UI (use 127.0.0.1 for local only, 0.0.0.0 for network access)\n  \"webServerHost\": \"127.0.0.1\",\n\n  // Optional HTTP Basic Auth for the web UI. Accepts literal, env://, or file:// secrets.\n  // \"webServerAuthPassword\": \"\",\n  // \"webServerAuthUsername\": \"\",\n\n  // Deprecated: imported once into the API token table, then no longer read.\n  // Create API tokens on the Settings page (Keys and access) instead.\n  // \"webServerApiToken\": \"env://OMMS_WEB_TOKEN\",\n  \n  // ============================================\n  // Database Settings\n  // ============================================\n  \n  // Maximum vectors per database shard (auto-creates new shard when limit reached)\n  \"maxVectorsPerShard\": 50000,\n  \n  // Automatically delete old memories based on retention period\n  \"autoCleanupEnabled\": true,\n  \n  // Days to keep memories before auto-cleanup (only if autoCleanupEnabled is true)\n  \"autoCleanupRetentionDays\": 30,\n  \n  // Automatically detect and remove duplicate memories\n  \"deduplicationEnabled\": true,\n  \n   // Similarity threshold (0-1) for detecting duplicates (higher = stricter)\n   \"deduplicationSimilarityThreshold\": 0.90,\n   \n  // ============================================\n  // Memory Scope Settings\n  // ============================================\n\n  // Default scope for memory list/search queries\n  // \"project\" keeps queries within the current project, \"all-projects\" searches across all project shards\n  \"memory\": {\n    \"defaultScope\": \"project\"\n  },\n\n  // ============================================\n  // Model for auto-capture and profile learning (same rule in OpenCode and Pi)\n  // ============================================\n\n   // Which model summarises your work, in this order:\n   //   1. The host model below: opencodeProvider/opencodeModel in OpenCode,\n   //      piProvider/piModel in Pi. Set the model to \"inherit\" to follow\n   //      whatever model the session is using, or to \"external\" to send\n   //      every call to the external API below.\n   //   2. If no host model is set: the external API (memoryModel/memoryApiUrl/\n   //      memoryApiKey further down).\n   //   3. If neither is set: the session's own model.\n   // If the host model fails and the external API is configured, the external\n   // API is used instead.\n   //\n   // Host models go through OpenCode's or Pi's own sign-in (OAuth like Claude\n   // Pro/Max, GitHub Copilot, ChatGPT, or your own key there), so no separate API\n   // key is needed here.\n   //\n   // Examples (OpenCode names from 'opencode providers list'; Pi names from its model list):\n   //   \"opencodeProvider\": \"anthropic\",    \"opencodeModel\": \"claude-haiku-4-5-20251001\"\n   //   \"opencodeProvider\": \"openai\",       \"opencodeModel\": \"inherit\"\n   //   \"piProvider\": \"openai-codex\",       \"piModel\": \"gpt-5.6-luna\"\n   //\n   // \"opencodeProvider\": \"anthropic\",\n   // \"opencodeModel\": \"claude-haiku-4-5-20251001\",\n   // \"piProvider\": \"openai-codex\",\n   // \"piModel\": \"gpt-5.6-luna\",\n\n   // ============================================\n   // Auto-Capture Settings\n   // ============================================\n  \n  // Auto-capture runs in the background without blocking your main session.\n  // Note: Ollama may not support tool calling. Use OpenAI, Anthropic, or Groq for best results.\n  \n  \"autoCaptureEnabled\": true,\n  \n  // Provider type: \"openai-chat\" | \"openai-responses\" | \"anthropic\" | \"minimax\" | \"orcarouter\" | \"google-gemini\"\n  // Note: \"openai-chat\" is a generic OpenAI API-compatible mode.\n  // Any service that follows the OpenAI Chat Completions API can use it via custom \"memoryApiUrl\".\n  \"memoryProvider\": \"openai-chat\",\n  \n  // External API (step 2 above, and the fallback when a host model fails).\n  // Uncomment all 3 lines and replace memoryApiKey before use:\n  // \"memoryModel\": \"gpt-4o-mini\",\n  // \"memoryApiUrl\": \"https://api.openai.com/v1\",\n  // \"memoryApiKey\": \"sk-...\",\n\n  // API Key Formats:\n  // Direct value:        \"sk-...\"\n  // From file:           \"file://~/.config/litellm-key.txt\"\n  // From env variable:   \"env://LITELLM_API_KEY\"\n  \n  // Examples for different providers:\n  // Any OpenAI-compatible endpoint can use the \"openai-chat\" provider pattern below.\n  // Common examples: DeepSeek, Qwen (via Alibaba Cloud ModelStudio),\n  // Zhipu GLM (BigModel platform), and Kimi (Moonshot AI platform).\n\n  // OpenAI Chat Completion (default, backward compatible):\n  //   \"memoryProvider\": \"openai-chat\"\n  //   \"memoryModel\": \"gpt-4o-mini\"\n  //   \"memoryApiUrl\": \"https://api.openai.com/v1\"\n  //   \"memoryApiKey\": \"sk-...\"\n\n  // DeepSeek (OpenAI-compatible example):\n  //   \"memoryProvider\": \"openai-chat\"\n  //   \"memoryModel\": \"deepseek-chat\"\n  //   \"memoryApiUrl\": \"https://api.deepseek.com/v1\"\n  //   \"memoryApiKey\": \"sk-...\"\n  \n  // OpenAI Responses API (recommended, with session support):\n  //   \"memoryProvider\": \"openai-responses\"\n  //   \"memoryModel\": \"gpt-4o\"\n  //   \"memoryApiUrl\": \"https://api.openai.com/v1\"\n  //   \"memoryApiKey\": \"sk-...\"\n  \n  // Anthropic (with session support):\n  //   \"memoryProvider\": \"anthropic\"\n  //   \"memoryModel\": \"claude-3-5-haiku-20241022\"\n  //   \"memoryApiUrl\": \"https://api.anthropic.com/v1\"\n  //   \"memoryApiKey\": \"sk-ant-...\"\n\n  // MiniMax (Anthropic Messages-compatible endpoint, with session support):\n  //   \"memoryProvider\": \"minimax\"\n  //   \"memoryModel\": \"MiniMax-M3\"\n  //   \"memoryApiUrl\": \"https://api.minimax.io\"        // global endpoint\n  //   \"memoryApiKey\": \"<MiniMax API key>\"\n  //   // China endpoint: \"memoryApiUrl\": \"https://api.minimaxi.com\"\n  //   // Optional adaptive thinking for MiniMax-M3:\n  //   \"memoryExtraParams\": { \"thinking\": { \"type\": \"adaptive\" } }\n\n  // OrcaRouter (OpenAI-compatible gateway, namespaced model IDs, with session support):\n  //   \"memoryProvider\": \"orcarouter\"\n  //   \"memoryApiKey\": \"<OrcaRouter API key>\"\n  //   // memoryApiUrl and memoryModel are optional \u2014 they default to\n  //   // https://api.orcarouter.ai/v1 and \"orcarouter/auto\" (a routing alias).\n  //   // OrcaRouter rejects bare model names, so if you set memoryModel, use a\n  //   // namespaced ID such as \"openai/gpt-5.5\" or \"deepseek/deepseek-v4-flash\".\n  //   \"memoryModel\": \"openai/gpt-5.5\"\n\n  // Groq (OpenAI-compatible, use openai-chat provider):\n  //   \"memoryProvider\": \"openai-chat\"\n  //   \"memoryModel\": \"llama-3.3-70b-versatile\"\n  //   \"memoryApiUrl\": \"https://api.groq.com/openai/v1\"\n  //   \"memoryApiKey\": \"gsk_...\"\n  \n  // Maximum iterations for multi-turn AI analysis (for openai-responses, anthropic, and minimax)\n  \"autoCaptureMaxIterations\": 5,\n   \n  // Timeout per iteration in milliseconds (30 seconds default)\n  \"autoCaptureIterationTimeout\": 30000,\n\n  // Tries for one turn's capture, on Pi and OpenCode, 2 and 4 seconds apart. After the\n  // last one fails, a turn the model could not reach goes to the capture retry queue.\n  \"autoCaptureMaxRetries\": 3,\n\n  // Maximum UTF-8 bytes for the auto-capture markdown context sent to the summary model.\n  // Prevents HTTP 400 context overflows on models with ~131K token windows (e.g. Groq Llama).\n  // Rough guide: tokens \u2248 bytes / 4 for mixed code/prose.\n  \"autoCaptureMaxContextBytes\": 131072,\n   \n  // Days to keep AI session history before cleanup\n  \"aiSessionRetentionDays\": 7,\n\n  // Capture diagnostics: every capture attempt always writes one metadata line\n  // (model, stop reason, sizes, outcome) to ~/.omms/omms.log, with no\n  // conversation text. Set captureTrace to true to also write each attempt's\n  // prompt and raw reply to ~/.omms/traces/ for debugging. Traces can contain\n  // conversation content: <private> text and common API key formats are\n  // redacted, files are readable only by you, and they are deleted after\n  // captureTraceRetentionDays. Only this global file can turn tracing on.\n  // \"captureTrace\": false,\n  // \"captureTraceRetentionDays\": 7,\n  // \"captureAttemptRetentionDays\": 30,\n\n  // Skill learning: record each full turn (prompt, replies, tool calls with\n  // their outcome, and the skills used) in ~/.omms/data/skills.db, so OMMS can\n  // rank your skills and draft better versions. Off by default. A project config\n  // can turn it off but never on. No model call is made to record a turn.\n  // \"skillLearning\": false,\n  // Remove <private> text and common API key formats before a turn is stored.\n  // Global config only. Turning this off stores text as written.\n  // \"skillLearningRedact\": true,\n  // Folders OMMS reads skills from. Absolute or starting with ~/. Global config\n  // only. Unset: ~/.agents/skills and the Claude Code folder's skills folder.\n  // \"skillFolders\": [\"~/.agents/skills\"],\n\n  // Visible recall: the OpenCode terminal TUI and Pi's interactive terminal draw\n  // a row for each memory recall. On by default. A project config can turn it\n  // off but never on.\n  // \"visibleRecall\": true,\n\n  // Memory injection, on OpenCode V2, Pi and Claude Code. Each prompt gets the\n  // memories that match it. openingContext also searches memory with\n  // openingContextQuery and adds the matches to the\n  // first message of a new session. The query is global only, trimmed, and\n  // 500 characters at most. subagentMemory gives each subagent the memories\n  // that match its task. For both switches, a project config can only turn these off.\n  // \"openingContext\": false,\n  // \"openingContextQuery\": \"project architecture, setup, conventions and key decisions\",\n  // \"subagentMemory\": true,\n\n  // Capture retry queue: when a live capture fails because the model cannot be\n  // reached (network error, timeout, HTTP 408, 429 or 5xx), OMMS keeps a copy of\n  // the turn in ~/.omms/data and tries it again later. The copy has <private>\n  // text and common API key formats removed. Turns are deleted when the retry\n  // ends or after captureRetryRetentionHours (0 to 720). 0 turns the queue off.\n  // Only this global file can set it.\n  // \"captureRetryRetentionHours\": 72,\n\n  // Temperature for AI API requests (set to false to omit parameter for models that don't support it)\n  // Some reasoning models (like o1, o3, gpt-5) don't support temperature parameter\n  // Set to false and add \"memoryTemperature\": false in config when using such models\n  \"memoryTemperature\": 0.3,\n\n  // Extra parameters to include in API request body\n  // Useful for local inference servers (e.g. llama-server with --jinja) that support\n  // additional parameters like disabling thinking/reasoning mode\n  // Example for Qwen3 models: { \"enable_thinking\": false }\n  // \"memoryExtraParams\": {},\n\n  // Language for auto-capture summaries (default: \"auto\" for auto-detection)\n  // Options: \"auto\", \"en\", \"id\", \"zh\", \"ja\", \"es\", \"fr\", \"de\", \"ru\", \"pt\", \"ar\", \"ko\"\n  // \"autoCaptureLanguage\": \"auto\",\n\n  // ============================================\n  // Toast Notifications\n  // ============================================\n\n  // Show toast when memory is auto-captured\n  \"showAutoCaptureToasts\": true,\n\n  // Show toast when user profile is updated\n  \"showUserProfileToasts\": true,\n\n  // Show toast for error messages\n  \"showErrorToasts\": true,\n\n  // ============================================\n  // User Profile System\n  // ============================================\n\n  // Analyze user prompts every N prompts to build/update your user profile\n  // When N uncaptured prompts accumulate, AI will analyze them to identify:\n  // - User preferences (code style, communication style, tool preferences)\n  // - User patterns (recurring topics, problem domains, technical interests)\n  // - User workflows (development habits, sequences, learning style)\n  // - Skill level (overall and per-domain assessment)\n  \"userProfileAnalysisInterval\": 10,\n\n  // Days before inactive items (all types) are eligible for removal\n  \"userProfileStaleDays\": 2,\n\n  // Days before an inactive workflow is eligible for removal. A workflow seen\n  // userProfileMinEvidenceForRetention times or more is kept.\n  \"userProfileWorkflowStaleDays\": 30,\n\n  // Number of preferences shown in UI\n  \"userProfileDisplayPreferences\": 20,\n  \n  // Number of patterns shown in UI\n  \"userProfileDisplayPatterns\": 15,\n  \n  // Number of workflows shown in UI\n  \"userProfileDisplayWorkflows\": 10,\n  \n  // Number of preferences injected into LLM conversation context\n  // Keep this small \u2014 the strongest signals are enough; more dilute LLM attention\n  \"userProfileInjectPreferences\": 5,\n  \n  // Number of patterns injected into LLM conversation context\n  \"userProfileInjectPatterns\": 5,\n  \n  // Number of workflows injected into LLM conversation context\n  \"userProfileInjectWorkflows\": 3,\n  \n  // Days before preference confidence starts to decay (if not reinforced)\n  // Preferences that aren't seen again will gradually lose confidence and be removed\n  \"userProfileConfidenceDecayDays\": 30,\n  \n  // Number of profile versions to keep in changelog (for rollback/debugging)\n  // Older versions are automatically cleaned up\n  \"userProfileChangelogRetentionCount\": 5,\n\n  // Minimum evidence count for a preference/pattern to survive confidence decay\n  // Items confirmed fewer times are more likely to be pruned when confidence decays\n  \"userProfileMinEvidenceForRetention\": 3,\n\n  // Merge duplicate or vague profile items every N analysed prompts (about 1 model call per 100 items)\n  \"userProfileAutoCleanupEnabled\": true,\n  \"userProfileAutoCleanupInterval\": 500,\n\n  // Enable LLM validation of existing preferences against recent behavior.\n  // When enabled, each analysis round checks if top-5 preferences still match recent prompts.\n  // Experimental \u2014 disabled by default.\n  \"userProfileValidationEnabled\": false,\n\n  // ============================================\n  // Search Settings\n  // ============================================\n   \n  // Minimum similarity score (0-1) for memory search results. Leave unset to\n  // follow the default for your embedding model: 0.5 for qwen3-embedding:0.6b\n  // (the only model measured), 0.6 for every other embedder.\n  // \"similarityThreshold\": 0.5,\n\n  // Maximum number of memories to return in search results.\n  // Manual searches can ask for fewer; prompt retrieval uses this ceiling.\n  \"maxMemories\": 10,\n\n  // ============================================\n  // Memory Context Controls\n  // ============================================\n\n  // Recent memories added at fresh session start (OpenCode V1 and Claude Code).\n  // Pi and OpenCode V2 search the store with each prompt instead.\n  \"chatMessage\": {\n    \"enabled\": true,\n    // Recent memories injected at session start.\n    \"maxMemories\": 3,\n    \"excludeCurrentSession\": true,\n    // When to inject: \"first\" message of a session or \"always\".\n    // \"injectOn\": \"first\",\n  },\n\n  // OpenCode profile-learning input limit, in UTF-8 bytes. Smaller values can\n  // omit prompts from that input. Does not limit Pi or Claude Code profile input.\n  \"userProfileMaxContextBytes\": 32768,\n\n  // Shared budget for automatic memory context (profile text, memories, and\n  // formatting) across all hosts, in approximate tokens: ceil(UTF-8 bytes / 4).\n  // Covers prompt retrieval, recent-memory injection, and session-memory\n  // restoration. Not an exact provider token limit or a spending limit.\n  \"retrievalMaxTokens\": 2000,\n\n  // Memorisation settings (global config only).\n  // Repeat for a session snapshot: \"add\" or \"replace\" (default \"add\").\n  // \"memorisationRepeat\": \"add\",\n  // Maximum stored text: 100 to 20,000 characters or 25 to 5,000 tokens.\n  // Tokens are estimated with the same rule as retrievalMaxTokens.\n  // \"memorisationMaxSize\": 2000,\n  // \"memorisationSizeUnit\": \"characters\", // or \"tokens\"\n\n  // Restore a session's own memories after compaction and after resume, on\n  // OpenCode V2, Pi and Claude Code. memoryLimit is the most memories to\n  // restore. A project config can turn it on or off.\n  // \"compaction\": { \"enabled\": true, \"memoryLimit\": 10 },\n\n  // ============================================\n  // Advanced Settings\n  // ============================================\n  \n  // Inject user profile into AI context (preferences, patterns, workflows)\n  \"injectProfile\": true\n}\n";

package/dist/config-template.js

@@ -402,6 +402,14 @@ export const CONFIG_TEMPLATE = `{
   // restoration. Not an exact provider token limit or a spending limit.
   "retrievalMaxTokens": 2000,
 
+  // Memorisation settings (global config only).
+  // Repeat for a session snapshot: "add" or "replace" (default "add").
+  // "memorisationRepeat": "add",
+  // Maximum stored text: 100 to 20,000 characters or 25 to 5,000 tokens.
+  // Tokens are estimated with the same rule as retrievalMaxTokens.
+  // "memorisationMaxSize": 2000,
+  // "memorisationSizeUnit": "characters", // or "tokens"
+
   // Restore a session's own memories after compaction and after resume, on
   // OpenCode V2, Pi and Claude Code. memoryLimit is the most memories to
   // restore. A project config can turn it on or off.

package/dist/config.d.ts

@@ -1,6 +1,7 @@
 import { isPlaceholderApiKey } from "./services/ai/api-key-placeholder.js";
 import { type KeywordMode } from "./utils/keyword-boost.js";
 import { type ActiveSpace } from "./services/spaces/active-space.js";
+import * as memorisation from "./core/memorisation-settings.js";
 interface OmmsConfig {
     storagePath?: string;
     userEmailOverride?: string;
@@ -28,6 +29,10 @@ interface OmmsConfig {
     keywordMode?: KeywordMode;
     /** Shared budget for automatic memory context in approximate tokens (ceil(UTF-8 bytes / 4)). */
     retrievalMaxTokens?: number;
+    /** Memorisation size and repeat behaviour. Global config only. */
+    memorisationMaxSize?: number;
+    memorisationSizeUnit?: memorisation.MemorisationSettings["memorisationSizeUnit"];
+    memorisationRepeat?: memorisation.MemorisationSettings["memorisationRepeat"];
     maxProfileItems?: number;
     injectProfile?: boolean;
     containerTagPrefix?: string;
@@ -196,26 +201,6 @@ declare function buildConfig(fileConfig: OmmsConfig): {
     skillLearning: boolean;
     skillLearningRedact: boolean;
     skillFolders: string[] | undefined;
-    storagePath: string;
-    /** The global `storagePath` when a project moved `storagePath`; `skills.db` stays there. */
-    skillStoragePath: string | undefined;
-    userEmailOverride: string | undefined;
-    userNameOverride: string | undefined;
-    embeddingModel: string;
-    embeddingDimensions: number;
-    embeddingUseTaskPrefixes: boolean;
-    embeddingApiUrl: string | undefined;
-    embeddingApiKey: string | undefined;
-    similarityThreshold: number;
-    rerankerEnabled: boolean;
-    rerankerApiUrl: string | undefined;
-    rerankerModel: string | undefined;
-    rerankerApiKey: string | undefined;
-    rerankerTimeoutMs: number;
-    keywordBoost: number;
-    keywordMode: KeywordMode;
-    maxMemories: number;
-    retrievalMaxTokens: number;
     maxProfileItems: number;
     injectProfile: boolean;
     containerTagPrefix: string;
@@ -241,6 +226,29 @@ declare function buildConfig(fileConfig: OmmsConfig): {
     captureTraceRetentionDays: number;
     captureAttemptRetentionDays: number;
     captureRetryRetentionHours: number;
+    memorisationMaxSize: number;
+    memorisationSizeUnit: import("./core/memorisation.js").MemorisationSizeUnit;
+    memorisationRepeat: import("./core/memorisation.js").MemorisationRepeat;
+    storagePath: string;
+    /** The global `storagePath` when a project moved `storagePath`; `skills.db` stays there. */
+    skillStoragePath: string | undefined;
+    userEmailOverride: string | undefined;
+    userNameOverride: string | undefined;
+    embeddingModel: string;
+    embeddingDimensions: number;
+    embeddingUseTaskPrefixes: boolean;
+    embeddingApiUrl: string | undefined;
+    embeddingApiKey: string | undefined;
+    similarityThreshold: number;
+    rerankerEnabled: boolean;
+    rerankerApiUrl: string | undefined;
+    rerankerModel: string | undefined;
+    rerankerApiKey: string | undefined;
+    rerankerTimeoutMs: number;
+    keywordBoost: number;
+    keywordMode: KeywordMode;
+    maxMemories: number;
+    retrievalMaxTokens: number;
 };
 export declare function getGlobalConfigSourcePath(): string | undefined;
 export declare function getGlobalConfigWritePath(): string;
@@ -310,26 +318,6 @@ export declare let CONFIG: {
     skillLearning: boolean;
     skillLearningRedact: boolean;
     skillFolders: string[] | undefined;
-    storagePath: string;
-    /** The global `storagePath` when a project moved `storagePath`; `skills.db` stays there. */
-    skillStoragePath: string | undefined;
-    userEmailOverride: string | undefined;
-    userNameOverride: string | undefined;
-    embeddingModel: string;
-    embeddingDimensions: number;
-    embeddingUseTaskPrefixes: boolean;
-    embeddingApiUrl: string | undefined;
-    embeddingApiKey: string | undefined;
-    similarityThreshold: number;
-    rerankerEnabled: boolean;
-    rerankerApiUrl: string | undefined;
-    rerankerModel: string | undefined;
-    rerankerApiKey: string | undefined;
-    rerankerTimeoutMs: number;
-    keywordBoost: number;
-    keywordMode: KeywordMode;
-    maxMemories: number;
-    retrievalMaxTokens: number;
     maxProfileItems: number;
     injectProfile: boolean;
     containerTagPrefix: string;
@@ -355,6 +343,29 @@ export declare let CONFIG: {
     captureTraceRetentionDays: number;
     captureAttemptRetentionDays: number;
     captureRetryRetentionHours: number;
+    memorisationMaxSize: number;
+    memorisationSizeUnit: import("./core/memorisation.js").MemorisationSizeUnit;
+    memorisationRepeat: import("./core/memorisation.js").MemorisationRepeat;
+    storagePath: string;
+    /** The global `storagePath` when a project moved `storagePath`; `skills.db` stays there. */
+    skillStoragePath: string | undefined;
+    userEmailOverride: string | undefined;
+    userNameOverride: string | undefined;
+    embeddingModel: string;
+    embeddingDimensions: number;
+    embeddingUseTaskPrefixes: boolean;
+    embeddingApiUrl: string | undefined;
+    embeddingApiKey: string | undefined;
+    similarityThreshold: number;
+    rerankerEnabled: boolean;
+    rerankerApiUrl: string | undefined;
+    rerankerModel: string | undefined;
+    rerankerApiKey: string | undefined;
+    rerankerTimeoutMs: number;
+    keywordBoost: number;
+    keywordMode: KeywordMode;
+    maxMemories: number;
+    retrievalMaxTokens: number;
 };
 type RuntimeConfig = ReturnType<typeof buildConfig>;
 export { getAutoCaptureProviderStatus, type AutoCaptureProviderStatus, } from "./services/ai/live-model-choice.js";