@cleocode/adapters 2.0.0

package/src/providers/claude-code/install.js

@@ -0,0 +1,237 @@
+/**
+ * Claude Code Install Provider
+ *
+ * Handles CLEO installation into Claude Code environments:
+ * - Registers CLEO MCP server in .mcp.json
+ * - Ensures CLAUDE.md has CLEO @-references
+ * - Manages plugin registration in ~/.claude/settings.json
+ *
+ * Migrated from src/core/install/claude-plugin.ts
+ *
+ * @task T5240
+ */
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+/** Lines that should appear in CLAUDE.md to reference CLEO. */
+const INSTRUCTION_REFERENCES = [
+    '@~/.cleo/templates/CLEO-INJECTION.md',
+    '@.cleo/memory-bridge.md',
+];
+/** MCP server registration key used in .mcp.json. */
+const MCP_SERVER_KEY = 'cleo';
+/**
+ * Install provider for Claude Code.
+ *
+ * Manages CLEO's integration with Claude Code by:
+ * 1. Registering the CLEO MCP server in the project's .mcp.json
+ * 2. Ensuring CLAUDE.md contains @-references to CLEO instruction files
+ * 3. Registering the brain observation plugin in ~/.claude/settings.json
+ */
+export class ClaudeCodeInstallProvider {
+    installedProjectDir = null;
+    /**
+     * Install CLEO into a Claude Code project.
+     *
+     * @param options - Installation options including project directory and MCP server path
+     * @returns Result describing what was installed
+     */
+    async install(options) {
+        const { projectDir, mcpServerPath } = options;
+        const installedAt = new Date().toISOString();
+        let instructionFileUpdated = false;
+        let mcpRegistered = false;
+        const details = {};
+        // Step 1: Register MCP server in .mcp.json
+        if (mcpServerPath) {
+            mcpRegistered = this.registerMcpServer(projectDir, mcpServerPath);
+            if (mcpRegistered) {
+                details.mcpConfigPath = join(projectDir, '.mcp.json');
+            }
+        }
+        // Step 2: Ensure CLAUDE.md has @-references
+        instructionFileUpdated = this.updateInstructionFile(projectDir);
+        if (instructionFileUpdated) {
+            details.instructionFile = join(projectDir, 'CLAUDE.md');
+        }
+        // Step 3: Register plugin in ~/.claude/settings.json
+        const pluginResult = this.registerPlugin();
+        if (pluginResult) {
+            details.plugin = pluginResult;
+        }
+        this.installedProjectDir = projectDir;
+        return {
+            success: true,
+            installedAt,
+            instructionFileUpdated,
+            mcpRegistered,
+            details,
+        };
+    }
+    /**
+     * Uninstall CLEO from the current Claude Code project.
+     *
+     * Removes the MCP server registration from .mcp.json.
+     * Does not remove CLAUDE.md references (they are harmless if CLEO is not present).
+     */
+    async uninstall() {
+        if (!this.installedProjectDir)
+            return;
+        const mcpPath = join(this.installedProjectDir, '.mcp.json');
+        if (existsSync(mcpPath)) {
+            try {
+                const raw = readFileSync(mcpPath, 'utf-8');
+                const config = JSON.parse(raw);
+                const mcpServers = config.mcpServers;
+                if (mcpServers && MCP_SERVER_KEY in mcpServers) {
+                    delete mcpServers[MCP_SERVER_KEY];
+                    writeFileSync(mcpPath, JSON.stringify(config, null, 2) + '\n', 'utf-8');
+                }
+            }
+            catch {
+                // Ignore errors during uninstall
+            }
+        }
+        this.installedProjectDir = null;
+    }
+    /**
+     * Check whether CLEO is installed in the current environment.
+     *
+     * Checks for:
+     * 1. MCP server registered in .mcp.json
+     * 2. Plugin enabled in ~/.claude/settings.json
+     *
+     * Returns true if either condition is met (partial install counts).
+     */
+    async isInstalled() {
+        // Check ~/.claude/settings.json for plugin registration
+        const settingsPath = join(homedir(), '.claude', 'settings.json');
+        if (existsSync(settingsPath)) {
+            try {
+                const settings = JSON.parse(readFileSync(settingsPath, 'utf-8'));
+                const plugins = settings.enabledPlugins;
+                if (plugins && plugins['cleo@cleocode'] === true) {
+                    return true;
+                }
+            }
+            catch {
+                // Fall through
+            }
+        }
+        // Check current directory for .mcp.json with cleo server
+        const mcpPath = join(process.cwd(), '.mcp.json');
+        if (existsSync(mcpPath)) {
+            try {
+                const config = JSON.parse(readFileSync(mcpPath, 'utf-8'));
+                const mcpServers = config.mcpServers;
+                if (mcpServers && MCP_SERVER_KEY in mcpServers) {
+                    return true;
+                }
+            }
+            catch {
+                // Fall through
+            }
+        }
+        return false;
+    }
+    /**
+     * Ensure CLAUDE.md contains @-references to CLEO instruction files.
+     *
+     * Creates CLAUDE.md if it does not exist. Appends any missing references.
+     *
+     * @param projectDir - Project root directory
+     */
+    async ensureInstructionReferences(projectDir) {
+        this.updateInstructionFile(projectDir);
+    }
+    /**
+     * Register the CLEO MCP server in .mcp.json.
+     *
+     * @returns true if registration was performed or updated
+     */
+    registerMcpServer(projectDir, mcpServerPath) {
+        const mcpPath = join(projectDir, '.mcp.json');
+        let config = {};
+        if (existsSync(mcpPath)) {
+            try {
+                config = JSON.parse(readFileSync(mcpPath, 'utf-8'));
+            }
+            catch {
+                // Start fresh on parse error
+            }
+        }
+        if (!config.mcpServers || typeof config.mcpServers !== 'object') {
+            config.mcpServers = {};
+        }
+        const mcpServers = config.mcpServers;
+        mcpServers[MCP_SERVER_KEY] = {
+            command: 'node',
+            args: [mcpServerPath],
+        };
+        writeFileSync(mcpPath, JSON.stringify(config, null, 2) + '\n', 'utf-8');
+        return true;
+    }
+    /**
+     * Update CLAUDE.md with CLEO @-references.
+     *
+     * @returns true if the file was created or modified
+     */
+    updateInstructionFile(projectDir) {
+        const claudeMdPath = join(projectDir, 'CLAUDE.md');
+        let content = '';
+        let existed = false;
+        if (existsSync(claudeMdPath)) {
+            content = readFileSync(claudeMdPath, 'utf-8');
+            existed = true;
+        }
+        const missingRefs = INSTRUCTION_REFERENCES.filter((ref) => !content.includes(ref));
+        if (missingRefs.length === 0) {
+            return false;
+        }
+        const refsBlock = missingRefs.join('\n');
+        if (existed) {
+            // Append missing references
+            const separator = content.endsWith('\n') ? '' : '\n';
+            content = content + separator + refsBlock + '\n';
+        }
+        else {
+            // Create new CLAUDE.md with references
+            content = refsBlock + '\n';
+        }
+        writeFileSync(claudeMdPath, content, 'utf-8');
+        return true;
+    }
+    /**
+     * Register the CLEO brain plugin in ~/.claude/settings.json.
+     *
+     * @returns Description of what was registered, or null if no change needed
+     */
+    registerPlugin() {
+        const home = homedir();
+        const settingsPath = join(home, '.claude', 'settings.json');
+        let settings = {};
+        if (existsSync(settingsPath)) {
+            try {
+                settings = JSON.parse(readFileSync(settingsPath, 'utf-8'));
+            }
+            catch {
+                // Start fresh
+            }
+        }
+        const enabledPlugins = settings.enabledPlugins ?? {};
+        const pluginKey = 'cleo@cleocode';
+        if (enabledPlugins[pluginKey] === true) {
+            return null;
+        }
+        // Disable old claude-mem if present
+        if (enabledPlugins['claude-mem@thedotmack'] === true) {
+            enabledPlugins['claude-mem@thedotmack'] = false;
+        }
+        enabledPlugins[pluginKey] = true;
+        settings.enabledPlugins = enabledPlugins;
+        mkdirSync(join(home, '.claude'), { recursive: true });
+        writeFileSync(settingsPath, JSON.stringify(settings, null, 2) + '\n', 'utf-8');
+        return `Enabled ${pluginKey} in ~/.claude/settings.json`;
+    }
+}
+//# sourceMappingURL=install.js.map

package/src/providers/claude-code/install.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"install.js","sourceRoot":"","sources":["install.ts"],"names":[],"mappings":"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"}

package/src/providers/claude-code/install.ts

@@ -0,0 +1,267 @@
+/**
+ * Claude Code Install Provider
+ *
+ * Handles CLEO installation into Claude Code environments:
+ * - Registers CLEO MCP server in .mcp.json
+ * - Ensures CLAUDE.md has CLEO @-references
+ * - Manages plugin registration in ~/.claude/settings.json
+ *
+ * Migrated from src/core/install/claude-plugin.ts
+ *
+ * @task T5240
+ */
+
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+import type { AdapterInstallProvider, InstallOptions, InstallResult } from '@cleocode/contracts';
+
+/** Lines that should appear in CLAUDE.md to reference CLEO. */
+const INSTRUCTION_REFERENCES = [
+  '@~/.cleo/templates/CLEO-INJECTION.md',
+  '@.cleo/memory-bridge.md',
+];
+
+/** MCP server registration key used in .mcp.json. */
+const MCP_SERVER_KEY = 'cleo';
+
+/**
+ * Install provider for Claude Code.
+ *
+ * Manages CLEO's integration with Claude Code by:
+ * 1. Registering the CLEO MCP server in the project's .mcp.json
+ * 2. Ensuring CLAUDE.md contains @-references to CLEO instruction files
+ * 3. Registering the brain observation plugin in ~/.claude/settings.json
+ */
+export class ClaudeCodeInstallProvider implements AdapterInstallProvider {
+  private installedProjectDir: string | null = null;
+
+  /**
+   * Install CLEO into a Claude Code project.
+   *
+   * @param options - Installation options including project directory and MCP server path
+   * @returns Result describing what was installed
+   */
+  async install(options: InstallOptions): Promise<InstallResult> {
+    const { projectDir, mcpServerPath } = options;
+    const installedAt = new Date().toISOString();
+    let instructionFileUpdated = false;
+    let mcpRegistered = false;
+    const details: Record<string, unknown> = {};
+
+    // Step 1: Register MCP server in .mcp.json
+    if (mcpServerPath) {
+      mcpRegistered = this.registerMcpServer(projectDir, mcpServerPath);
+      if (mcpRegistered) {
+        details.mcpConfigPath = join(projectDir, '.mcp.json');
+      }
+    }
+
+    // Step 2: Ensure CLAUDE.md has @-references
+    instructionFileUpdated = this.updateInstructionFile(projectDir);
+    if (instructionFileUpdated) {
+      details.instructionFile = join(projectDir, 'CLAUDE.md');
+    }
+
+    // Step 3: Register plugin in ~/.claude/settings.json
+    const pluginResult = this.registerPlugin();
+    if (pluginResult) {
+      details.plugin = pluginResult;
+    }
+
+    this.installedProjectDir = projectDir;
+
+    return {
+      success: true,
+      installedAt,
+      instructionFileUpdated,
+      mcpRegistered,
+      details,
+    };
+  }
+
+  /**
+   * Uninstall CLEO from the current Claude Code project.
+   *
+   * Removes the MCP server registration from .mcp.json.
+   * Does not remove CLAUDE.md references (they are harmless if CLEO is not present).
+   */
+  async uninstall(): Promise<void> {
+    if (!this.installedProjectDir) return;
+
+    const mcpPath = join(this.installedProjectDir, '.mcp.json');
+    if (existsSync(mcpPath)) {
+      try {
+        const raw = readFileSync(mcpPath, 'utf-8');
+        const config = JSON.parse(raw) as Record<string, unknown>;
+        const mcpServers = config.mcpServers as Record<string, unknown> | undefined;
+        if (mcpServers && MCP_SERVER_KEY in mcpServers) {
+          delete mcpServers[MCP_SERVER_KEY];
+          writeFileSync(mcpPath, JSON.stringify(config, null, 2) + '\n', 'utf-8');
+        }
+      } catch {
+        // Ignore errors during uninstall
+      }
+    }
+
+    this.installedProjectDir = null;
+  }
+
+  /**
+   * Check whether CLEO is installed in the current environment.
+   *
+   * Checks for:
+   * 1. MCP server registered in .mcp.json
+   * 2. Plugin enabled in ~/.claude/settings.json
+   *
+   * Returns true if either condition is met (partial install counts).
+   */
+  async isInstalled(): Promise<boolean> {
+    // Check ~/.claude/settings.json for plugin registration
+    const settingsPath = join(homedir(), '.claude', 'settings.json');
+    if (existsSync(settingsPath)) {
+      try {
+        const settings = JSON.parse(readFileSync(settingsPath, 'utf-8'));
+        const plugins = settings.enabledPlugins as Record<string, boolean> | undefined;
+        if (plugins && plugins['cleo@cleocode'] === true) {
+          return true;
+        }
+      } catch {
+        // Fall through
+      }
+    }
+
+    // Check current directory for .mcp.json with cleo server
+    const mcpPath = join(process.cwd(), '.mcp.json');
+    if (existsSync(mcpPath)) {
+      try {
+        const config = JSON.parse(readFileSync(mcpPath, 'utf-8'));
+        const mcpServers = config.mcpServers as Record<string, unknown> | undefined;
+        if (mcpServers && MCP_SERVER_KEY in mcpServers) {
+          return true;
+        }
+      } catch {
+        // Fall through
+      }
+    }
+
+    return false;
+  }
+
+  /**
+   * Ensure CLAUDE.md contains @-references to CLEO instruction files.
+   *
+   * Creates CLAUDE.md if it does not exist. Appends any missing references.
+   *
+   * @param projectDir - Project root directory
+   */
+  async ensureInstructionReferences(projectDir: string): Promise<void> {
+    this.updateInstructionFile(projectDir);
+  }
+
+  /**
+   * Register the CLEO MCP server in .mcp.json.
+   *
+   * @returns true if registration was performed or updated
+   */
+  private registerMcpServer(projectDir: string, mcpServerPath: string): boolean {
+    const mcpPath = join(projectDir, '.mcp.json');
+    let config: Record<string, unknown> = {};
+
+    if (existsSync(mcpPath)) {
+      try {
+        config = JSON.parse(readFileSync(mcpPath, 'utf-8'));
+      } catch {
+        // Start fresh on parse error
+      }
+    }
+
+    if (!config.mcpServers || typeof config.mcpServers !== 'object') {
+      config.mcpServers = {};
+    }
+
+    const mcpServers = config.mcpServers as Record<string, unknown>;
+    mcpServers[MCP_SERVER_KEY] = {
+      command: 'node',
+      args: [mcpServerPath],
+    };
+
+    writeFileSync(mcpPath, JSON.stringify(config, null, 2) + '\n', 'utf-8');
+    return true;
+  }
+
+  /**
+   * Update CLAUDE.md with CLEO @-references.
+   *
+   * @returns true if the file was created or modified
+   */
+  private updateInstructionFile(projectDir: string): boolean {
+    const claudeMdPath = join(projectDir, 'CLAUDE.md');
+    let content = '';
+    let existed = false;
+
+    if (existsSync(claudeMdPath)) {
+      content = readFileSync(claudeMdPath, 'utf-8');
+      existed = true;
+    }
+
+    const missingRefs = INSTRUCTION_REFERENCES.filter((ref) => !content.includes(ref));
+
+    if (missingRefs.length === 0) {
+      return false;
+    }
+
+    const refsBlock = missingRefs.join('\n');
+
+    if (existed) {
+      // Append missing references
+      const separator = content.endsWith('\n') ? '' : '\n';
+      content = content + separator + refsBlock + '\n';
+    } else {
+      // Create new CLAUDE.md with references
+      content = refsBlock + '\n';
+    }
+
+    writeFileSync(claudeMdPath, content, 'utf-8');
+    return true;
+  }
+
+  /**
+   * Register the CLEO brain plugin in ~/.claude/settings.json.
+   *
+   * @returns Description of what was registered, or null if no change needed
+   */
+  private registerPlugin(): string | null {
+    const home = homedir();
+    const settingsPath = join(home, '.claude', 'settings.json');
+
+    let settings: Record<string, unknown> = {};
+    if (existsSync(settingsPath)) {
+      try {
+        settings = JSON.parse(readFileSync(settingsPath, 'utf-8'));
+      } catch {
+        // Start fresh
+      }
+    }
+
+    const enabledPlugins = (settings.enabledPlugins as Record<string, boolean>) ?? {};
+    const pluginKey = 'cleo@cleocode';
+
+    if (enabledPlugins[pluginKey] === true) {
+      return null;
+    }
+
+    // Disable old claude-mem if present
+    if (enabledPlugins['claude-mem@thedotmack'] === true) {
+      enabledPlugins['claude-mem@thedotmack'] = false;
+    }
+
+    enabledPlugins[pluginKey] = true;
+    settings.enabledPlugins = enabledPlugins;
+
+    mkdirSync(join(home, '.claude'), { recursive: true });
+    writeFileSync(settingsPath, JSON.stringify(settings, null, 2) + '\n', 'utf-8');
+
+    return `Enabled ${pluginKey} in ~/.claude/settings.json`;
+  }
+}

package/src/providers/claude-code/manifest.json

@@ -0,0 +1,26 @@
+{
+  "id": "claude-code",
+  "name": "Claude Code Adapter",
+  "version": "1.0.0",
+  "description": "CLEO adapter for Anthropic Claude Code CLI",
+  "provider": "claude-code",
+  "entryPoint": "src/index.ts",
+  "capabilities": {
+    "supportsHooks": true,
+    "supportedHookEvents": ["onSessionStart", "onSessionEnd", "onToolStart", "onToolComplete", "onError"],
+    "supportsSpawn": true,
+    "supportsInstall": true,
+    "supportsMcp": true,
+    "supportsInstructionFiles": true,
+    "instructionFilePattern": "CLAUDE.md",
+    "supportsContextMonitor": true,
+    "supportsStatusline": true,
+    "supportsProviderPaths": true,
+    "supportsTransport": true
+  },
+  "detectionPatterns": [
+    { "type": "env", "pattern": "CLAUDE_CODE_ENTRYPOINT", "description": "Claude Code sets this env var" },
+    { "type": "file", "pattern": ".claude/settings.json", "description": "Claude Code config directory" },
+    { "type": "cli", "pattern": "claude", "description": "Claude CLI available in PATH" }
+  ]
+}

package/src/providers/claude-code/paths.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Claude Code path provider.
+ *
+ * Implements AdapterPathProvider with Claude Code-specific directory locations.
+ *
+ * @task T5240
+ */
+import type { AdapterPathProvider } from '@cleocode/contracts';
+/**
+ * Path provider for Anthropic Claude Code CLI.
+ *
+ * Resolves Claude Code's standard directory layout:
+ * - Config dir: ~/.claude (or CLAUDE_HOME)
+ * - Settings: ~/.claude/settings.json (or CLAUDE_SETTINGS)
+ * - Agents: ~/.claude/agents
+ * - Memory DB: ~/.claude-mem/claude-mem.db (or CLAUDE_MEM_DB)
+ */
+export declare class ClaudeCodePathProvider implements AdapterPathProvider {
+    getProviderDir(): string;
+    getSettingsPath(): string | null;
+    getAgentInstallDir(): string | null;
+    getMemoryDbPath(): string | null;
+}
+//# sourceMappingURL=paths.d.ts.map

package/src/providers/claude-code/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["paths.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAE/D;;;;;;;;GAQG;AACH,qBAAa,sBAAuB,YAAW,mBAAmB;IAChE,cAAc,IAAI,MAAM;IAIxB,eAAe,IAAI,MAAM,GAAG,IAAI;IAIhC,kBAAkB,IAAI,MAAM,GAAG,IAAI;IAInC,eAAe,IAAI,MAAM,GAAG,IAAI;CAGjC"}

package/src/providers/claude-code/paths.js

@@ -0,0 +1,33 @@
+/**
+ * Claude Code path provider.
+ *
+ * Implements AdapterPathProvider with Claude Code-specific directory locations.
+ *
+ * @task T5240
+ */
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+/**
+ * Path provider for Anthropic Claude Code CLI.
+ *
+ * Resolves Claude Code's standard directory layout:
+ * - Config dir: ~/.claude (or CLAUDE_HOME)
+ * - Settings: ~/.claude/settings.json (or CLAUDE_SETTINGS)
+ * - Agents: ~/.claude/agents
+ * - Memory DB: ~/.claude-mem/claude-mem.db (or CLAUDE_MEM_DB)
+ */
+export class ClaudeCodePathProvider {
+    getProviderDir() {
+        return process.env['CLAUDE_HOME'] ?? join(homedir(), '.claude');
+    }
+    getSettingsPath() {
+        return process.env['CLAUDE_SETTINGS'] ?? join(this.getProviderDir(), 'settings.json');
+    }
+    getAgentInstallDir() {
+        return join(this.getProviderDir(), 'agents');
+    }
+    getMemoryDbPath() {
+        return process.env['CLAUDE_MEM_DB'] ?? join(homedir(), '.claude-mem', 'claude-mem.db');
+    }
+}
+//# sourceMappingURL=paths.js.map

package/src/providers/claude-code/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["paths.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAGjC;;;;;;;;GAQG;AACH,MAAM,OAAO,sBAAsB;IACjC,cAAc;QACZ,OAAO,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,CAAC,CAAC;IAClE,CAAC;IAED,eAAe;QACb,OAAO,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,EAAE,eAAe,CAAC,CAAC;IACxF,CAAC;IAED,kBAAkB;QAChB,OAAO,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,EAAE,QAAQ,CAAC,CAAC;IAC/C,CAAC;IAED,eAAe;QACb,OAAO,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,aAAa,EAAE,eAAe,CAAC,CAAC;IACzF,CAAC;CACF"}

package/src/providers/claude-code/paths.ts

@@ -0,0 +1,38 @@
+/**
+ * Claude Code path provider.
+ *
+ * Implements AdapterPathProvider with Claude Code-specific directory locations.
+ *
+ * @task T5240
+ */
+
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+import type { AdapterPathProvider } from '@cleocode/contracts';
+
+/**
+ * Path provider for Anthropic Claude Code CLI.
+ *
+ * Resolves Claude Code's standard directory layout:
+ * - Config dir: ~/.claude (or CLAUDE_HOME)
+ * - Settings: ~/.claude/settings.json (or CLAUDE_SETTINGS)
+ * - Agents: ~/.claude/agents
+ * - Memory DB: ~/.claude-mem/claude-mem.db (or CLAUDE_MEM_DB)
+ */
+export class ClaudeCodePathProvider implements AdapterPathProvider {
+  getProviderDir(): string {
+    return process.env['CLAUDE_HOME'] ?? join(homedir(), '.claude');
+  }
+
+  getSettingsPath(): string | null {
+    return process.env['CLAUDE_SETTINGS'] ?? join(this.getProviderDir(), 'settings.json');
+  }
+
+  getAgentInstallDir(): string | null {
+    return join(this.getProviderDir(), 'agents');
+  }
+
+  getMemoryDbPath(): string | null {
+    return process.env['CLAUDE_MEM_DB'] ?? join(homedir(), '.claude-mem', 'claude-mem.db');
+  }
+}