squish-memory 1.1.5 → 1.2.1

package/config/settings.json

@@ -1,52 +1,107 @@
-{
-  "$schema": "./settings.schema.json",
-  "embeddings": {
-    "enabled": true,
-    "provider": "local",
-    "models": {
-      "openai": {
-        "model": "text-embedding-3-small",
-        "availableModels": [
-          "text-embedding-3-small",
-          "text-embedding-3-large"
-        ]
-      },
-      "google": {
-        "model": "gemini-embedding-001",
-        "availableModels": [
-          "gemini-embedding-001",
-          "gemini-embedding-2"
-        ]
-      },
-      "ollama": {
-        "model": "nomic-embed-text:v1.5",
-        "availableModels": [
-          "nomic-embed-text:v1.5",
-          "mxbai-embed-large"
-        ]
-      }
-    }
-  },
-  "api": {
-    "openai": {
-      "apiKey": null,
-      "apiUrl": "https://api.openai.com/v1/embeddings"
-    },
-    "google": {
-      "apiKey": null,
-      "projectId": null
-    },
-    "ollama": {
-      "url": "http://localhost:11434"
-    }
-  },
-  "mcp": {
-    "serverPort": 8767,
-    "serverEnabled": true
-  },
-  "features": {
-    "lifecycleEnabled": true,
-    "summarizationEnabled": true,
-    "agentIsolation": true
-  }
-}
+{
+  "$schema": "./settings.schema.json",
+  "version": "1.2.0",
+  "data": {
+    "dir": ".squish"
+  },
+  "mcp": {
+    "serverPort": 8767,
+    "serverEnabled": true,
+    "mode": "stdio"
+  },
+  "database": {
+    "type": "sqlite",
+    "url": ""
+  },
+  "embeddings": {
+    "enabled": true,
+    "provider": "local",
+    "timeout": 30000,
+    "maxRetries": 3,
+    "retryDelay": 1000,
+    "models": {
+      "openai": {
+        "model": "",
+        "apiUrl": "https://api.openai.com/v1/embeddings"
+      },
+      "google": {
+        "model": "",
+        "location": "us-central1"
+      },
+      "ollama": {
+        "url": "http://localhost:11434",
+        "model": ""
+      },
+      "lmstudio": {
+        "url": "http://localhost:1234",
+        "model": ""
+      },
+      "transformers": {
+        "model": ""
+      }
+    }
+  },
+  "api": {
+    "openai": {
+      "apiUrl": "https://api.openai.com/v1/embeddings"
+    },
+    "google": {
+      "location": "us-central1"
+    },
+    "ollama": {
+      "url": "http://localhost:11434"
+    },
+    "lmstudio": {
+      "url": "http://localhost:1234"
+    }
+  },
+  "security": {
+    "encryptionEnabled": false
+  },
+  "features": {
+    "lifecycleEnabled": true,
+    "summarizationEnabled": true,
+    "agentIsolation": true,
+    "governanceEnabled": true,
+    "consolidationEnabled": false,
+    "obsidianEnabled": false,
+    "externalMemoryEnabled": false,
+    "sessionAutoLoadEnabled": true,
+    "queryRewritingEnabled": true,
+    "queryRewritingFallbackEnabled": true,
+    "feedbackTrackingEnabled": true
+  },
+  "llm": {
+    "enabled": false,
+    "provider": "openai",
+    "endpoint": "",
+    "models": {
+      "extraction": "",
+      "reasoning": ""
+    }
+  },
+  "graph": {
+    "autoBuild": true,
+    "extractionMethod": "auto",
+    "maxContentLength": 10000
+  },
+  "scoring": {
+    "weights": {
+      "recency": 0.5,
+      "relevance": 3,
+      "importance": 2,
+      "vectorSim": 3,
+      "graphBoost": 1.5
+    }
+  },
+  "scheduler": {
+    "mode": "cron",
+    "cronEnabled": true,
+    "heartbeatInterval": 60000,
+    "jobRetentionDays": 30
+  },
+  "coreMemory": {
+    "totalBytes": 16384,
+    "sectionBytes": 4096
+  }
+}

package/config.js

@@ -0,0 +1,5 @@
+// Re-export from config.ts - needed because imports use .js extension
+export * from './config.ts';
+export { config, getDataDir } from './config.ts';
+import config from './config.ts';
+export default config;

package/config.ts

@@ -0,0 +1,218 @@
+import { join } from 'path';
+import { mkdirSync, existsSync, readFileSync } from 'fs';
+import { fileURLToPath } from 'url';
+import { dirname } from 'path';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+
+type Settings = Record<string, unknown>;
+
+const EMBEDDINGS_PROVIDERS = ['openai', 'ollama', 'lmstudio', 'transformers', 'local', 'none', 'google', 'auto'] as const;
+const LLM_PROVIDERS = ['openai', 'anthropic', 'ollama', 'lmstudio', 'local'] as const;
+const GRAPH_EXTRACTION_METHODS = ['llm', 'regex', 'auto'] as const;
+const SCHEDULER_MODES = ['cron', 'interval', 'heartbeat'] as const;
+const VISIBILITY_SCOPES = ['private', 'project', 'team', 'global'] as const;
+
+function loadSettings(): Settings {
+  const settingsPath = join(__dirname, 'config', 'settings.json');
+  try {
+    if (existsSync(settingsPath)) {
+      return JSON.parse(readFileSync(settingsPath, 'utf-8'));
+    }
+  } catch {
+    console.warn('Failed to load settings.json, using defaults');
+  }
+  return {};
+}
+
+const settings = loadSettings();
+
+function readPath(path: string): unknown {
+  let value: unknown = settings;
+  for (const key of path.split('.')) {
+    if (value && typeof value === 'object' && key in value) {
+      value = (value as Record<string, unknown>)[key];
+    } else {
+      return undefined;
+    }
+  }
+  return value;
+}
+
+function rawConfig(path: string, envVar: string | null, defaultValue: unknown): unknown {
+  if (envVar && Object.prototype.hasOwnProperty.call(process.env, envVar)) {
+    return process.env[envVar];
+  }
+  const settingsValue = readPath(path);
+  return settingsValue === undefined ? defaultValue : settingsValue;
+}
+
+function getString(path: string, envVar: string | null, defaultValue: string): string {
+  const value = rawConfig(path, envVar, defaultValue);
+  return typeof value === 'string' ? value : String(value ?? defaultValue);
+}
+
+function getBoolean(path: string, envVar: string | null, defaultValue: boolean): boolean {
+  const value = rawConfig(path, envVar, defaultValue);
+  if (typeof value === 'boolean') return value;
+  if (typeof value === 'number') return value !== 0;
+  if (typeof value === 'string') {
+    const normalized = value.trim().toLowerCase();
+    if (['true', '1', 'yes', 'on'].includes(normalized)) return true;
+    if (['false', '0', 'no', 'off', ''].includes(normalized)) return false;
+  }
+  return defaultValue;
+}
+
+function getNumber(path: string, envVar: string | null, defaultValue: number): number {
+  const value = rawConfig(path, envVar, defaultValue);
+  const parsed = typeof value === 'number' ? value : Number(value);
+  return Number.isFinite(parsed) ? parsed : defaultValue;
+}
+
+function getEnum<T extends readonly string[]>(
+  path: string,
+  envVar: string | null,
+  allowed: T,
+  defaultValue: T[number]
+): T[number] {
+  const value = getString(path, envVar, defaultValue).toLowerCase();
+  return allowed.includes(value) ? value : defaultValue;
+}
+
+export function getDataDir(): string {
+  const projectRoot = process.env.CLAUDE_WORKING_DIRECTORY || process.cwd();
+  const dir = getString('data.dir', 'SQUISH_DATA_DIR', join(projectRoot, '.squish'));
+  if (!existsSync(dir)) mkdirSync(dir, { recursive: true });
+  return dir;
+}
+
+const databaseUrl = process.env.DATABASE_URL || '';
+const supabaseUrlEnv = process.env.SUPABASE_URL || '';
+const neonProjectIdEnv = process.env.NEON_PROJECT_ID || '';
+
+function detectMode(): 'local' | 'team' | 'remote' {
+  if (supabaseUrlEnv || neonProjectIdEnv) return 'remote';
+  if (databaseUrl.startsWith('postgres')) return 'team';
+  return 'local';
+}
+
+const detectedMode = detectMode();
+const embeddingsProvider = getEnum('embeddings.provider', 'SQUISH_EMBEDDINGS_PROVIDER', EMBEDDINGS_PROVIDERS, 'local');
+const llmEnabled = getBoolean('llm.enabled', 'SQUISH_LLM_ENABLED', false);
+const llmProvider = getEnum('llm.provider', 'SQUISH_LLM_PROVIDER', LLM_PROVIDERS, 'openai');
+const llmEndpoint = getString('llm.endpoint', 'SQUISH_LLM_ENDPOINT', '');
+const graphAutoBuild = getBoolean('graph.autoBuild', 'SQUISH_GRAPH_AUTO_BUILD', true);
+const graphExtractionMethod = getEnum('graph.extractionMethod', 'SQUISH_GRAPH_EXTRACTION_METHOD', GRAPH_EXTRACTION_METHODS, 'auto');
+const graphMaxContentLength = getNumber('graph.maxContentLength', 'SQUISH_GRAPH_MAX_CONTENT_LENGTH', 10000);
+
+const scoringWeights = {
+  recency: getNumber('scoring.weights.recency', 'SQUISH_WEIGHT_RECENCY', 0.5),
+  relevance: getNumber('scoring.weights.relevance', 'SQUISH_WEIGHT_RELEVANCE', 3),
+  importance: getNumber('scoring.weights.importance', 'SQUISH_WEIGHT_IMPORTANCE', 2),
+  vectorSim: getNumber('scoring.weights.vectorSim', 'SQUISH_WEIGHT_VECTOR_SIM', 3),
+  graphBoost: getNumber('scoring.weights.graphBoost', 'SQUISH_WEIGHT_GRAPH_BOOST', 1.5),
+};
+
+export const config = {
+  mode: detectedMode,
+  isLocalMode: detectedMode === 'local',
+  isTeamMode: detectedMode === 'team',
+  isRemoteMode: detectedMode === 'remote',
+  teamBackend: getEnum('team.backend', 'SQUISH_TEAM_BACKEND', ['postgres', 'supabase', 'neon'] as const, 'postgres'),
+  remoteBackend: getEnum('remote.backend', 'SQUISH_REMOTE_BACKEND', ['supabase', 'neon'] as const, 'supabase'),
+
+  isManagedMode: getBoolean('managed.enabled', 'SQUISH_MANAGED_MODE', false),
+  managedMode: getBoolean('managed.enabled', 'SQUISH_MANAGED_MODE', false),
+  managedApiUrl: getString('managed.apiUrl', 'SQUISH_MANAGED_API_URL', 'https://api.squish.dev'),
+  managedApiKey: getString('managed.apiKey', 'SQUISH_MANAGED_API_KEY', ''),
+  redisEnabled: Boolean(process.env.REDIS_URL),
+  dataDir: getDataDir(),
+  mcpServerPort: getNumber('mcp.serverPort', 'SQUISH_MCP_PORT', 8767),
+
+  embeddingsProvider,
+  openAiApiKey: process.env.SQUISH_OPENAI_API_KEY || process.env.OPENAI_API_KEY || '',
+  openAiApiUrl: getString('api.openai.apiUrl', 'SQUISH_OPENAI_API_URL', 'https://api.openai.com/v1/embeddings'),
+  openAiEmbeddingModel: getString('embeddings.models.openai.model', 'SQUISH_OPENAI_EMBEDDING_MODEL', ''),
+  googleCloudApiKey: process.env.GOOGLE_CLOUD_API_KEY || process.env.SQUISH_GOOGLE_CLOUD_API_KEY || '',
+  googleCloudProject: process.env.GOOGLE_CLOUD_PROJECT || process.env.SQUISH_GOOGLE_CLOUD_PROJECT || '',
+  googleCloudLocation: process.env.GOOGLE_CLOUD_LOCATION || process.env.SQUISH_GOOGLE_CLOUD_LOCATION || 'us-central1',
+  googleEmbeddingModel: getString('embeddings.models.google.model', 'SQUISH_GOOGLE_EMBEDDING_MODEL', ''),
+  ollamaUrl: getString('api.ollama.url', 'SQUISH_OLLAMA_URL', 'http://localhost:11434'),
+  ollamaEmbeddingModel: getString('embeddings.models.ollama.model', 'SQUISH_OLLAMA_EMBEDDING_MODEL', ''),
+  lmStudioUrl: getString('api.lmstudio.url', 'SQUISH_LM_STUDIO_URL', 'http://localhost:1234'),
+  lmStudioEmbeddingModel: getString('embeddings.models.lmstudio.model', 'SQUISH_LM_STUDIO_EMBEDDING_MODEL', ''),
+  transformersLocalModel: getString('embeddings.models.transformers.model', 'SQUISH_LOCAL_MODEL', ''),
+
+  supabaseUrl: getString('supabase.url', 'SUPABASE_URL', ''),
+  supabaseKey: getString('supabase.key', 'SUPABASE_SERVICE_KEY', ''),
+  neonProjectId: process.env.NEON_PROJECT_ID || '',
+  neonServiceKey: process.env.NEON_SERVICE_KEY || '',
+  clientEncryptionEnabled: getBoolean('security.encryptionEnabled', null, false),
+  encryptionPassphrase: process.env.SQUISH_ENCRYPTION_PASSPHRASE || '',
+
+  lifecycleEnabled: getBoolean('features.lifecycleEnabled', 'SQUISH_LIFECYCLE_ENABLED', true),
+  lifecycleInterval: getNumber('lifecycle.interval', 'SQUISH_LIFECYCLE_INTERVAL', 3600000),
+  decayThreshold: getNumber('lifecycle.decay.threshold', 'SQUISH_DECAY_THRESHOLD', 0.1),
+  sectorDecayIntervals: {
+    episodic: getNumber('lifecycle.decay.episodic', 'SQUISH_DECAY_EPISODIC', 30),
+    semantic: getNumber('lifecycle.decay.semantic', 'SQUISH_DECAY_SEMANTIC', 90),
+    procedural: getNumber('lifecycle.decay.procedural', 'SQUISH_DECAY_PROCEDURAL', 180),
+    autobiographical: getNumber('lifecycle.decay.autobiographical', 'SQUISH_DECAY_AUTOBIOGRAPHICAL', 365),
+    working: getNumber('lifecycle.decay.working', 'SQUISH_DECAY_WORKING', 7),
+  },
+
+  summarizationEnabled: getBoolean('features.summarizationEnabled', 'SQUISH_SUMMARIZATION_ENABLED', true),
+  incrementalThreshold: getNumber('summarization.incrementalThreshold', 'SQUISH_INCREMENTAL_THRESHOLD', 10),
+  rollingWindowSize: getNumber('summarization.rollingWindowSize', 'SQUISH_ROLLING_WINDOW_SIZE', 50),
+  agentIsolationEnabled: getBoolean('features.agentIsolation', 'SQUISH_AGENT_ISOLATION_ENABLED', true),
+  defaultVisibilityScope: getEnum('visibility.defaultScope', 'SQUISH_DEFAULT_VISIBILITY', VISIBILITY_SCOPES, 'private'),
+  governanceEnabled: getBoolean('features.governanceEnabled', 'SQUISH_GOVERNANCE_ENABLED', true),
+  consolidationEnabled: getBoolean('features.consolidationEnabled', 'SQUISH_CONSOLIDATION_ENABLED', false),
+  consolidationSimilarityThreshold: getNumber('consolidation.similarityThreshold', 'SQUISH_CONSOLIDATION_THRESHOLD', 0.8),
+  obsidianEnabled: getBoolean('features.obsidianEnabled', 'SQUISH_OBSIDIAN_ENABLED', false),
+  obsidianVaultPath: getString('obsidian.vaultPath', 'SQUISH_OBSIDIAN_VAULT_PATH', ''),
+  externalMemoryEnabled: getBoolean('features.externalMemoryEnabled', 'SQUISH_EXTERNAL_MEMORY_ENABLED', false),
+  externalMemoryPath: getString('external.memoryPath', 'SQUISH_EXTERNAL_MEMORY_PATH', ''),
+
+  sessionAutoLoadEnabled: getBoolean('features.sessionAutoLoadEnabled', 'SQUISH_SESSION_AUTO_LOAD', true),
+  sessionAutoLoadRecentCount: getNumber('session.autoLoadRecentCount', 'SQUISH_SESSION_AUTO_LOAD_RECENT_COUNT', 5),
+  sessionAutoLoadImportanceThreshold: getNumber('session.autoLoadImportanceThreshold', 'SQUISH_SESSION_AUTO_LOAD_IMPORTANCE_THRESHOLD', 70),
+  queryRewritingEnabled: getBoolean('features.queryRewritingEnabled', 'SQUISH_QUERY_REWRITING', true),
+  queryRewritingContextMessages: getNumber('query.rewritingContextMessages', 'SQUISH_QUERY_REWRITING_CONTEXT_MESSAGES', 5),
+  queryRewritingFallbackEnabled: getBoolean('features.queryRewritingFallbackEnabled', 'SQUISH_QUERY_REWRITING_FALLBACK', true),
+  feedbackTrackingEnabled: getBoolean('features.feedbackTrackingEnabled', 'SQUISH_FEEDBACK_TRACKING', true),
+  feedbackEchoBonus: getNumber('feedback.echoBonus', 'SQUISH_FEEDBACK_ECHO_BONUS', 10),
+  feedbackFizzlePenalty: getNumber('feedback.fizzlePenalty', 'SQUISH_FEEDBACK_FIZZLE_PENALTY', 5),
+  scoringWeights,
+
+  schedulerMode: getEnum('scheduler.mode', 'SQUISH_SCHEDULER_MODE', SCHEDULER_MODES, 'cron'),
+  cronEnabled: getBoolean('scheduler.cronEnabled', 'SQUISH_CRON_ENABLED', true),
+  heartbeatInterval: getNumber('scheduler.heartbeatInterval', 'SQUISH_HEARTBEAT_INTERVAL', 60000),
+  jobRetentionDays: getNumber('scheduler.jobRetentionDays', 'SQUISH_JOB_RETENTION_DAYS', 30),
+  coreMemoryTotalBytes: getNumber('coreMemory.totalBytes', 'SQUISH_CORE_MEMORY_TOTAL_BYTES', 16384),
+  coreMemorySectionBytes: getNumber('coreMemory.sectionBytes', 'SQUISH_CORE_MEMORY_SECTION_BYTES', 4096),
+
+  embeddingsTimeoutMs: getNumber('embeddings.timeout', 'SQUISH_EMBEDDINGS_TIMEOUT_MS', 30000),
+  embeddingsMaxRetries: getNumber('embeddings.maxRetries', 'SQUISH_EMBEDDINGS_MAX_RETRIES', 3),
+  embeddingsRetryDelayMs: getNumber('embeddings.retryDelay', 'SQUISH_EMBEDDINGS_RETRY_DELAY_MS', 1000),
+  openAiTimeoutMs: getNumber('embeddings.models.openai.timeout', 'SQUISH_OPENAI_TIMEOUT_MS', getNumber('embeddings.timeout', 'SQUISH_EMBEDDINGS_TIMEOUT_MS', 30000)),
+  ollamaTimeoutMs: getNumber('embeddings.models.ollama.timeout', 'SQUISH_OLLAMA_TIMEOUT_MS', getNumber('embeddings.timeout', 'SQUISH_EMBEDDINGS_TIMEOUT_MS', 30000)),
+  googleTimeoutMs: getNumber('embeddings.models.google.timeout', 'SQUISH_GOOGLE_TIMEOUT_MS', getNumber('embeddings.timeout', 'SQUISH_EMBEDDINGS_TIMEOUT_MS', 30000)),
+
+  llmEnabled,
+  llmApiKey: process.env.SQUISH_LLM_API_KEY || process.env.OPENAI_API_KEY || '',
+  llmProvider,
+  llmExtractionModel: getString('llm.models.extraction', 'SQUISH_LLM_EXTRACTION_MODEL', ''),
+  llmReasoningModel: getString('llm.models.reasoning', 'SQUISH_LLM_REASONING_MODEL', ''),
+  llmEndpoint,
+  llm: { enabled: llmEnabled, provider: llmProvider, endpoint: llmEndpoint },
+
+  graphAutoBuild,
+  graphExtractionMethod,
+  graphMaxContentLength,
+  graph: { autoBuild: graphAutoBuild, extractionMethod: graphExtractionMethod, maxContentLength: graphMaxContentLength },
+};
+
+export default config;

package/core/adapters/config/claude-code.ts

@@ -0,0 +1,133 @@
+/**
+ * Claude Code Adapter Configuration
+ * 
+ * Native Claude Code configuration for integrating Squish as MCP server.
+ * Usage: Add to ~/.claude.json or project .claude.json
+ */
+
+import { AgentAdapter, AgentType, AgentConfig } from '../types.js';
+
+const ADAPTER_CONFIG: AgentConfig = {
+  agentId: 'claude-code',
+  name: 'Claude Code',
+  type: 'claude-code',
+  mcp: {
+    command: 'node',
+    args: ['dist/core/commands/mcp-server.js'],
+    env: { NODE_ENV: 'production' }
+  },
+  hooks: {
+    // Claude Code hooks configuration - stored as JSON string in settings
+  } as any,
+  settings: {
+    // Squish integration settings
+    squish: {
+      autoCapture: true,
+      captureTools: ['Read', 'Write', 'Edit', 'Bash'],
+      contextLimit: 5,
+    }
+  }
+};
+
+/**
+ * Register Claude Code adapter
+ */
+export function registerClaudeCodeAdapter(): void {
+  const { registerAdapter } = require('../index.js');
+  
+  const adapter: AgentAdapter = {
+    id: 'claude-code',
+    type: 'claude-code',
+    name: 'Claude Code',
+    version: 'latest',
+    
+    getSessionContext: async (input) => {
+      const { getRecent, search } = await import('../../memory/memories.js');
+      
+      const recent = await getRecent(input.project, input.mode === 'compact' ? 3 : 5);
+      const memories = recent.map((m, i) => 
+        `${i + 1}. [${m.type}] ${m.content?.substring(0, 100)}`
+      ).join('\n');
+      
+      return {
+        mode: input.mode,
+        project: input.project,
+        memories,
+        count: recent.length,
+      };
+    },
+    
+    recordObservation: async (input) => {
+      const { createLearning } = await import('../../ingestion/learnings.js');
+      
+      // Extract simple string target, not object
+      const targetVal = input.toolInput?.filePath || input.toolInput?.command;
+      const targetStr = typeof targetVal === 'string' ? targetVal : 
+                        typeof targetVal === 'object' ? JSON.stringify(targetVal).substring(0, 50) :
+                        'unknown';
+      
+      const memory = await createLearning({
+        type: 'insight',  // Tool usage is an insight
+        content: `[${input.toolName}] ${JSON.stringify(input.toolInput).substring(0, 200)}`,
+        action: input.toolName,
+        target: targetStr,
+        project: input.project,
+        autoLink: false,
+      });
+      
+      return {
+        memoryId: memory.id,
+        category: 'other',
+        content: `Recorded: ${input.toolName}`,
+      };
+    },
+    
+    getTimeline: async (query, depth, limit) => {
+      const { getTimeline } = await require('../timeline.js');
+      return getTimeline(query, depth, limit);
+    },
+    
+    shouldCaptureTool: (toolName) => {
+      const captureTools = ['Read', 'Write', 'Edit', 'Bash', 'grep', 'Glob', 'Task'];
+      return captureTools.includes(toolName);
+    },
+    
+    getNativeConfig: () => ADAPTER_CONFIG,
+  };
+  
+  registerAdapter(adapter);
+  console.error('[Adapters] Registered Claude Code adapter');
+}
+
+/** Native config for .claude.json */
+export const CLAUDE_CODE_CONFIG = {
+  mcpServers: {
+    squish: {
+      command: 'node',
+      args: ['dist/core/commands/mcp-server.js'],
+      env: { NODE_ENV: 'production' }
+    }
+  },
+  hooks: {
+    // Hooks can be configured in settings.json
+  }
+};
+
+/** Claude Code settings.json snippet */
+export const CLAUDE_CODE_SETTINGS = {
+  "mcpServers": {
+    "squish": {
+      "command": "node",
+      "args": ["dist/core/commands/mcp-server.js"],
+      "env": { "NODE_ENV": "production" }
+    }
+  },
+  "experimental": {
+    "squish": {
+      "autoCapture": true,
+      "contextLimit": 5
+    }
+  }
+};
+
+export default ADAPTER_CONFIG;

package/core/adapters/config/cursor.ts

@@ -0,0 +1,90 @@
+/**
+ * Cursor Adapter Configuration
+ * 
+ * Native Cursor configuration for integrating Squish as MCP server.
+ * Cursor uses .cursor/mcp.json or cursor.config.yaml format.
+ */
+
+import { AgentAdapter, AgentType, AgentConfig } from '../types.js';
+
+const ADAPTER_CONFIG: AgentConfig = {
+  agentId: 'cursor',
+  name: 'Cursor',
+  type: 'cursor',
+  mcp: {
+    command: 'node',
+    args: ['dist/core/commands/mcp-server.js'],
+    env: { NODE_ENV: 'production' }
+  },
+  hooks: {},
+  settings: {
+    squish: {
+      autoCapture: true,
+      captureTools: ['Read', 'Write', 'Edit', 'Bash'],
+      contextLimit: 5,
+    }
+  }
+};
+
+/**
+ * Register Cursor adapter
+ */
+export function registerCursorAdapter(): void {
+  const { registerAdapter } = require('../index.js');
+  
+  const adapter: AgentAdapter = {
+    id: 'cursor',
+    type: 'cursor',
+    name: 'Cursor',
+    version: 'latest',
+    
+    getSessionContext: async (input) => {
+      const { getRecent } = await import('../../memory/memories.js');
+      const recent = await getRecent(input.project, 5);
+      const memories = recent.map((m, i) => 
+        `${i + 1}. [${m.type}] ${m.content?.substring(0, 100)}`
+      ).join('\n');
+      
+      return { mode: input.mode, project: input.project, memories, count: recent.length };
+    },
+    
+    recordObservation: async (input) => {
+      const { createLearning } = await import('../../ingestion/learnings.js');
+      const memory = await createLearning({
+        type: 'insight',
+        content: `[${input.toolName}] ${JSON.stringify(input.toolInput).substring(0, 200)}`,
+        action: input.toolName,
+        project: input.project,
+        autoLink: false,
+      });
+      
+      return { memoryId: memory.id, category: 'other', content: `Recorded: ${input.toolName}` };
+    },
+    
+    getTimeline: async (query, depth, limit) => {
+      const { getTimeline } = await require('../timeline.js');
+      return getTimeline(query, depth, limit);
+    },
+    
+    shouldCaptureTool: (toolName) => {
+      return ['Read', 'Write', 'Edit', 'Bash', 'grep', 'Glob', 'Task'].includes(toolName);
+    },
+    
+    getNativeConfig: () => ADAPTER_CONFIG,
+  };
+  
+  registerAdapter(adapter);
+}
+
+/** Cursor mcp.json format */
+export const CURSOR_MCP_CONFIG = {
+  "mcpServers": {
+    "squish": {
+      "command": "node",
+      "args": ["dist/core/commands/mcp-server.js"],
+      "env": { "NODE_ENV": "production" }
+    }
+  }
+};
+
+export default ADAPTER_CONFIG;