gora-cli 0.1.2__tar.gz → 0.1.3__tar.gz

{gora_cli-0.1.2 → gora_cli-0.1.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: gora-cli
-Version: 0.1.2
+Version: 0.1.3
 Summary: Local CLI chat history index for Codex, Claude Code, and Pi.
 Classifier: Environment :: Console
 Classifier: Intended Audience :: Developers
@@ -124,6 +124,8 @@ go -C gora/go_tui build -o ../../dist/gora-tui .
 GORA_TUI_BIN=dist/gora-tui gora
 ```
 
+Live search starts after two characters and updates as you type.
+
 Controls:
 
 ```text

{gora_cli-0.1.2 → gora_cli-0.1.3}/README.md

@@ -111,6 +111,8 @@ go -C gora/go_tui build -o ../../dist/gora-tui .
 GORA_TUI_BIN=dist/gora-tui gora
 ```
 
+Live search starts after two characters and updates as you type.
+
 Controls:
 
 ```text

{gora_cli-0.1.2 → gora_cli-0.1.3}/gora/__init__.py

@@ -2,4 +2,4 @@
 
 __all__ = ["__version__"]
 
-__version__ = "0.1.2"
+__version__ = "0.1.3"

{gora_cli-0.1.2 → gora_cli-0.1.3}/gora/go_tui/main.go

@@ -1,6 +1,7 @@
 package main
 
 import (
+	"context"
 	"database/sql"
 	"errors"
 	"flag"
@@ -49,6 +50,25 @@ var (
 	imageTagPattern = regexp.MustCompile(`(?s)</?image\b[^>]*(>|$)`)
 )
 
+const (
+	tuiSearchDebounce = 180 * time.Millisecond
+	tuiSearchMinRunes = 2
+	tuiSearchLimit    = 500
+)
+
+type reloadTickMsg struct {
+	token int
+}
+
+type resultsLoadedMsg struct {
+	token     int
+	query     string
+	rows      []item
+	truncated bool
+	tooShort  bool
+	err       error
+}
+
 type item struct {
 	SessionKey   string
 	Provider     string
@@ -334,44 +354,54 @@ func newFilterList(width int, height int) list.Model {
 }
 
 type model struct {
-	db              *sql.DB
-	dbPath          string
-	search          textinput.Model
-	transcriptView  viewport.Model
-	helpBubble      help.Model
-	resultsTable    table.Model
-	filterList      list.Model
-	keys            keyMap
-	providers       map[string]bool
-	repoFilters     map[string]bool
-	modelFilters    map[string]bool
-	providerOptions []filterOption
-	repoOptions     []filterOption
-	modelOptions    []filterOption
-	allRoles        bool
-	detail          bool
-	detailItem      item
-	filterOpen      bool
-	focus           focusArea
-	filterSection   filterSection
-	previewKey      string
-	previewWidth    int
-	previewAllRoles bool
-	previewLines    []string
-	previewErr      error
-	selected        int
-	width           int
-	height          int
-	searchTop       int
-	searchBottom    int
-	filterTop       int
-	filterBottom    int
-	rowsTop         int
-	browseButtons   []actionButton
-	detailButtons   []actionButton
-	results         []item
-	notice          string
-	err             error
+	db                *sql.DB
+	dbPath            string
+	search            textinput.Model
+	transcriptView    viewport.Model
+	helpBubble        help.Model
+	resultsTable      table.Model
+	filterList        list.Model
+	keys              keyMap
+	providers         map[string]bool
+	repoFilters       map[string]bool
+	modelFilters      map[string]bool
+	providerOptions   []filterOption
+	repoOptions       []filterOption
+	modelOptions      []filterOption
+	allRoles          bool
+	detail            bool
+	detailItem        item
+	filterOpen        bool
+	focus             focusArea
+	filterSection     filterSection
+	previewKey        string
+	previewWidth      int
+	previewAllRoles   bool
+	previewLines      []string
+	previewErr        error
+	selected          int
+	width             int
+	height            int
+	searchTop         int
+	searchBottom      int
+	filterTop         int
+	filterBottom      int
+	rowsTop           int
+	browseButtons     []actionButton
+	detailButtons     []actionButton
+	results           []item
+	loading           bool
+	searchTooShort    bool
+	resultsTruncated  bool
+	reloadToken       int
+	cancelReload      context.CancelFunc
+	resultsVersion    int
+	tableRowsVersion  int
+	tableRowsWidth    int
+	tableRowsHeight   int
+	tableRowsSelected int
+	notice            string
+	err               error
 }
 
 func main() {
@@ -419,7 +449,6 @@ func main() {
 	m.providerOptions, _ = loadProviderOptions(db)
 	m.repoOptions, _ = loadRepoOptions(db)
 	m.modelOptions, _ = loadModelOptions(db)
-	m.reload()
 
 	program := tea.NewProgram(m, tea.WithAltScreen(), tea.WithMouseCellMotion())
 	if _, err := program.Run(); err != nil {
@@ -437,7 +466,7 @@ func configureTerminalColors() {
 }
 
 func (m *model) Init() tea.Cmd {
-	return textinput.Blink
+	return tea.Batch(textinput.Blink, m.requestReload(0))
 }
 
 func (m *model) Update(msg tea.Msg) (tea.Model, tea.Cmd) {
@@ -455,6 +484,13 @@ func (m *model) Update(msg tea.Msg) (tea.Model, tea.Cmd) {
 		return m, m.handleKey(msg)
 	case tea.MouseMsg:
 		return m, m.handleMouse(msg)
+	case reloadTickMsg:
+		if msg.token != m.reloadToken {
+			return m, nil
+		}
+		return m, m.loadResultsCmd(msg.token)
+	case resultsLoadedMsg:
+		m.applyResults(msg)
 	}
 	return m, nil
 }
@@ -489,15 +525,13 @@ func (m *model) handleKey(msg tea.KeyMsg) tea.Cmd {
 		if m.search.Value() != "" {
 			m.search.SetValue("")
 			m.resetPosition()
-			m.reload()
-			return nil
+			return m.requestReload(0)
 		}
 		if m.hasActiveFilters() {
 			m.clearFilters()
 			m.notice = "filters cleared"
 			m.resetPosition()
-			m.reload()
-			return nil
+			return m.requestReload(0)
 		}
 		return tea.Quit
 	case "tab":
@@ -533,27 +567,33 @@ func (m *model) handleKey(msg tea.KeyMsg) tea.Cmd {
 	case "ctrl+r":
 		m.allRoles = !m.allRoles
 		m.resetPosition()
-		m.reload()
+		return m.requestReload(0)
 	case "ctrl+u":
 		m.search.SetValue("")
 		m.resetPosition()
-		m.reload()
+		return m.requestReload(0)
 	default:
 		if m.focus != focusSearch {
 			if key == "m" {
 				m.exportSelected("md")
+				return nil
 			}
 			if key == "t" {
 				m.exportSelected("txt")
+				return nil
+			}
+			if isPrintableSearchKey(msg) {
+				m.setFocus(focusSearch)
+			} else {
+				return nil
 			}
-			return nil
 		}
 		before := m.search.Value()
 		var cmd tea.Cmd
 		m.search, cmd = m.search.Update(msg)
 		if m.search.Value() != before {
 			m.resetPosition()
-			m.reload()
+			return tea.Batch(cmd, m.requestReload(tuiSearchDebounce))
 		}
 		return cmd
 	}
@@ -800,8 +840,21 @@ func (m *model) renderFilters(width int) string {
 }
 
 func (m *model) renderStatus(width int) string {
+	if m.loading {
+		query := strings.TrimSpace(m.search.Value())
+		if query != "" {
+			return m.renderStatusLine(fmt.Sprintf("searching for %q", query), width)
+		}
+		return m.renderStatusLine("loading recent chats", width)
+	}
+	if m.searchTooShort {
+		return m.renderStatusLine(fmt.Sprintf("type at least %d characters to search", tuiSearchMinRunes), width)
+	}
 	if m.search.Value() != "" {
 		status := fmt.Sprintf("%d matches for %q", len(m.results), m.search.Value())
+		if m.resultsTruncated {
+			status = fmt.Sprintf("showing first %d matches for %q", len(m.results), m.search.Value())
+		}
 		return m.renderStatusLine(status, width)
 	}
 	return m.renderStatusLine(fmt.Sprintf("%d recent chats", len(m.results)), width)
@@ -826,6 +879,12 @@ func (m *model) renderResultsTitle(width int) string {
 
 func (m *model) renderResultsTable(width int, height int) string {
 	if len(m.results) == 0 {
+		if m.loading {
+			return mutedStyle.Render("  loading...")
+		}
+		if m.searchTooShort {
+			return mutedStyle.Render(fmt.Sprintf("  type at least %d characters to search", tuiSearchMinRunes))
+		}
 		if m.hasActiveFilters() {
 			return mutedStyle.Render("  no chats match the current filters")
 		}
@@ -960,12 +1019,24 @@ func (m *model) configureResultsTable(width int, height int) {
 	if m.resultsTable.Width() == 0 && m.resultsTable.Height() == 0 {
 		m.resultsTable = newResultsTable()
 	}
-	m.resultsTable.SetColumns(resultTableColumns(width))
 	m.selected = clamp(m.selected, 0, max(0, len(m.results)-1))
-	m.resultsTable.SetRows(resultTableRows(m.results, m.selected))
+	height = max(4, height)
+	if m.tableRowsVersion != m.resultsVersion ||
+		m.tableRowsWidth != width ||
+		m.tableRowsHeight != height ||
+		m.tableRowsSelected != m.selected {
+		m.resultsTable.SetColumns(resultTableColumns(width))
+		m.resultsTable.SetRows(resultTableRows(m.results, m.selected))
+		m.tableRowsVersion = m.resultsVersion
+		m.tableRowsWidth = width
+		m.tableRowsHeight = height
+		m.tableRowsSelected = m.selected
+	}
 	m.resultsTable.SetWidth(width)
-	m.resultsTable.SetHeight(max(4, height))
-	m.resultsTable.SetCursor(m.selected)
+	m.resultsTable.SetHeight(height)
+	if m.resultsTable.Cursor() != m.selected {
+		m.resultsTable.SetCursor(m.selected)
+	}
 	if m.focus == focusResults {
 		m.resultsTable.Focus()
 	} else {
@@ -1459,11 +1530,11 @@ func (m *model) openFilters() {
 	m.configureFilterList(max(72, m.width), max(8, m.height-8))
 }
 
-func (m *model) closeFilters() {
+func (m *model) closeFilters() tea.Cmd {
 	m.filterOpen = false
 	m.setFocus(focusFilters)
 	m.resetPosition()
-	m.reload()
+	return m.requestReload(0)
 }
 
 func (m *model) handleFilterKey(msg tea.KeyMsg) tea.Cmd {
@@ -1472,7 +1543,7 @@ func (m *model) handleFilterKey(msg tea.KeyMsg) tea.Cmd {
 	case "ctrl+c":
 		return tea.Quit
 	case "esc", "left":
-		m.closeFilters()
+		return m.closeFilters()
 	case "tab", "right":
 		m.advanceFilterSection()
 	case "shift+tab":
@@ -1734,28 +1805,86 @@ func clearSet(set map[string]bool) {
 	}
 }
 
-func (m *model) reload() {
+func (m *model) requestReload(delay time.Duration) tea.Cmd {
+	if m.cancelReload != nil {
+		m.cancelReload()
+		m.cancelReload = nil
+	}
 	m.err = nil
-	var rows []item
-	var err error
+	m.loading = true
+	m.searchTooShort = false
+	m.resultsTruncated = false
+	m.reloadToken++
+	token := m.reloadToken
+
+	query := strings.TrimSpace(m.search.Value())
+	if query != "" && runeCount(query) < tuiSearchMinRunes {
+		return func() tea.Msg {
+			return resultsLoadedMsg{token: token, query: query, tooShort: true}
+		}
+	}
+	if delay > 0 {
+		return tea.Tick(delay, func(time.Time) tea.Msg {
+			return reloadTickMsg{token: token}
+		})
+	}
+	return m.loadResultsCmd(token)
+}
+
+func (m *model) loadResultsCmd(token int) tea.Cmd {
+	ctx, cancel := context.WithCancel(context.Background())
+	m.cancelReload = cancel
+
 	query := strings.TrimSpace(m.search.Value())
 	providers := selectedSetValues(m.providers)
 	models := selectedSetValues(m.modelFilters)
 	repos := selectedSetValues(m.repoFilters)
-	if query == "" {
-		rows, err = listSessions(m.db, providers, models, repos)
-	} else {
-		rows, err = searchMessages(m.db, query, providers, models, repos, m.allRoles)
+	allRoles := m.allRoles
+	db := m.db
+
+	return func() tea.Msg {
+		var rows []item
+		var truncated bool
+		var err error
+		if query == "" {
+			rows, err = listSessionsContext(ctx, db, providers, models, repos)
+		} else {
+			rows, truncated, err = searchMessagesContext(ctx, db, query, providers, models, repos, allRoles, tuiSearchLimit)
+		}
+		return resultsLoadedMsg{
+			token:     token,
+			query:     query,
+			rows:      rows,
+			truncated: truncated,
+			err:       err,
+		}
 	}
-	if err != nil {
-		m.err = err
+}
+
+func (m *model) applyResults(msg resultsLoadedMsg) {
+	if msg.token != m.reloadToken {
+		return
+	}
+	m.loading = false
+	m.searchTooShort = msg.tooShort
+	m.resultsTruncated = msg.truncated
+	m.cancelReload = nil
+	if msg.err != nil {
+		if errors.Is(msg.err, context.Canceled) {
+			return
+		}
+		m.err = msg.err
 		m.results = nil
+		m.resultsVersion++
 		return
 	}
-	m.results = rows
+	m.err = nil
+	m.results = msg.rows
 	if m.selected >= len(m.results) {
 		m.selected = max(0, len(m.results)-1)
 	}
+	m.resultsVersion++
+	m.previewKey = ""
 	m.configureResultsTable(max(72, m.width), max(4, m.height/2))
 }
 
@@ -1765,6 +1894,17 @@ func (m *model) resetPosition() {
 	m.detail = false
 }
 
+func isPrintableSearchKey(msg tea.KeyMsg) bool {
+	if msg.Type != tea.KeyRunes {
+		return false
+	}
+	return len(msg.Runes) > 0
+}
+
+func runeCount(value string) int {
+	return len([]rune(strings.TrimSpace(value)))
+}
+
 func (m *model) detailHeight() int {
 	return max(1, m.height-5)
 }
@@ -1859,6 +1999,10 @@ func loadModelOptions(db *sql.DB) ([]filterOption, error) {
 }
 
 func listSessions(db *sql.DB, providers []string, models []string, repos []string) ([]item, error) {
+	return listSessionsContext(context.Background(), db, providers, models, repos)
+}
+
+func listSessionsContext(ctx context.Context, db *sql.DB, providers []string, models []string, repos []string) ([]item, error) {
 	filters, args := sessionFilters("s", providers, models, repos)
 	filters = append(filters, rootSessionFilter("s"))
 	filters = append(filters, displayableSessionFilter("s"))
@@ -1866,7 +2010,7 @@ func listSessions(db *sql.DB, providers []string, models []string, repos []strin
 	if len(filters) > 0 {
 		where = "WHERE " + strings.Join(filters, " AND ")
 	}
-	rows, err := db.Query(`
+	rows, err := db.QueryContext(ctx, `
 		SELECT s.session_key, s.provider, `+displayTitleExpr("s")+`,
 		       COALESCE(s.started_at, ''),
 		       COALESCE(s.updated_at, s.started_at, ''),
@@ -1899,14 +2043,19 @@ func listSessions(db *sql.DB, providers []string, models []string, repos []strin
 }
 
 func searchMessages(db *sql.DB, query string, providers []string, models []string, repos []string, allRoles bool) ([]item, error) {
-	rows, err := searchMessagesFTS(db, query, providers, models, repos, allRoles)
+	rows, _, err := searchMessagesContext(context.Background(), db, query, providers, models, repos, allRoles, 0)
+	return rows, err
+}
+
+func searchMessagesContext(ctx context.Context, db *sql.DB, query string, providers []string, models []string, repos []string, allRoles bool, limit int) ([]item, bool, error) {
+	rows, truncated, err := searchMessagesFTS(ctx, db, query, providers, models, repos, allRoles, limit)
 	if err == nil {
-		return rows, nil
+		return rows, truncated, nil
 	}
-	return searchMessagesLike(db, query, providers, models, repos, allRoles)
+	return searchMessagesLike(ctx, db, query, providers, models, repos, allRoles, limit)
 }
 
-func searchMessagesFTS(db *sql.DB, query string, providers []string, models []string, repos []string, allRoles bool) ([]item, error) {
+func searchMessagesFTS(ctx context.Context, db *sql.DB, query string, providers []string, models []string, repos []string, allRoles bool, limit int) ([]item, bool, error) {
 	args := []any{toFTSQuery(query)}
 	filters := messageFilters("m", providers, models, repos, allRoles, &args)
 	filters = append(filters, rootSessionFilter("s"))
@@ -1915,7 +2064,12 @@ func searchMessagesFTS(db *sql.DB, query string, providers []string, models []st
 	if len(filters) > 0 {
 		where += " AND " + strings.Join(filters, " AND ")
 	}
-	rows, err := db.Query(`
+	limitSQL := ""
+	if limit > 0 {
+		limitSQL = " LIMIT ?"
+		args = append(args, limit*6)
+	}
+	rows, err := db.QueryContext(ctx, `
 		SELECT m.session_key, m.provider, `+displayTitleExpr("s")+`,
 		       COALESCE(m.timestamp, s.updated_at, s.started_at, ''),
 		       COALESCE(s.started_at, ''),
@@ -1933,26 +2087,33 @@ func searchMessagesFTS(db *sql.DB, query string, providers []string, models []st
 		JOIN sessions s ON s.session_key = m.session_key
 		WHERE `+where+`
 		ORDER BY bm25(message_fts), COALESCE(m.timestamp, s.updated_at) DESC
+		`+limitSQL+`
 	`, args...)
 	if err != nil {
-		return nil, err
+		return nil, false, err
 	}
 	defer rows.Close()
 	items, err := scanItems(rows, true)
 	if err != nil {
-		return nil, err
+		return nil, false, err
 	}
-	return dedupeItems(items), nil
+	deduped := dedupeItems(items)
+	return limitItems(deduped, limit)
 }
 
-func searchMessagesLike(db *sql.DB, query string, providers []string, models []string, repos []string, allRoles bool) ([]item, error) {
+func searchMessagesLike(ctx context.Context, db *sql.DB, query string, providers []string, models []string, repos []string, allRoles bool, limit int) ([]item, bool, error) {
 	args := []any{"%" + query + "%"}
 	filters := []string{"m.text LIKE ?"}
 	filters = append(filters, messageFilters("m", providers, models, repos, allRoles, &args)...)
 	filters = append(filters, rootSessionFilter("s"))
 	filters = append(filters, displayableSessionFilter("s"))
+	limitSQL := ""
+	if limit > 0 {
+		limitSQL = " LIMIT ?"
+		args = append(args, limit*6)
+	}
 
-	rows, err := db.Query(`
+	rows, err := db.QueryContext(ctx, `
 		SELECT m.session_key, m.provider, `+displayTitleExpr("s")+`,
 		       COALESCE(m.timestamp, s.updated_at, s.started_at, ''),
 		       COALESCE(s.started_at, ''),
@@ -1969,16 +2130,18 @@ func searchMessagesLike(db *sql.DB, query string, providers []string, models []s
 		JOIN sessions s ON s.session_key = m.session_key
 		WHERE `+strings.Join(filters, " AND ")+`
 		ORDER BY COALESCE(m.timestamp, s.updated_at) DESC
+		`+limitSQL+`
 	`, args...)
 	if err != nil {
-		return nil, err
+		return nil, false, err
 	}
 	defer rows.Close()
 	items, err := scanItems(rows, true)
 	if err != nil {
-		return nil, err
+		return nil, false, err
 	}
-	return dedupeItems(items), nil
+	deduped := dedupeItems(items)
+	return limitItems(deduped, limit)
 }
 
 func scanItems(rows *sql.Rows, isMatch bool) ([]item, error) {
@@ -2012,6 +2175,13 @@ func dedupeItems(items []item) []item {
 	return deduped
 }
 
+func limitItems(items []item, limit int) ([]item, bool, error) {
+	if limit <= 0 || len(items) <= limit {
+		return items, false, nil
+	}
+	return items[:limit], true, nil
+}
+
 func loadTranscript(db *sql.DB, sessionKey string, allRoles bool, width int) (string, error) {
 	messages, err := loadTranscriptMessages(db, sessionKey, allRoles)
 	if err != nil {

{gora_cli-0.1.2 → gora_cli-0.1.3}/gora/go_tui/main_test.go

@@ -559,6 +559,44 @@ func TestExportShortcutsDoNotStealSearchTyping(t *testing.T) {
 	}
 }
 
+func TestShortSearchDoesNotTouchDatabase(t *testing.T) {
+	search := textinput.New()
+	search.SetValue("l")
+	m := &model{search: search}
+
+	cmd := m.requestReload(0)
+	raw := cmd()
+	msg, ok := raw.(resultsLoadedMsg)
+	if !ok {
+		t.Fatalf("message = %T, want resultsLoadedMsg", raw)
+	}
+	if !msg.tooShort {
+		t.Fatalf("tooShort = false, want true: %#v", msg)
+	}
+
+	m.applyResults(msg)
+	if !m.searchTooShort {
+		t.Fatal("model did not mark short search")
+	}
+	if m.loading {
+		t.Fatal("model stayed loading after short search")
+	}
+}
+
+func TestPrintableTypingStartsSearchFromResultsFocus(t *testing.T) {
+	search := textinput.New()
+	m := &model{search: search, focus: focusResults}
+
+	_ = m.handleKey(tea.KeyMsg{Type: tea.KeyRunes, Runes: []rune{'l'}})
+
+	if m.focus != focusSearch {
+		t.Fatalf("focus = %v, want search", m.focus)
+	}
+	if m.search.Value() != "l" {
+		t.Fatalf("search value = %q, want l", m.search.Value())
+	}
+}
+
 func TestDedupeItemsDoesNotCapResults(t *testing.T) {
 	items := make([]item, 0, 300)
 	for index := range 300 {

{gora_cli-0.1.2 → gora_cli-0.1.3}/gora/tui.py

@@ -6,7 +6,7 @@ import shutil
 import subprocess
 import sys
 
-TUI_CACHE_VERSION = "bubbletea-v1"
+TUI_CACHE_VERSION = "bubbletea-v2"
 
 
 def run_tui(db_path: Path | None) -> int:
@@ -24,12 +24,13 @@ def run_tui(db_path: Path | None) -> int:
         command.extend(["--db", str(db_path)])
 
     try:
-        return subprocess.run(command, cwd=cwd).returncode
-    except KeyboardInterrupt:
-        return 130
+        if cwd is not None:
+            os.chdir(cwd)
+        os.execvpe(command[0], command, os.environ.copy())
     except OSError as exc:
         print(f"failed to launch Bubble Tea TUI: {exc}", file=sys.stderr)
         return 1
+    return 1
 
 
 def _tui_command() -> tuple[list[str] | None, Path | None]:
@@ -95,6 +96,8 @@ def _build_tui(source_dir: Path, target: Path) -> bool:
     target.parent.mkdir(parents=True, exist_ok=True)
     tmp = target.with_suffix(".tmp")
     try:
+        if sys.stderr.isatty():
+            print("Building Gora TUI helper...", file=sys.stderr)
         result = subprocess.run(
             ["go", "build", "-o", str(tmp), "."],
             cwd=source_dir,

{gora_cli-0.1.2 → gora_cli-0.1.3}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "gora-cli"
-version = "0.1.2"
+version = "0.1.3"
 description = "Local CLI chat history index for Codex, Claude Code, and Pi."
 readme = "README.md"
 requires-python = ">=3.13"

{gora_cli-0.1.2 → gora_cli-0.1.3}/uv.lock

@@ -4,5 +4,5 @@ requires-python = ">=3.13"
 
 [[package]]
 name = "gora-cli"
-version = "0.1.2"
+version = "0.1.3"
 source = { editable = "." }