ei-tui 0.3.8 → 0.4.0

package/README.md

@@ -1,12 +1,12 @@
 # Ei
 
-A local-first AI companion system with persistent personas and Opencode Integration.
+A local-first AI companion system with persistent personas and coding tool integrations (OpenCode, Claude Code, Cursor).
 
 You can access the Web version at [ei.flare576.com](https://ei.flare576.com).
 
 You can install the local version via `npm install -g ei-tui` (see [### TUI](#tui) for details).
 
-If you're here to give Opencode perpetual memory (yes), jump over to [TUI README.md](./tui/README.md) to learn how to get information _into_ Ei, and [CLI README.md](./src/cli/README.md) to get it back _out_.
+If you're here to give your coding tools (OpenCode, Claude Code, Cursor) persistent memory, jump over to [TUI README.md](./tui/README.md) to learn how to get information _into_ Ei, and [CLI README.md](./src/cli/README.md) to get it back _out_.
 
 ## What Does "Local First" Mean?
 
@@ -108,13 +108,49 @@ Regardless, Running `ei` pops open the TUI interface and, just like on the web,
 
 More information (including commands) can be found in the [TUI Readme](tui/README.md)
 
-### Opencode
+### Coding Tool Integrations
 
-Ei gives OpenCode a persistent memory. Yes, this is a dynamic, perpetual RAG — I didn't plan it that way, but here we are.
+Ei can import sessions from your coding tools and extract what you've been working on — pulling out facts, topics, and context that persist across sessions. Enable any combination; they work independently and feed into the same knowledge base.
 
-Opencode saves all of its sessions locally, either in a JSON structure or, if you're running the latest version, in a SQLite DB. If you enable the integration, Ei will pull all of the conversational parts of those sessions and summarize them, pulling out details, quotes, and keeping the summaries up-to-date.
+All three integrations are enabled via `/settings` in the TUI.
 
-Then, Opencode can call into Ei and pull those details back out. That's why you always have a side-project or two going. See [TUI Readme](tui/README.md)
+#### OpenCode
+
+```yaml
+opencode:
+  integration: true
+```
+
+OpenCode saves sessions as JSON or SQLite (depending on version). Ei reads them, extracts context per-agent (each agent like Sisyphus gets its own persona), and keeps everything current as sessions accumulate.
+
+OpenCode can also *read* Ei's knowledge back out via the [CLI tool](src/cli/README.md) — making it a dynamic, perpetual RAG. That's why it always has context from your other projects.
+
+#### Claude Code
+
+```yaml
+claudeCode:
+  integration: true
+```
+
+Reads from `~/.claude/projects/` (JSONL session files). All sessions map to a single "Claude Code" persona. Tool calls, thinking blocks, and internal plumbing are stripped — only the conversational content is imported.
+
+#### Cursor
+
+```yaml
+cursor:
+  integration: true
+```
+
+Reads from Cursor's SQLite databases:
+- **macOS**: `~/Library/Application Support/Cursor/User/`
+- **Windows**: `%APPDATA%\Cursor\User\`
+- **Linux**: `~/.config/Cursor/User/`
+
+All sessions map to a single "Cursor" persona.
+
+---
+
+Sessions are processed oldest-first, one per queue cycle, so Ei won't overwhelm your LLM provider on first run. See [TUI Readme](tui/README.md)
 
 ## Built-in Tool Integrations
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ei-tui",
-  "version": "0.3.8",
+  "version": "0.4.0",
   "author": "Flare576",
   "repository": {
     "type": "git",

package/src/core/heartbeat-manager.ts

@@ -16,8 +16,6 @@ import {
 import { filterMessagesForContext } from "./context-utils.js";
 import { filterHumanDataByVisibility } from "./prompt-context-builder.js";
 
-const DEFAULT_CONTEXT_WINDOW_HOURS = 8;
-
 // =============================================================================
 // MODEL HELPERS
 // =============================================================================
@@ -189,9 +187,9 @@ export async function queueHeartbeatCheck(sm: StateManager, personaId: string, i
   const model = getModelForPersona(sm, personaId);
   console.log(`[HeartbeatCheck ${persona.display_name}] Queueing heartbeat check (model: ${model})`);
   const human = sm.getHuman();
-  const history = sm.messages_get(personaId);
-  const contextWindowHours = persona.context_window_hours ?? DEFAULT_CONTEXT_WINDOW_HOURS;
-  const contextHistory = filterMessagesForContext(history, persona.context_boundary, contextWindowHours);
+   const history = sm.messages_get(personaId);
+   const contextWindowHours = persona.context_window_hours ?? human.settings?.default_context_window_hours ?? 8;
+   const contextHistory = filterMessagesForContext(history, persona.context_boundary, contextWindowHours);
 
   if (personaId === "ei") {
     await queueEiHeartbeat(sm, human, contextHistory, isTUI);

package/src/core/message-manager.ts

@@ -24,8 +24,6 @@ import {
 import { buildChatMessageContent } from "../prompts/message-utils.js";
 import { filterMessagesForContext } from "./context-utils.js";
 
-const DEFAULT_CONTEXT_WINDOW_HOURS = 8;
-
 // =============================================================================
 // MESSAGE QUERIES
 // =============================================================================
@@ -270,15 +268,16 @@ export function checkAndQueueHumanExtraction(
 // =============================================================================
 
 export function fetchMessagesForLLM(
-  sm: StateManager,
-  personaId: string
-): import("./types.js").ChatMessage[] {
-  const persona = sm.persona_getById(personaId);
-  if (!persona) return [];
-
-  const history = sm.messages_get(personaId);
-  const contextWindowHours = persona.context_window_hours ?? DEFAULT_CONTEXT_WINDOW_HOURS;
-  const filteredHistory = filterMessagesForContext(history, persona.context_boundary, contextWindowHours);
+   sm: StateManager,
+   personaId: string
+ ): import("./types.js").ChatMessage[] {
+   const persona = sm.persona_getById(personaId);
+   if (!persona) return [];
+ 
+   const human = sm.getHuman();
+   const history = sm.messages_get(personaId);
+   const contextWindowHours = persona.context_window_hours ?? human.settings?.default_context_window_hours ?? 8;
+   const filteredHistory = filterMessagesForContext(history, persona.context_boundary, contextWindowHours);
 
   return filteredHistory.reduce<import("./types.js").ChatMessage[]>((acc, m) => {
     const content = buildChatMessageContent(m);

package/src/core/orchestrators/ceremony.ts

@@ -1,4 +1,4 @@
-import { LLMRequestType, LLMPriority, LLMNextStep, MESSAGE_MIN_COUNT, MESSAGE_MAX_AGE_DAYS, type CeremonyConfig, type PersonaTopic, type Topic, type Message, type DataItemBase } from "../types.js";
+import { LLMRequestType, LLMPriority, LLMNextStep, type CeremonyConfig, type PersonaTopic, type Topic, type Message, type DataItemBase } from "../types.js";
 import type { StateManager } from "../state-manager.js";
 import { applyDecayToValue } from "../utils/index.js";
 import {
@@ -309,14 +309,17 @@ export function prunePersonaMessages(personaId: string, state: StateManager): vo
   // Sort first — injected messages (session update, archive scan) may be out of order.
   state.messages_sort(personaId);
   const messages = state.messages_get(personaId);
-  if (messages.length <= MESSAGE_MIN_COUNT) return;
+  const human = state.getHuman();
+  const minCount = human.settings?.message_min_count ?? 200;
+  const maxAgeDays = human.settings?.message_max_age_days ?? 14;
+  if (messages.length <= minCount) return;
   
-  const cutoffMs = Date.now() - (MESSAGE_MAX_AGE_DAYS * 24 * 60 * 60 * 1000);
+  const cutoffMs = Date.now() - (maxAgeDays * 24 * 60 * 60 * 1000);
   
   // Messages are sorted by timestamp (oldest first from messages_sort)
   const toRemove: string[] = [];
   for (const m of messages) {
-    if (messages.length - toRemove.length <= MESSAGE_MIN_COUNT) break;
+    if (messages.length - toRemove.length <= minCount) break;
     
     const msgMs = new Date(m.timestamp).getTime();
     if (msgMs >= cutoffMs) break; // Sorted by time, no more old ones

package/src/core/orchestrators/dedup-phase.ts

@@ -2,6 +2,7 @@ import { StateManager } from "../state-manager.js";
 import { LLMRequestType, LLMPriority, LLMNextStep, type DataItemBase } from "../types.js";
 import type { DataItemType } from "../types/data-items.js";
 import { buildDedupPrompt } from "../../prompts/ceremony/dedup.js";
+import { buildUserDedupPrompt } from "../../prompts/ceremony/user-dedup.js";
 
 // =============================================================================
 // TYPES
@@ -201,3 +202,48 @@ export function queueDedupPhase(state: StateManager): void {
   
   console.log(`[Dedup] Queued ${totalClusters} clusters for curation`);
 }
+
+// =============================================================================
+// USER-TRIGGERED DEDUP
+// =============================================================================
+
+export function queueUserDedupRequest(
+  state: StateManager,
+  itemType: "topic" | "person",
+  entityIds: string[]
+): void {
+  const human = state.getHuman();
+
+  const collection = (itemType === "topic" ? human.topics : human.people) as DedupableItem[];
+  const entities = entityIds
+    .map(id => collection.find(item => item.id === id))
+    .filter((item): item is DedupableItem => item !== undefined);
+
+  if (entities.length < 2) {
+    console.warn("[UserDedup] Need at least 2 entities to merge");
+    return;
+  }
+
+  const prompt = buildUserDedupPrompt({
+    cluster: entities,
+    itemType,
+    similarityRange: { min: 1.0, max: 1.0 },
+  });
+
+  const model = human.settings?.rewrite_model ?? undefined;
+
+  state.queue_enqueue({
+    type: LLMRequestType.JSON,
+    priority: LLMPriority.High,
+    system: prompt.system,
+    user: prompt.user,
+    next_step: LLMNextStep.HandleDedupCurate,
+    ...(model ? { model } : {}),
+    data: {
+      entity_type: itemType,
+      entity_ids: entityIds,
+    },
+  });
+
+  console.log(`[UserDedup] Queued merge of ${entities.length} ${itemType} entities`);
+}

package/src/core/orchestrators/index.ts

@@ -22,7 +22,7 @@ export {
   queueDescriptionCheck,
   runHumanCeremony,
   } from "./ceremony.js";
-export { queueDedupPhase } from "./dedup-phase.js";
+export { queueDedupPhase, queueUserDedupRequest } from "./dedup-phase.js";
 export {
   queuePersonaTopicScan,
   queuePersonaTopicMatch,

package/src/core/personas/opencode-agent.ts

@@ -19,7 +19,14 @@ function resolveCanonicalAgent(agentName: string): { canonical: string; aliases:
       return { canonical, aliases: variants };
     }
   }
-  return { canonical: agentName, aliases: [agentName] };
+
+  let name = agentName;
+  name = name.replace(/^ai-sdlc[:-]/, "");
+  name = name.replace(/\s*\([^)]+\)\s*$/, "").trim();
+  name = name.replace(/-/g, " ");
+  const canonical = name.replace(/\b\w/g, (c) => c.toUpperCase());
+
+  return { canonical, aliases: [agentName] };
 }
 
 export async function ensureAgentPersona(

package/src/core/processor.ts

@@ -31,7 +31,7 @@ import { ContextStatus as ContextStatusEnum } from "./types.js";
 import { registerReadMemoryExecutor, registerFileReadExecutor } from "./tools/index.js";
 import { createReadMemoryExecutor } from "./tools/builtin/read-memory.js";
 import { EI_WELCOME_MESSAGE, EI_PERSONA_DEFINITION } from "../templates/welcome.js";
-import { shouldStartCeremony, startCeremony, handleCeremonyProgress } from "./orchestrators/index.js";
+import { shouldStartCeremony, startCeremony, handleCeremonyProgress, queueUserDedupRequest } from "./orchestrators/index.js";
 import { BUILT_IN_FACTS } from "./constants/built-in-facts.js";
 
 // Static module imports
@@ -105,7 +105,6 @@ import {
 } from "./queue-manager.js";
 
 const DEFAULT_LOOP_INTERVAL_MS = 100;
-const DEFAULT_CONTEXT_WINDOW_HOURS = 8;
 const DEFAULT_OPENCODE_POLLING_MS = 1800000;
 const DEFAULT_CLAUDE_CODE_POLLING_MS = 1800000;
 const DEFAULT_CURSOR_POLLING_MS = 1800000;
@@ -679,6 +678,26 @@ export class Processor {
       modified = true;
     }
 
+    if (human.settings.default_heartbeat_ms == null) {
+      human.settings.default_heartbeat_ms = 1800000;
+      modified = true;
+    }
+
+    if (human.settings.default_context_window_hours == null) {
+      human.settings.default_context_window_hours = 8;
+      modified = true;
+    }
+
+    if (human.settings.message_min_count == null) {
+      human.settings.message_min_count = 200;
+      modified = true;
+    }
+
+    if (human.settings.message_max_age_days == null) {
+      human.settings.message_max_age_days = 14;
+      modified = true;
+    }
+
     if (modified) {
       this.stateManager.setHuman(human);
       console.log(`[Processor] Seeded missing settings`);
@@ -881,7 +900,6 @@ const toolNextSteps = new Set([
 
   private async checkScheduledTasks(): Promise<void> {
     const now = Date.now();
-    const DEFAULT_HEARTBEAT_DELAY_MS = 1800000;
 
     const human = this.stateManager.getHuman();
 
@@ -926,7 +944,8 @@ const toolNextSteps = new Set([
     for (const persona of this.stateManager.persona_getAll()) {
       if (persona.is_paused || persona.is_archived) continue;
 
-      const heartbeatDelay = persona.heartbeat_delay_ms ?? DEFAULT_HEARTBEAT_DELAY_MS;
+      const defaultHeartbeatMs = this.stateManager.getHuman().settings?.default_heartbeat_ms ?? 1800000;
+      const heartbeatDelay = persona.heartbeat_delay_ms ?? defaultHeartbeatMs;
       const lastActivity = persona.last_activity
         ? new Date(persona.last_activity).getTime()
         : 0;
@@ -939,9 +958,11 @@ const toolNextSteps = new Set([
         const timeSinceHeartbeat = now - lastHeartbeat;
 
         if (timeSinceHeartbeat >= heartbeatDelay) {
-          const history = this.stateManager.messages_get(persona.id);
-          const contextWindowHours =
-            persona.context_window_hours ?? DEFAULT_CONTEXT_WINDOW_HOURS;
+           const history = this.stateManager.messages_get(persona.id);
+           const contextWindowHours =
+             persona.context_window_hours 
+             ?? this.stateManager.getHuman().settings?.default_context_window_hours 
+             ?? 8;
           const contextHistory = filterMessagesForContext(
             history,
             persona.context_boundary,
@@ -1557,6 +1578,10 @@ const toolNextSteps = new Set([
     return clearQueue(this.stateManager, this.queueProcessor);
   }
 
+  queueUserDedup(itemType: "topic" | "person", entityIds: string[]): void {
+    queueUserDedupRequest(this.stateManager, itemType, entityIds);
+  }
+
   async submitOneShot(guid: string, systemPrompt: string, userPrompt: string): Promise<void> {
     return submitOneShot(
       this.stateManager,

package/src/core/types/entities.ts

@@ -80,6 +80,10 @@ export interface HumanSettings {
   skip_quote_delete_confirm?: boolean;
   name_display?: string;
   time_mode?: "24h" | "12h" | "local" | "utc";
+  default_heartbeat_ms?: number;
+  default_context_window_hours?: number;
+  message_min_count?: number;
+  message_max_age_days?: number;
   accounts?: ProviderAccount[];
   sync?: SyncCredentials;
   opencode?: OpenCodeSettings;
@@ -147,10 +151,6 @@ export interface PersonaCreationInput {
 // Steps - "57:3"."inputs"."steps"
 // Cfg - "57:3"."inputs"."cfg"
 export const COMFY_PROMPT_TEMPLATE = {"9":{"inputs":{"filename_prefix":"z-image-turbo","images":["57:8",0]},"class_type":"SaveImage","_meta":{"title":"Save Image"}},"57:30":{"inputs":{"clip_name":"qwen_3_4b.safetensors","type":"lumina2","device":"default"},"class_type":"CLIPLoader","_meta":{"title":"Load CLIP"}},"57:29":{"inputs":{"vae_name":"ae.safetensors"},"class_type":"VAELoader","_meta":{"title":"Load VAE"}},"57:33":{"inputs":{"conditioning":["57:27",0]},"class_type":"ConditioningZeroOut","_meta":{"title":"ConditioningZeroOut"}},"57:8":{"inputs":{"samples":["57:3",0],"vae":["57:29",0]},"class_type":"VAEDecode","_meta":{"title":"VAE Decode"}},"57:28":{"inputs":{"unet_name":"z_image_turbo_bf16.safetensors","weight_dtype":"default"},"class_type":"UNETLoader","_meta":{"title":"Load Diffusion Model"}},"57:27":{"inputs":{"text":"This is a test prompt","clip":["57:30",0]},"class_type":"CLIPTextEncode","_meta":{"title":"CLIP Text Encode (Prompt)"}},"57:13":{"inputs":{"width":768,"height":768,"batch_size":1},"class_type":"EmptySD3LatentImage","_meta":{"title":"EmptySD3LatentImage"}},"57:11":{"inputs":{"shift":3,"model":["57:28",0]},"class_type":"ModelSamplingAuraFlow","_meta":{"title":"ModelSamplingAuraFlow"}},"57:3":{"inputs":{"seed":407776369182481,"steps":8,"cfg":1,"sampler_name":"res_multistep","scheduler":"simple","denoise":1,"model":["57:11",0],"positive":["57:27",0],"negative":["57:33",0],"latent_image":["57:13",0]},"class_type":"KSampler","_meta":{"title":"KSampler"}}};
-// Message pruning thresholds (shared by ceremony and import)
-export const MESSAGE_MIN_COUNT = 200;
-export const MESSAGE_MAX_AGE_DAYS = 14;
-
 // DLQ rolloff thresholds
 export const DLQ_MAX_COUNT = 50;
 export const DLQ_MAX_AGE_DAYS = 14;

package/src/integrations/claude-code/importer.ts

@@ -11,6 +11,7 @@ import {
   queueAllScans,
   type ExtractionContext,
 } from "../../core/orchestrators/human-extraction.js";
+import { isProcessRunning } from "../process-check.js";
 
 // =============================================================================
 // Export Types
@@ -219,6 +220,7 @@ export async function importClaudeCodeSessions(
   const settings = human.settings?.claudeCode;
   const processedSessions = settings?.processed_sessions ?? {};
   const now = Date.now();
+  const toolRunning = await isProcessRunning("claude");
 
   let targetSession: ClaudeCodeSession | null = null;
 
@@ -228,7 +230,7 @@ export async function importClaudeCodeSessions(
     const sessionLastMs = new Date(session.lastMessageAt).getTime();
     const ageMs = now - sessionLastMs;
 
-    if (ageMs < MIN_SESSION_AGE_MS) continue; // too fresh
+    if (ageMs < MIN_SESSION_AGE_MS && toolRunning) continue;
 
     if (!lastImported) {
       targetSession = session;

package/src/integrations/cursor/importer.ts

@@ -7,6 +7,7 @@ import {
   MIN_SESSION_AGE_MS,
 } from "./types.js";
 import { CursorReader } from "./reader.js";
+import { isProcessRunning } from "../process-check.js";
 import {
   queueAllScans,
   type ExtractionContext,
@@ -184,6 +185,7 @@ export async function importCursorSessions(
   const human = stateManager.getHuman();
   const processedSessions = human.settings?.cursor?.processed_sessions ?? {};
   const now = Date.now();
+  const toolRunning = await isProcessRunning("Cursor");
 
   let targetSession: CursorSession | null = null;
 
@@ -191,7 +193,7 @@ export async function importCursorSessions(
     const sessionLastMs = new Date(session.lastMessageAt).getTime();
     const ageMs = now - sessionLastMs;
 
-    if (ageMs < MIN_SESSION_AGE_MS) continue;
+    if (ageMs < MIN_SESSION_AGE_MS && toolRunning) continue;
 
     const lastImported = processedSessions[session.id];
     if (lastImported && sessionLastMs <= new Date(lastImported).getTime()) continue;

package/src/integrations/opencode/importer.ts

@@ -8,6 +8,7 @@ import {
   queueAllScans,
   type ExtractionContext,
 } from "../../core/orchestrators/human-extraction.js";
+import { isProcessRunning } from "../process-check.js";
 
 // =============================================================================
 // Constants
@@ -125,19 +126,20 @@ export async function importOpenCodeSessions(
   let targetSession: OpenCodeSession | null = null;
   const MIN_SESSION_AGE_MS = 20 * 60 * 1000; // 20 minutes
   const now = Date.now();
+  const toolRunning = await isProcessRunning("opencode");
 
   for (const session of sortedSessions) {
     const lastImported = processedSessions[session.id];
     if (!lastImported) {
       const ageMs = now - session.time.updated;
-      if (ageMs >= MIN_SESSION_AGE_MS) {
+      if (ageMs >= MIN_SESSION_AGE_MS || !toolRunning) {
         targetSession = session;
         break;
       }
     }
     if (session.time.updated > new Date(lastImported).getTime()) {
       const ageMs = now - session.time.updated;
-      if (ageMs >= MIN_SESSION_AGE_MS) {
+      if (ageMs >= MIN_SESSION_AGE_MS || !toolRunning) {
         targetSession = session;
         break;
       }

package/src/integrations/opencode/types.ts

@@ -175,6 +175,7 @@ export const AGENT_TO_AGENT_PREFIXES = [
  * Value = array of variants that should resolve to this persona
  */
 export const AGENT_ALIASES: Record<string, string[]> = {
+  // ── OhMyOpenCode primary agents ──────────────────────────────────────────
   Sisyphus: [
     "sisyphus",
     "Sisyphus",
@@ -182,6 +183,44 @@ export const AGENT_ALIASES: Record<string, string[]> = {
     "Planner-Sisyphus",
     "planner-sisyphus",
   ],
+  Build: ["build", "Build"],
+  Plan: ["plan", "Plan"],
+  Atlas: [
+    "atlas",
+    "Atlas",
+    "atlas (plan executor)",
+    "Atlas (plan executor)",
+  ],
+  Prometheus: [
+    "prometheus",
+    "Prometheus",
+    "prometheus (plan builder)",
+    "Prometheus (plan builder)",
+  ],
+  Hephaestus: [
+    "hephaestus",
+    "Hephaestus",
+    "hephaestus (deep agent)",
+    "Hephaestus (deep agent)",
+  ],
+
+  // ── ai-sdlc agents (RobotsAndPencils/ai-sdlc-claude-code-template) ───────
+  // Installed via scripts/install-opencode.sh as "ai-sdlc-{name}" in OpenCode.
+  // Bare names included for direct/custom installs.
+  Architect: ["ai-sdlc-architect", "architect"],
+  "Frontend Engineer": ["ai-sdlc-frontend-engineer", "frontend-engineer"],
+  "Backend Engineer": ["ai-sdlc-backend-engineer", "backend-engineer"],
+  "Code Reviewer": ["ai-sdlc-code-reviewer", "code-reviewer"],
+  "Database Engineer": ["ai-sdlc-database-engineer", "database-engineer"],
+  Debugger: ["ai-sdlc-debugger", "debugger"],
+  "DevOps Engineer": ["ai-sdlc-devops-engineer", "devops-engineer"],
+  "Mobile Engineer": ["ai-sdlc-mobile-engineer", "mobile-engineer"],
+  "QA Engineer": ["ai-sdlc-qa-engineer", "qa-engineer"],
+  "Security Reviewer": ["ai-sdlc-security-reviewer", "security-reviewer"],
+  "Spec Validator": ["ai-sdlc-spec-validator", "spec-validator"],
+  "Technical Writer": ["ai-sdlc-technical-writer", "technical-writer"],
+  "Test Writer": ["ai-sdlc-test-writer", "test-writer"],
+  "AI Engineer": ["ai-sdlc-ai-engineer", "ai-engineer"],
 };
 
 /**

package/src/integrations/process-check.ts

@@ -0,0 +1,24 @@
+const isBrowser = typeof document !== "undefined";
+
+/**
+ * Returns true if any process with the given name is currently running.
+ * Always returns true in browser environments (process inspection not available).
+ * On Windows uses `tasklist`; on macOS/Linux uses `pgrep -x`.
+ */
+export async function isProcessRunning(processName: string): Promise<boolean> {
+  if (isBrowser) return true;
+  try {
+    const CHILD_PROCESS = "child_process";
+    const { execSync } = await import(/* @vite-ignore */ CHILD_PROCESS);
+    if (process.platform === "win32") {
+      const out = execSync(
+        `tasklist /FI "IMAGENAME eq ${processName}.exe" /NH 2>NUL`
+      ).toString();
+      return out.toLowerCase().includes(`${processName.toLowerCase()}.exe`);
+    }
+    execSync(`pgrep -x ${processName}`, { stdio: "ignore" });
+    return true;
+  } catch {
+    return false;
+  }
+}

package/src/prompts/ceremony/index.ts

@@ -3,6 +3,7 @@ export { buildPersonaExplorePrompt } from "./explore.js";
 export { buildDescriptionCheckPrompt } from "./description-check.js";
 export { buildRewriteScanPrompt, buildRewritePrompt } from "./rewrite.js";
 export { buildDedupPrompt } from "./dedup.js";
+export { buildUserDedupPrompt } from "./user-dedup.js";
 export type {
   PersonaExpirePromptData,
   PersonaExpireResult,

package/src/prompts/ceremony/user-dedup.ts

@@ -0,0 +1,74 @@
+import type { DedupPromptData } from "./types.js";
+
+// =============================================================================
+// USER-TRIGGERED DEDUP — Direct merge, no candidate-finding, no hedging
+// =============================================================================
+
+/**
+ * Prompt for user-confirmed deduplication.
+ *
+ * Unlike buildDedupPrompt (ceremony), this skips all decision-making — the user
+ * has already confirmed these entities are duplicates. Opus just merges.
+ * No hedging, no "our system BELIEVES these MAY be duplicates" language.
+ */
+export function buildUserDedupPrompt(data: DedupPromptData): { system: string; user: string } {
+  const typeLabel = data.itemType.charAt(0).toUpperCase() + data.itemType.slice(1);
+
+  const system = `You are merging duplicate ${typeLabel} records in a user's personal knowledge base. The user has manually confirmed that all records in this cluster refer to the same entity.
+
+**YOUR PRIME DIRECTIVE: LOSE NO DATA.**
+
+Your job is synthesis, not decision-making. Do not question whether these are duplicates — they are. Simply collapse them into one comprehensive, non-repetitive record.
+
+### Merge Rules:
+- Pick the most descriptive, commonly-used name as the canonical name
+- Union all unique details from every description — if it was in any record, it belongs in the merged record
+- Descriptions should be concise (under 300 chars) but complete — no detail left behind
+- Numeric fields: strength/confidence → take HIGHER; sentiment → AVERAGE; exposure → take HIGHER
+- relationship/category → pick most specific/accurate
+
+### Output Format:
+{
+  "update": [
+    /* The single merged canonical record with ALL fields preserved */
+    /* MUST include "id" (use the oldest/most-referenced record's ID), "type", "name", "description" */
+  ],
+  "remove": [
+    {"to_be_removed": "uuid-of-duplicate", "replaced_by": "uuid-of-canonical-record"},
+    /* One entry per record being absorbed */
+  ],
+  "add": []
+}
+
+Return raw JSON only. No markdown, no commentary.
+
+${buildRecordFormatHint(data.itemType)}`;
+
+  const user = JSON.stringify({
+    cluster: data.cluster.map(stripEmbedding),
+    cluster_type: data.itemType,
+    user_confirmed: true,
+  }, null, 2);
+
+  return { system, user };
+}
+
+// =============================================================================
+// Helpers
+// =============================================================================
+
+function stripEmbedding<T extends { embedding?: unknown }>(item: T): Omit<T, "embedding"> {
+  const { embedding: _, ...rest } = item;
+  return rest as Omit<T, "embedding">;
+}
+
+function buildRecordFormatHint(itemType: string): string {
+  switch (itemType) {
+    case "person":
+      return `Person fields: id, type, name, description, sentiment (-1 to 1), relationship, exposure_current (0-1), exposure_desired (0-1), learned_by (optional), last_changed_by (optional)`;
+    case "topic":
+      return `Topic fields: id, type, name, description, sentiment (-1 to 1), category, exposure_current (0-1), exposure_desired (0-1), learned_by (optional), last_changed_by (optional)`;
+    default:
+      return "";
+  }
+}

package/tui/README.md

@@ -2,7 +2,21 @@
 
 Ei TUI is built with OpenTUI and SolidJS.
 
-OpenCode integration: import via `/settings` (`opencode.integration: true`) · export via [CLI](../src/cli/README.md)
+Coding tool integrations (OpenCode, Claude Code, Cursor): enable via `/settings` · export data via [CLI](../src/cli/README.md)
+
+## Coding Tool Integrations
+
+Enable any or all three in `/settings`. They work independently and feed into the same knowledge base.
+
+| Tool | Settings key | Session data location |
+|------|-------------|----------------------|
+| OpenCode | `opencode.integration: true` | OpenCode's local SQLite / JSON session store |
+| Claude Code | `claudeCode.integration: true` | `~/.claude/projects/` (JSONL files) |
+| Cursor | `cursor.integration: true` | `~/Library/Application Support/Cursor/User/` (macOS)<br>`%APPDATA%\Cursor\User\` (Windows)<br>`~/.config/Cursor/User/` (Linux) |
+
+Sessions are processed oldest-first, one per queue cycle. On first run Ei works through your backlog gradually — it won't flood your LLM provider.
+
+OpenCode also supports reading Ei's extracted knowledge back out via the [CLI tool](../src/cli/README.md), giving it persistent memory across sessions.
 
 # Installation
 
@@ -73,6 +87,7 @@ All commands start with `/`. Append `!` to any command as a shorthand for `--for
 |---------|---------|-------------|
 | `/me` | | Edit all your data (facts, traits, topics, people) in `$EDITOR` |
 | `/me <type>` | | Edit one type: `facts`, `traits`, `topics`, or `people` |
+| `/dedupe <person\|topic> "<query>"` | | Fuzzy-search and merge duplicate people or topics in `$EDITOR` |
 | `/settings` | `/set` | Edit your global settings in `$EDITOR` |
 | `/setsync <user> <pass>` | `/ss` | Set sync credentials (triggers restart) |
 | `/tools` | | Manage tool providers — enable/disable tools per persona |

package/tui/src/commands/dedupe.tsx

@@ -0,0 +1,132 @@
+import type { Command } from "./registry.js";
+import { spawnEditor } from "../util/editor.js";
+import type { Topic, Person } from "../../../src/core/types.js";
+
+const VALID_TYPES = ["person", "topic"] as const;
+type DedupeType = typeof VALID_TYPES[number];
+
+function buildDedupeYAML(type: DedupeType, query: string, entities: Array<Topic | Person>): string {
+  const header = [
+    `# /dedupe ${type} "${query}"`,
+    `# Found ${entities.length} match${entities.length === 1 ? "" : "es"}. DELETE blocks for entries to EXCLUDE from the merge.`,
+    `# Keep at least 2. Save to confirm, :q to cancel (Vim tip: :cq quits with error — same effect, but now you know it exists).`,
+    ``,
+  ].join("\n");
+
+  const blocks = entities.map(entity => {
+    const lines = [
+      `- id: "${entity.id}"`,
+      `  name: "${entity.name.replace(/"/g, '\\"')}"`,
+      `  description: "${entity.description.replace(/"/g, '\\"')}"`,
+    ];
+
+    if ("relationship" in entity && entity.relationship) {
+      lines.push(`  relationship: "${entity.relationship}"`);
+    }
+    if ("category" in entity && entity.category) {
+      lines.push(`  category: "${entity.category}"`);
+    }
+    if (entity.learned_by) {
+      lines.push(`  learned_by: "${entity.learned_by}"`);
+    }
+
+    const date = entity.last_updated ? entity.last_updated.slice(0, 10) : "";
+    if (date) lines.push(`  last_updated: "${date}"`);
+
+    return lines.join("\n");
+  });
+
+  return header + blocks.join("\n\n") + "\n";
+}
+
+function parseDedupeYAML(content: string): string[] {
+  const ids: string[] = [];
+  const pattern = /^\s*- id:\s*"([^"]+)"/gm;
+  let match: RegExpExecArray | null;
+  while ((match = pattern.exec(content)) !== null) {
+    ids.push(match[1]);
+  }
+  return ids;
+}
+
+function fuzzySearch(entities: Array<Topic | Person>, query: string): Array<Topic | Person> {
+  const lower = query.toLowerCase();
+  return entities.filter(entity =>
+    entity.name.toLowerCase().includes(lower)
+  );
+}
+
+export const dedupeCommand: Command = {
+  name: "dedupe",
+  aliases: [],
+  description: "Merge duplicate people or topics",
+  usage: '/dedupe <person|topic> "<query>"',
+
+  async execute(args, ctx) {
+    const type = args[0]?.toLowerCase() as DedupeType | undefined;
+
+    if (!type || !VALID_TYPES.includes(type)) {
+      ctx.showNotification(
+        `Usage: /dedupe <person|topic> "<query>". Got: ${args[0] ?? "(none)"}`,
+        "error"
+      );
+      return;
+    }
+
+    const query = args.slice(1).join(" ").trim();
+    if (!query) {
+      ctx.showNotification(`Usage: /dedupe ${type} "<query>" — query is required`, "error");
+      return;
+    }
+
+    const human = await ctx.ei.getHuman();
+    const pool: Array<Topic | Person> = type === "topic" ? human.topics : human.people;
+    const matches = fuzzySearch(pool, query);
+
+    if (matches.length === 0) {
+      ctx.showNotification(`No ${type}s matching "${query}"`, "info");
+      return;
+    }
+
+    if (matches.length === 1) {
+      ctx.showNotification(`Only 1 ${type} matches "${query}" — need at least 2 to merge`, "info");
+      return;
+    }
+
+    const yamlContent = buildDedupeYAML(type, query, matches);
+
+    const result = await spawnEditor({
+      initialContent: yamlContent,
+      filename: "ei-dedupe.yaml",
+      renderer: ctx.renderer,
+    });
+
+    if (result.aborted) {
+      ctx.showNotification("Dedupe cancelled", "info");
+      return;
+    }
+
+    if (!result.success) {
+      ctx.showNotification("Editor failed to open", "error");
+      return;
+    }
+
+    if (result.content === null) {
+      ctx.showNotification("No changes — dedupe cancelled", "info");
+      return;
+    }
+
+    const keptIds = parseDedupeYAML(result.content);
+
+    if (keptIds.length < 2) {
+      ctx.showNotification("Need at least 2 entries to merge — dedupe cancelled", "error");
+      return;
+    }
+
+    ctx.ei.queueUserDedup(type, keptIds);
+    ctx.showNotification(
+      `Queued merge of ${keptIds.length} ${type}s — Opus will synthesize at high priority`,
+      "info"
+    );
+  },
+};

package/tui/src/components/PromptInput.tsx

@@ -25,6 +25,7 @@ import { queueCommand } from "../commands/queue";
 import { dlqCommand } from "../commands/dlq";
 import { toolsCommand } from "../commands/tools";
 import { authCommand } from '../commands/auth';
+import { dedupeCommand } from "../commands/dedupe";
 import { useOverlay } from "../context/overlay";
 import { CommandSuggest } from "./CommandSuggest";
 import { useKeyboard } from "@opentui/solid";
@@ -64,6 +65,7 @@ export function PromptInput() {
   registerCommand(dlqCommand);
   registerCommand(toolsCommand);
   registerCommand(authCommand);
+  registerCommand(dedupeCommand);
 
   let textareaRef: TextareaRenderable | undefined;
 
@@ -163,7 +165,8 @@ export function PromptInput() {
                                  text.startsWith("/context") ||
                                  text.startsWith("/messages") ||
                                  text === "/queue" ||
-                                 text === "/dlq";
+                                 text === "/dlq" ||
+                                 text.startsWith("/dedupe");
 
       if (!isEditorCmd && !opensEditorForData) {
         textareaRef?.clear();

package/tui/src/context/ei.tsx

@@ -106,6 +106,7 @@ export interface EiContextValue {
   getToolList: () => ToolDefinition[];
   updateToolProvider: (id: string, updates: Partial<Omit<ToolProvider, 'id' | 'created_at'>>) => Promise<boolean>;
   updateTool: (id: string, updates: Partial<Omit<ToolDefinition, 'id' | 'created_at'>>) => Promise<boolean>;
+  queueUserDedup: (itemType: "topic" | "person", entityIds: string[]) => void;
   cleanupTimers: () => void;
 }
 const EiContext = createContext<EiContextValue>();
@@ -141,6 +142,11 @@ export const EiProvider: ParentComponent = (props) => {
     }, 5000);
   };
 
+  const queueUserDedup = (itemType: "topic" | "person", entityIds: string[]): void => {
+    if (!processor) return;
+    processor.queueUserDedup(itemType, entityIds);
+  };
+
   const cleanupTimers = () => {
     if (notificationTimer) {
       clearTimeout(notificationTimer);
@@ -661,6 +667,7 @@ export const EiProvider: ParentComponent = (props) => {
     getToolList,
     updateToolProvider,
     updateTool,
+    queueUserDedup,
     cleanupTimers,
   };
   return (

package/tui/src/util/yaml-serializers.ts

@@ -504,11 +504,16 @@ interface EditableSettingsData {
   rewrite_model?: string | null;
   time_mode?: "24h" | "12h" | "local" | "utc" | null;
   name_display?: string | null;
+  default_heartbeat_ms?: number | null;
+  default_context_window_hours?: number | null;
+  message_min_count?: number | null;
+  message_max_age_days?: number | null;
   ceremony?: {
     time: string;
     decay_rate?: number | null;
     explore_threshold?: number | null;
     dedup_threshold?: number | null;
+    event_window_hours?: number | null;
   };
   opencode?: {
     integration?: boolean | null;
@@ -547,11 +552,16 @@ export function settingsToYAML(settings: HumanSettings | undefined): string {
     rewrite_model: settings?.rewrite_model ?? null,
     time_mode: settings?.time_mode ?? null,
     name_display: settings?.name_display ?? null,
+    default_heartbeat_ms: settings?.default_heartbeat_ms ?? 1800000,
+    default_context_window_hours: settings?.default_context_window_hours ?? 8,
+    message_min_count: settings?.message_min_count ?? 200,
+    message_max_age_days: settings?.message_max_age_days ?? 14,
     ceremony: {
       time: settings?.ceremony?.time ?? "09:00",
       decay_rate: settings?.ceremony?.decay_rate ?? null,
       explore_threshold: settings?.ceremony?.explore_threshold ?? null,
       dedup_threshold: settings?.ceremony?.dedup_threshold ?? null,
+      event_window_hours: settings?.ceremony?.event_window_hours ?? null,
     },
     opencode: {
       integration: settings?.opencode?.integration ?? false,
@@ -603,6 +613,7 @@ export function settingsFromYAML(yamlContent: string, original: HumanSettings |
       decay_rate: nullToUndefined(data.ceremony.decay_rate),
       explore_threshold: nullToUndefined(data.ceremony.explore_threshold),
       dedup_threshold: nullToUndefined(data.ceremony.dedup_threshold),
+      event_window_hours: nullToUndefined(data.ceremony.event_window_hours),
       last_ceremony: original?.ceremony?.last_ceremony,
     };
   }
@@ -669,6 +680,10 @@ export function settingsFromYAML(yamlContent: string, original: HumanSettings |
     rewrite_model: nullToUndefined(data.rewrite_model),
     time_mode: nullToUndefined(data.time_mode),
     name_display: nullToUndefined(data.name_display),
+    default_heartbeat_ms: nullToUndefined(data.default_heartbeat_ms),
+    default_context_window_hours: nullToUndefined(data.default_context_window_hours),
+    message_min_count: nullToUndefined(data.message_min_count),
+    message_max_age_days: nullToUndefined(data.message_max_age_days),
     ceremony,
     opencode,
     claudeCode,