feat(search): add full-text search across session conversation content

Adds SQLite FTS5-powered full-text search (inspired by arjunkmrm/recall)
that indexes actual conversation messages from Claude Code sessions.
Features BM25 ranking with recency bias, Porter stemming, incremental
indexing, and highlighted search snippets in the session manager UI.

https://claude.ai/code/session_01M5UqQYVXHPdHHz1oPH4aqT

Author: claude

app/pages/ai/sessions.vue

@@ -23,6 +23,22 @@ const { data, refresh, status } = useFetch('/api/ai/sessions', {
 const list_sessions = computed(() => data.value?.sessions ?? [])
 const list_projects = computed(() => data.value?.projects ?? [])
 
+// Full-text search (FTS) — triggers when query >= 3 chars
+const is_content_search = computed(() => (query_debounced.value?.length ?? 0) >= 3)
+const search_params = computed(() => ({
+	q: query_debounced.value || undefined,
+	project: filter_project.value || undefined,
+	limit: 50
+}))
+
+const { data: data_search, status: status_search } = useFetch('/api/ai/sessions/search', {
+	query: search_params,
+	watch: [search_params],
+	default: () => ({ results: [] as Array<{ session_id: string, project: string, title: string, cwd: string, time_modified: string, snippet: string, score: number }>, query: '' })
+})
+
+const list_search_results = computed(() => data_search.value?.results ?? [])
+
 // Archive data
 const { data: list_archive, refresh: refreshArchive } = useFetch('/api/ai/sessions/archive', {
 	default: () => [] as Array<{ id: string; title: string; project: string; deleted_at: string }>
@@ -312,10 +328,48 @@ async function handleEmptyTrash(): Promise<void> {
 					</div>
 
 					<!-- Loading state -->
-					<div v-if="status === 'pending'" class="px-4 space-y-2">
+					<div v-if="status === 'pending' && !is_content_search" class="px-4 space-y-2">
 						<div v-for="i in 6" :key="i" class="h-12 rounded-lg bg-elevated/30 animate-pulse" />
 					</div>
 
+					<!-- FTS content search results -->
+					<div v-else-if="is_content_search" class="px-4 pb-4">
+						<div v-if="status_search === 'pending'" class="space-y-2">
+							<div v-for="i in 4" :key="i" class="h-16 rounded-lg bg-elevated/30 animate-pulse" />
+						</div>
+						<div v-else-if="list_search_results.length > 0" class="space-y-1">
+							<p class="text-[10px] text-dimmed/50 px-3 py-1">
+								{{ list_search_results.length }} content match{{ list_search_results.length === 1 ? '' : 'es' }}
+							</p>
+							<div
+								v-for="result in list_search_results"
+								:key="result.session_id"
+								class="w-full flex flex-col gap-1 px-3 py-2.5 rounded-lg text-left text-sm hover:bg-elevated/50 transition-colors cursor-pointer group"
+								@click="handleResumeSession({ id: result.session_id, cwd: result.cwd })"
+							>
+								<div class="flex items-center gap-3 min-w-0">
+									<UIcon name="i-lucide-search" class="size-3.5 text-dimmed shrink-0 group-hover:text-primary transition-colors" />
+									<span class="flex-1 truncate">{{ result.title || 'Untitled session' }}</span>
+									<UBadge color="neutral" variant="subtle" size="xs" class="shrink-0">
+										{{ result.project }}
+									</UBadge>
+									<span class="text-[10px] text-dimmed/50 shrink-0">{{ formatTimeAgo(result.time_modified) }}</span>
+								</div>
+								<!-- eslint-disable-next-line vue/no-v-html -->
+								<p class="text-xs text-dimmed/70 pl-6.5 line-clamp-2 [&>mark]:bg-primary/20 [&>mark]:text-primary [&>mark]:rounded-sm [&>mark]:px-0.5" v-html="result.snippet" />
+							</div>
+						</div>
+						<div v-else class="flex flex-col items-center justify-center py-16 text-center">
+							<UIcon name="i-lucide-search-x" class="size-10 text-dimmed/30 mb-3" />
+							<p class="text-sm text-dimmed">
+								No content matches
+							</p>
+							<p class="text-xs text-dimmed/50 mt-1">
+								Try different keywords or a shorter query
+							</p>
+						</div>
+					</div>
+
 					<!-- Session list -->
 					<div v-else-if="list_sessions.length > 0" class="px-4 pb-4 space-y-1">
 						<!-- Select all row (when no selection yet) -->

nuxt.config.ts

@@ -44,6 +44,12 @@ export default defineNuxtConfig({
 		anthropicApiKey: ''
 	},
 
+	nitro: {
+		externals: {
+			inline: ['better-sqlite3']
+		}
+	},
+
 	compatibilityDate: '2025-01-01',
 
 	eslint: {

package.json

@@ -22,6 +22,7 @@
     "@unovis/vue": "^1.6.2",
     "@vueuse/core": "^14.1.0",
     "@vueuse/nuxt": "^14.1.0",
+    "better-sqlite3": "^12.6.2",
     "date-fns": "^4.1.0",
     "fuse.js": "^7.1.0",
     "gray-matter": "^4.0.3",
@@ -32,10 +33,16 @@
   },
   "devDependencies": {
     "@nuxt/eslint": "^1.13.0",
+    "@types/better-sqlite3": "^7.6.13",
     "@types/node": "^25.2.1",
     "eslint": "^9.39.2",
     "typescript": "^5.9.3",
     "vue-tsc": "^3.2.4"
   },
+  "pnpm": {
+    "onlyBuiltDependencies": [
+      "better-sqlite3"
+    ]
+  },
   "packageManager": "pnpm@10.28.1"
 }

pnpm-lock.yaml

@@ -1,11 +1,5 @@
 import { readFile, readdir } from 'node:fs/promises'
 
-interface ConversationMessage {
-	role: 'user' | 'assistant'
-	content: string
-	timestamp: string
-}
-
 export default defineApiHandler(async (event) => {
 	const id = getRouterParam(event, 'id')
 	if (!id) {
@@ -40,65 +34,7 @@ export default defineApiHandler(async (event) => {
 	}
 
 	const lines = raw.split('\n').filter(l => l.trim())
-
-	let cwd = ''
-	const messages: ConversationMessage[] = []
-
-	for (const line of lines) {
-		let entry: Record<string, unknown>
-		try {
-			entry = JSON.parse(line)
-		}
-		catch {
-			continue
-		}
-
-		if (!cwd && typeof entry.cwd === 'string') {
-			cwd = entry.cwd
-		}
-
-		if (entry.type === 'user') {
-			if (entry.isMeta) continue
-
-			const msg = entry.message as { role?: string; content?: unknown } | undefined
-			if (!msg || msg.role !== 'user') continue
-
-			// Skip tool_result messages (tool outputs, not user text)
-			if (Array.isArray(msg.content) && msg.content.length > 0 && msg.content[0].type === 'tool_result') {
-				continue
-			}
-
-			const text = extractTextContent(msg.content)
-			if (text) {
-				messages.push({
-					role: 'user',
-					content: text,
-					timestamp: (entry.timestamp as string) || ''
-				})
-			}
-		}
-		else if (entry.type === 'assistant') {
-			const msg = entry.message as { role?: string; content?: unknown } | undefined
-			if (!msg || msg.role !== 'assistant') continue
-			if (!Array.isArray(msg.content)) continue
-
-			const text_parts: string[] = []
-			for (const block of msg.content as Array<{ type: string; text?: string }>) {
-				if (block.type === 'text' && block.text) {
-					text_parts.push(block.text)
-				}
-			}
-
-			const text = text_parts.join('\n')
-			if (text) {
-				messages.push({
-					role: 'assistant',
-					content: text,
-					timestamp: (entry.timestamp as string) || ''
-				})
-			}
-		}
-	}
+	const { cwd, messages } = parseSessionMessages(lines)
 
 	return { id, cwd, messages }
 })

server/api/ai/sessions/[id].get.ts

@@ -0,0 +1,16 @@
+export default defineApiHandler(async (event) => {
+	const query = getQuery(event)
+	const q = ((query.q as string) || '').trim()
+	const project = (query.project as string) || ''
+	const limit = Math.min(Number(query.limit) || 20, 100)
+
+	if (!q || q.length < 2) {
+		return { results: [], query: q }
+	}
+
+	ensureIndexFresh()
+
+	const results = searchMessages(q, { limit, project: project || undefined })
+
+	return { results, query: q }
+})