@bojackduy/opencode-telescope 0.1.21 → 0.1.22

package/README.md

@@ -1,9 +1,18 @@
 # opencode-telescope
 
-Fuzzy search across all your OpenCode conversations — grep through session and chat history, find code snippets, and jump to any chat instantly.
+OpenCode TUI plugin for fuzzy-searching local conversation history, session transcripts, and past AI coding chats.
+
+Install the npm package `@bojackduy/opencode-telescope` to grep through OpenCode chat history, find old code snippets, and jump back to any session instantly.
 
 > Inspired by [telescope.nvim](https://github.com/nvim-telescope/telescope.nvim) — a fuzzy finder for your conversation history.
 
+## Links
+
+- Documentation: https://bojackduy.github.io/opencode-telescope/
+- npm: https://www.npmjs.com/package/@bojackduy/opencode-telescope
+- GitHub: https://github.com/bojackduy/opencode-telescope
+- Issues: https://github.com/bojackduy/opencode-telescope/issues
+
 ![Demo](./assets/demo.png)
 
 ## Use cases
@@ -19,9 +28,12 @@ Fuzzy search across all your OpenCode conversations — grep through session and
 - **Live preview** — preview the matched conversation result before opening
 - **Find & jump** — select any result and jump straight to that session
 - **Neovim Telescope-style UX** — familiar `<leader>f` keybind and `/telescope` command
+- **Local-first search** — reads your OpenCode session database without sending chat history to a remote service
 
 ## Installation
 
+Install from npm as `@bojackduy/opencode-telescope`.
+
 Add the plugin to your `tui.json`:
 
 ```jsonc
@@ -88,4 +100,8 @@ Key strings support simple names like `j`, `k`, `down`, `up`, `enter`, `return`,
 
 Reads the OpenCode local SQLite session database in read-only mode, parses conversations into searchable text, and opens the selected session through the existing TUI route.
 
+## Keywords
+
+OpenCode plugin, OpenCode TUI, fuzzy finder, conversation search, chat history search, AI coding session search, LLM history, local session search, Telescope-style picker.
+
 ![Demo animation](./assets/demo.gif)

package/package.json

@@ -1,17 +1,17 @@
 {
   "$schema": "https://json.schemastore.org/package.json",
   "name": "@bojackduy/opencode-telescope",
-  "version": "0.1.21",
-  "description": "Fuzzy search across all OpenCode conversations — grep session and chat history, find code snippets, and jump to any chat instantly",
+  "version": "0.1.22",
+  "description": "OpenCode TUI plugin for fuzzy-searching local conversation history, session transcripts, and past AI coding chats",
   "type": "module",
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/Duyyy123/opencode-telescope.git"
+    "url": "git+https://github.com/bojackduy/opencode-telescope.git"
   },
-  "homepage": "https://github.com/Duyyy123/opencode-telescope#readme",
+  "homepage": "https://bojackduy.github.io/opencode-telescope/",
   "bugs": {
-    "url": "https://github.com/Duyyy123/opencode-telescope/issues"
+    "url": "https://github.com/bojackduy/opencode-telescope/issues"
   },
   "keywords": [
     "opencode",
@@ -21,11 +21,15 @@
     "search",
     "session",
     "conversation",
+    "conversation-search",
     "history",
+    "ai-chat-history",
+    "llm-history",
     "fuzzy",
     "fuzzy-finder",
     "grep",
     "finder",
+    "opencode-tui",
     "neovim",
     "chat-history"
   ],

package/telescope.tsx

@@ -93,6 +93,9 @@ export const Telescope = (props: { api: TuiPluginApi; config: TelescopeConfig; o
   let resultNavigationStarted = false
   let resultPrefetchTimer: ReturnType<typeof setTimeout> | undefined
   let resultPreviousTimer: ReturnType<typeof setTimeout> | undefined
+  let searchTimer: ReturnType<typeof setTimeout> | undefined
+  let lastFiredQuery = ""
+  const SEARCH_DEBOUNCE_MS = 200
   type PreviewBeforeIntent = "passive-prefetch" | "explicit-scroll"
   type PendingPreviewBefore = {
     id: number
@@ -193,6 +196,51 @@ export const Telescope = (props: { api: TuiPluginApi; config: TelescopeConfig; o
     })
   })
 
+  const executeSearch = (q: string, role: SearchRole | undefined, db: string, dir: string) => {
+    lastFiredQuery = q
+    const limit = q ? Math.min(searchBatchSize(), 80) : recentBatchSize()
+    setLoading(true)
+    if (q) setBusy(true)
+    debug.time("query:search")
+    try {
+      debug.log("bootstrap:search:start", { limit, directory: dir, role, query: q || "(all recent)" })
+      const batch = q
+        ? searchSessionMessages(q, { limit, offset: 0, dbPath: db, directory: dir, role })
+        : recentSessionMessages({ limit, offset: 0, dbPath: db, directory: dir, role })
+      debug.log("bootstrap:search:done", { rows: batch.length, limit })
+      solidBatch(() => {
+        setResults(batch)
+        setResultBaseOffset(0)
+        setNextResultOffset(batch.length)
+        setHasMore(batch.length >= limit)
+        setResultPageInfo({ loadedUntil: batch.length, hasMore: batch.length >= limit, pageSize: limit, lastOffset: 0, lastAdded: batch.length })
+        setSelected(0)
+      })
+    } catch (err) {
+      debug.log("bootstrap:search:error", err instanceof Error ? err.message : String(err))
+      solidBatch(() => {
+        setResults([])
+        setResultBaseOffset(0)
+        setNextResultOffset(0)
+        setResultPageInfo({ loadedUntil: 0, hasMore: false, pageSize: limit, lastOffset: 0, lastAdded: 0 })
+      })
+      setError(err instanceof Error ? err.message : String(err))
+    } finally {
+      debug.timeEnd("query:search")
+      setBusy(false)
+      setLoading(false)
+    }
+  }
+
+  const scheduleSearch = (q: string, role: SearchRole | undefined, db: string, dir: string) => {
+    if (searchTimer) clearTimeout(searchTimer)
+    if (q === lastFiredQuery && results().length > 0) return
+    searchTimer = setTimeout(() => {
+      searchTimer = undefined
+      executeSearch(q, role, db, dir)
+    }, q ? SEARCH_DEBOUNCE_MS : 1)
+  }
+
   createEffect(() => {
     const q = query().trim()
     const role = ownerRole()
@@ -211,73 +259,11 @@ export const Telescope = (props: { api: TuiPluginApi; config: TelescopeConfig; o
     const db = dbPath()
     const dir = directory
 
-    if (!q) {
-      setLoading(true)
-      const limit = recentBatchSize()
-      const timer = setTimeout(() => {
-        debug.log("bootstrap:recent:start", { limit, directory: dir, role })
-        debug.time("query:recent")
-        try {
-          const batch = recentSessionMessages({ limit, offset: 0, dbPath: db, directory: dir, role })
-          debug.log("bootstrap:recent:done", { rows: batch.length, limit })
-          solidBatch(() => {
-            setResults(batch)
-            setResultBaseOffset(0)
-            setNextResultOffset(batch.length)
-            setHasMore(batch.length >= limit)
-            setResultPageInfo({ loadedUntil: batch.length, hasMore: batch.length >= limit, pageSize: limit, lastOffset: 0, lastAdded: batch.length })
-            setSelected(0)
-          })
-        } catch (err) {
-          debug.log("bootstrap:recent:error", err instanceof Error ? err.message : String(err))
-          solidBatch(() => {
-            setResults([])
-            setResultBaseOffset(0)
-            setNextResultOffset(0)
-            setResultPageInfo({ loadedUntil: 0, hasMore: false, pageSize: limit, lastOffset: 0, lastAdded: 0 })
-          })
-          setError(err instanceof Error ? err.message : String(err))
-        }
-        debug.timeEnd("query:recent")
-        setLoading(false)
-        debug.log("component:interactive")
-      }, 1)
-      onCleanup(() => clearTimeout(timer))
-      return
-    }
-
-    setLoading(true)
-    setBusy(true)
-    const limit = searchBatchSize()
-    const timer = setTimeout(() => {
-      debug.time("query:search")
-      try {
-        debug.log("bootstrap:search:start", { limit, directory: dir, role, query: q })
-        const batch = searchSessionMessages(q, { limit, offset: 0, dbPath: db, directory: dir, role })
-        debug.log("bootstrap:search:done", { rows: batch.length, limit })
-        solidBatch(() => {
-          setResults(batch)
-          setResultBaseOffset(0)
-          setNextResultOffset(batch.length)
-          setHasMore(batch.length >= limit)
-          setResultPageInfo({ loadedUntil: batch.length, hasMore: batch.length >= limit, pageSize: limit, lastOffset: 0, lastAdded: batch.length })
-          setSelected(0)
-        })
-      } catch (err) {
-        solidBatch(() => {
-          setResults([])
-          setResultBaseOffset(0)
-          setNextResultOffset(0)
-          setResultPageInfo({ loadedUntil: 0, hasMore: false, pageSize: limit, lastOffset: 0, lastAdded: 0 })
-        })
-        setError(err instanceof Error ? err.message : String(err))
-      } finally {
-        debug.timeEnd("query:search")
-        setBusy(false)
-        setLoading(false)
-      }
-    }, 180)
-    onCleanup(() => clearTimeout(timer))
+    scheduleSearch(q, role, db, dir)
+    onCleanup(() => {
+      if (searchTimer) clearTimeout(searchTimer)
+      searchTimer = undefined
+    })
   })
 
   const loadMoreResults = (advance = false) => {
@@ -778,6 +764,33 @@ export const Telescope = (props: { api: TuiPluginApi; config: TelescopeConfig; o
               })
             }
           }
+
+          if (pending.intent === "passive-prefetch") {
+            const matchItem = selectedResult()
+            const scroll = previewScroll
+            if (matchItem && scroll) {
+              const layout = previewVirtualLayout()
+              const matchRow = layout.find((r) => r.part.id === matchItem.id)
+              if (matchRow) {
+                const viewportHeight = scroll.height
+                const desiredScrollTop = Math.max(0, matchRow.top - Math.floor(viewportHeight / 3))
+                const msSinceManual = Date.now() - lastPreviewScrollKeyMs
+                if (Math.abs(scroll.scrollTop - desiredScrollTop) >= 2 && msSinceManual > 700) {
+                  const correctedWindow = previewWindowForLayout(layout, desiredScrollTop, viewportHeight)
+                  setPreviewWindow(correctedWindow)
+                  scroll.scrollTo(desiredScrollTop)
+                  debug.log("preview:load-before:recenter", {
+                    matchPartID: matchItem.id,
+                    matchTop: matchRow.top,
+                    scrollTop: scroll.scrollTop,
+                    desiredScrollTop,
+                    viewportHeight,
+                    window: correctedWindow,
+                  })
+                }
+              }
+            }
+          }
         }, 1)
       }
       setHasMorePreviewBefore(page.hasMoreBefore)
@@ -971,7 +984,24 @@ export const Telescope = (props: { api: TuiPluginApi; config: TelescopeConfig; o
     debug.log("preview:target-scroll:estimated", { targetID, targetTop: row.top, scrollTop: scroll.scrollTop, nextScrollTop: top, window: previewWindow() })
     scroll.scrollTo(top)
     updatePreviewWindow()
-    setTimeout(() => scrollPreviewToTarget(scroll, targetID), 1)
+    const scrollTopBeforeReal = scroll.scrollTop
+    setTimeout(() => {
+      scrollPreviewToTarget(scroll, targetID)
+      const now = Date.now()
+      const adjustmentMs = lastPreviewScrollKeyMs
+      if (adjustmentMs > 0 && now - adjustmentMs > 300) {
+        const targetTopReal = row.top
+        const expectedScrollTop = Math.max(0, targetTopReal - Math.max(1, Math.floor(scroll.height / 3)))
+        const drift = scroll.scrollTop - expectedScrollTop
+        if (Math.abs(drift) >= 2) {
+          const correctedScrollTop = scroll.scrollTop - drift
+          const correctedWindow = previewWindowForLayout(previewVirtualLayout(), correctedScrollTop, scroll.height)
+          setPreviewWindow(correctedWindow)
+          scroll.scrollTo(correctedScrollTop)
+          debug.log("preview:target-scroll:real-correct", { targetID, drift, scrollTopAfterReal: scroll.scrollTop, correctedScrollTop, window: correctedWindow })
+        }
+      }
+    }, 1)
   }
 
   let lastPreviewItemId = ""

package/ui/render-target.ts

@@ -31,18 +31,20 @@ export function scrollPreviewToTarget(scroll: ScrollBoxRenderable | undefined, t
     })
     return
   }
-  const delta = target.y - scroll.y - Math.max(1, Math.floor(scroll.height / 3))
+  const contentY = target.y + scroll.scrollTop - scroll.y
+  const desiredScrollTop = Math.max(0, contentY - Math.max(1, Math.floor(scroll.height / 3)))
   debug.log("preview:target-scroll", {
     targetID,
     targetY: target.y,
     scrollY: scroll.y,
     scrollTop: scroll.scrollTop,
+    contentY,
+    desiredScrollTop,
     scrollHeight: scroll.height,
     contentHeight: scroll.scrollHeight,
-    delta,
   })
-  scroll.scrollBy(delta)
-  debug.log("preview:target-scroll:after", { targetID, scrollY: scroll.y, scrollTop: scroll.scrollTop })
+  scroll.scrollTo(desiredScrollTop)
+  debug.log("preview:target-scroll:after", { targetID, scrollY: scroll.y, scrollTop: scroll.scrollTop, desiredScrollTop })
 }
 
 export function jumpToRenderedTarget(root: unknown, targetID: string) {