opencode-sesh 0.1.5 → 0.1.7

package/AGENTS.md

@@ -108,6 +108,11 @@ Resume happens in place (`exec` after `cd` to the session's cwd).
   `api.route.navigate("session", …)`. `ctrl+o` and the command palette open it;
   Ctrl-X deletes via the opencode CLI and removes the row only after the server
   confirms the deletion.
+- **Picker search:** pages the global session list (`SESSION_PAGE_LIMIT`, capped
+  at `SESSION_MAX` and reported when truncated) instead of a fixed 500-row
+  window, then indexes transcript text for **every** session in batches
+  (`TRANSCRIPT_BATCH`) with bounded remote concurrency (`REMOTE_CONCURRENCY`).
+  The header shows indexing progress/coverage. `tests/tui.mjs` locks this.
 
 ### Hard-won rules — do not regress
 

package/CHANGELOG.md

@@ -7,6 +7,45 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.1.7] - 2026-09-13
+
+### Fixed
+
+- Sidebar and home session titles are capped to a consistent width so long
+  names no longer run into the timestamp. Removed OpenTUI's `truncate` prop,
+  which middle-truncated the already-shortened titles.
+- The TUI picker no longer re-selects a session when the list scrolls under the
+  cursor, and its preview keeps the current transcript visible while the next
+  one loads instead of blanking on every cursor move.
+
+### Changed
+
+- Sidebar rows use muted `├`/`└` tree glyphs and directory headers get a blank
+  line, so sessions are grouped clearly: a gap between directories, tight rows
+  within one.
+- `npm install` and upgrades refresh an already-installed TUI panel
+  (`install.sh --sync-panel`), and `sesh --check` reports when the installed
+  panel is out of date. Because opencode imports plugins once at startup,
+  install now states that a full quit/reopen is required (a window reload reuses
+  the running process).
+
+## [0.1.6] - 2026-09-13
+
+### Changed
+
+- The TUI picker pages through the entire global session list instead of a
+  fixed 500-session window, indexes transcript text for every session (not just
+  the newest 150) in batches, bounds remote transcript fetching, and shows
+  indexing progress/coverage in the search header.
+- Transcript extraction reads parts in batches and assembles all records in a
+  single `jq` pass. A 250-session cold index dropped from about 28 s to about
+  7 s locally (warm ~0.3 s).
+
+### Added
+
+- TUI data-layer contract tests (pagination, full index coverage, bounded
+  concurrency, progress, and the truncated cap), run on Node 24 in CI.
+
 ## [0.1.5] - 2026-09-13
 
 ### Fixed
@@ -102,7 +141,9 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Fixture-database regression suite, TypeScript typechecking, and ShellCheck in
   CI.
 
-[Unreleased]: https://github.com/ozandogrultan/opencode-sesh/compare/v0.1.5...HEAD
+[Unreleased]: https://github.com/ozandogrultan/opencode-sesh/compare/v0.1.7...HEAD
+[0.1.7]: https://github.com/ozandogrultan/opencode-sesh/compare/v0.1.6...v0.1.7
+[0.1.6]: https://github.com/ozandogrultan/opencode-sesh/compare/v0.1.5...v0.1.6
 [0.1.5]: https://github.com/ozandogrultan/opencode-sesh/compare/v0.1.4...v0.1.5
 [0.1.4]: https://github.com/ozandogrultan/opencode-sesh/compare/v0.1.3...v0.1.4
 [0.1.3]: https://github.com/ozandogrultan/opencode-sesh/compare/v0.1.2...v0.1.3

package/README.md

@@ -68,7 +68,12 @@ file it would overwrite is backed up first.
 The npm package ships the same scripts and installer; the runtime tools below
 are still required.
 
-Restart opencode to load the panel, then:
+Fully quit opencode and reopen it to load the panel — opencode imports plugins
+once at startup, so reloading a window reuses the running process. Upgrades
+refresh an already-installed panel automatically (the npm `postinstall` syncs
+it), and `sesh --check` reports when the installed panel is out of date.
+
+Then:
 
 ```bash
 sesh              # terminal picker
@@ -137,6 +142,11 @@ read -r id cwd < <(sesh --print --query "auth")
 Click the sidebar's `search…` box to filter recent sessions in place; click
 elsewhere or press Esc to leave search.
 
+The full picker pages through your whole global session list (no fixed window)
+and indexes transcript text for every session in the background, showing
+indexing progress under the search box. It only stops at a safety cap of 5,000
+sessions, and says so when it does.
+
 ## Configuration
 
 All variables are optional.

package/bin/sesh-list.sh

@@ -260,53 +260,71 @@ refresh() {
   "$JQ_BIN" -c '.stale[]?' "$cache_state" > "$needs_extract"
   while IFS= read -r cache; do [ -n "$cache" ] && rm -f "$cache"; done < <("$JQ_BIN" -r '.prune[]?' "$cache_state")
 
-  local sid dir title created updated partCount partMax raw_file text_file record cache
-  local extract_failed=0
+  local stale_ids=() sid chunk j i
   while IFS= read -r row; do
     [ -n "$row" ] || continue
     sid=$(printf '%s' "$row" | "$JQ_BIN" -r '.id')
     valid_session_id "$sid" || continue
-    dir=$(printf '%s' "$row" | "$JQ_BIN" -r '.directory // ""')
-    title=$(printf '%s' "$row" | "$JQ_BIN" -r '.title // ""')
-    created=$(printf '%s' "$row" | "$JQ_BIN" -r '.time_created // 0')
-    updated=$(printf '%s' "$row" | "$JQ_BIN" -r '.time_updated // 0')
-    partCount=$(printf '%s' "$row" | "$JQ_BIN" -r '.partCount // 0')
-    partMax=$(printf '%s' "$row" | "$JQ_BIN" -r '.partMax // 0')
-    cache="$EXTRACTIONS/$sid.json"
-    raw_file="$scratch/$sid.parts.json"
-    text_file="$scratch/$sid.text"
-    # Text parts only: reasoning blobs and tool payloads would bloat the search
-    # index. The transcript travels through files, never argv, so a large
-    # conversation cannot hit ARG_MAX; a failure leaves the session uncached so
-    # the next refresh retries instead of certifying it fresh.
-    if db_json "SELECT data FROM part WHERE session_id = '$sid' AND json_extract(data, '\$.type') = 'text' ORDER BY time_created;" > "$raw_file" 2>/dev/null \
-      && "$JQ_BIN" -r '[.[]? | (.data? // empty) | (try fromjson catch empty) | select(type == "object" and .type == "text") | .text // empty] | join(" ")' "$raw_file" > "$text_file" 2>/dev/null; then
-      :
-    else
+    stale_ids+=("$sid")
+  done < "$needs_extract"
+
+  # Batch the transcript read: one SQL query per chunk of sessions and a single
+  # jq pass to assemble every record, instead of a query plus three jq processes
+  # per session. Text still travels through files, never argv. Any failure leaves
+  # every stale session uncached, so the next refresh retries them.
+  local extract_failed=0 parts_raw="$scratch/parts.jsonl" records="$scratch/records.jsonl"
+  : > "$parts_raw"
+  j=0
+  while [ "$j" -lt "${#stale_ids[@]}" ]; do
+    chunk=''
+    for ((i = j; i < j + 200 && i < ${#stale_ids[@]}; i++)); do
+      chunk="${chunk:+$chunk,}'${stale_ids[$i]}'"
+    done
+    if ! db_json "SELECT session_id, data FROM part WHERE session_id IN ($chunk) AND json_extract(data, '\$.type') = 'text' ORDER BY session_id, time_created;" 2>/dev/null \
+      | "$JQ_BIN" -c '.[]?' >> "$parts_raw"; then
       extract_failed=1
-      continue
-    fi
-    if [ -z "$title" ]; then
-      title=$("$JQ_BIN" -Rrs 'gsub("[\r\n]+"; " ") | if length > 70 then .[0:67] + "..." else . end | select(length > 0) // "(untitled)"' "$text_file" 2>/dev/null) || title='(untitled)'
-      [ -n "$title" ] || title='(untitled)'
+      break
     fi
-    record=$("$JQ_BIN" -cn --arg sid "$sid" --arg cwd "$dir" --arg title "$title" \
-      --argjson created "$created" --argjson updated "$updated" --argjson parts "$partCount" --argjson maxpart "$partMax" \
-      --rawfile text "$text_file" '
-      {cacheSchema: 2, cacheSession: $sid, cacheUpdated: $updated, cacheParts: $parts, cacheMax: $maxpart,
-       sessionId: $sid, transcriptPath: "", source: "opencode",
-       cwd: $cwd, title: ($title | gsub("[\r\n]+"; " ") | if length > 70 then .[0:67] + "..." else . end),
-       updatedEpoch: (($updated / 1000 | floor) | if . > 0 then . else ($created / 1000 | floor) end),
-       fulltextLower: (($title + " " + $text) | sub("\n$"; "") | ascii_downcase)}') || record=''
-    if [ -n "$record" ]; then
+    j=$((j + 200))
+  done
+
+  if [ "$extract_failed" = 0 ]; then
+    "$JQ_BIN" -cnr --arg extractions "$EXTRACTIONS" --slurpfile stale "$needs_extract" --slurpfile parts "$parts_raw" '
+      ($parts
+       | map({sid: .session_id,
+              text: ((.data | try fromjson catch null)
+                     | if type == "object" and .type == "text" and (.text | type) == "string" then .text else empty end)})
+       | group_by(.sid)
+       | map({key: .[0].sid, value: ([.[].text] | join(" "))})
+       | from_entries) as $bySid
+      | $stale[]
+      | select((.id | type) == "string" and (.id | test("^ses_[A-Za-z0-9]+$")))
+      | . as $s
+      | ($bySid[$s.id] // "") as $text
+      | (if ($s.title // "") == ""
+         then (($text | gsub("[\r\n]+"; " ") | if length > 70 then .[0:67] + "..." else . end) | select(length > 0) // "(untitled)")
+         else $s.title end) as $title
+      | {sessionId: $s.id,
+         cachePath: ($extractions + "/" + $s.id + ".json"),
+         record: {cacheSchema: 2, cacheSession: $s.id,
+                  cacheUpdated: ($s.time_updated // 0), cacheParts: ($s.partCount // 0), cacheMax: ($s.partMax // 0),
+                  sessionId: $s.id, transcriptPath: "", source: "opencode",
+                  cwd: ($s.directory // ""),
+                  title: ($title | gsub("[\r\n]+"; " ") | if length > 70 then .[0:67] + "..." else . end),
+                  updatedEpoch: ((($s.time_updated // 0) / 1000 | floor) | if . > 0 then . else ((($s.time_created // 0) / 1000) | floor) end),
+                  fulltextLower: (($title + " " + $text) | ascii_downcase)}}
+      | "\(.sessionId)\n\(.cachePath)\n\(.record | tojson)"' > "$records" || extract_failed=1
+  fi
+
+  if [ "$extract_failed" = 0 ]; then
+    while IFS= read -r sid && IFS= read -r cache_path && IFS= read -r record; do
+      [ -n "$sid" ] || continue
       cache_tmp=$(mktemp "$EXTRACTIONS/$sid.json.XXXXXX")
       printf '%s\n' "$record" > "$cache_tmp"
-      mv "$cache_tmp" "$cache"
+      mv "$cache_tmp" "$cache_path"
       printf '%s\n' "$record" >> "$historical"
-    else
-      extract_failed=1
-    fi
-  done < "$needs_extract"
+    done < "$records"
+  fi
 
   if ! "$JQ_BIN" -c --slurpfile hist "$historical" --arg scope "$SCOPE_CWD" --argjson limit "$LIMIT" --argjson archived "$INCLUDE_ARCHIVED" '
     .meta as $meta

package/bin/sesh.sh

@@ -38,6 +38,18 @@ fi
 if [ "${1:-}" = --check ]; then
   "$SESH_JQ" -en '"2026-01-01T00:00:00Z" | fromdateiso8601 | type == "number"' >/dev/null || { echo 'jq capability check failed' >&2; exit 1; }
   command -v sqlite3 >/dev/null 2>&1 || command -v "$OPENCODE_BIN" >/dev/null 2>&1 || { echo 'neither sqlite3 nor opencode is available' >&2; exit 1; }
+  # The TUI panel is a copied file that opencode imports once at startup. Report
+  # when the installed copy has fallen behind this package so upgrades are not
+  # silently stale.
+  panel_bundled="$SCRIPT_DIR/../tui/sesh-panel.tsx"
+  panel_installed="${XDG_CONFIG_HOME:-$HOME/.config}/opencode/plugins/sesh-panel.tsx"
+  if [ -f "$panel_installed" ] && [ -f "$panel_bundled" ]; then
+    if cmp -s "$panel_bundled" "$panel_installed"; then
+      echo 'sesh: sidebar panel is current'
+    else
+      echo 'sesh: sidebar panel is out of date; run `sesh install`, then fully quit and reopen opencode' >&2
+    fi
+  fi
   echo 'sesh: dependencies ready'
   exit 0
 fi

package/install.sh

@@ -19,6 +19,7 @@ BIN_DIR="${XDG_BIN_HOME:-$HOME/.local/bin}"
 INSTALL_TOOL=1
 INSTALL_TUI=1
 UNINSTALL=0
+SYNC_PANEL=0
 
 # Fallback plugin version for when the opencode CLI is unavailable; the
 # installer prefers the local opencode version so the panel matches its SDK.
@@ -43,6 +44,7 @@ Usage: bash install.sh [--bin-dir DIR] [--no-tool] [--no-tui] [--uninstall]
   --no-tool      Skip installing the sesh-list custom tool.
   --no-tui       Skip installing the in-TUI sessions panel plugin.
   --uninstall    Remove everything this script installed.
+  --sync-panel   Refresh an already-installed TUI panel only (used by postinstall).
   --help         Show this help.
 USAGE
 }
@@ -53,6 +55,7 @@ while [ "$#" -gt 0 ]; do
     --no-tool) INSTALL_TOOL=0; shift ;;
     --no-tui) INSTALL_TUI=0; shift ;;
     --uninstall) UNINSTALL=1; shift ;;
+    --sync-panel) SYNC_PANEL=1; shift ;;
     --help) usage; exit 0 ;;
     *) fail "unknown option: $1" ;;
   esac
@@ -110,62 +113,6 @@ launcher_is_ours() {
   [ -f "$target" ] && grep -qF 'Pick an opencode session' "$target" 2>/dev/null
 }
 
-if [ "$UNINSTALL" = 1 ]; then
-  if [ -L "$LAUNCHER" ]; then
-    if launcher_is_ours "$LAUNCHER"; then
-      rm -f "$LAUNCHER" && note "removed $LAUNCHER"
-    else
-      note "left $LAUNCHER untouched (not a sesh launcher: $(readlink "$LAUNCHER" 2>/dev/null))"
-    fi
-  fi
-  remove_if_marker "$COMMAND_DST" "rich interactive picker" && note "removed $COMMAND_DST"
-  remove_if_marker "$TOOL_DST" "list opencode sessions for the agent" && note "removed $TOOL_DST"
-  remove_if_marker "$PANEL_DST" "@jsxImportSource @opentui/solid" && note "removed $PANEL_DST"
-  remove_tui_entry && note "unregistered the panel from $TUI_JSON"
-  note "uninstalled (extraction cache and plugin dependencies left intact)"
-  exit 0
-fi
-
-for path in \
-  bin/sesh \
-  bin/sesh.sh \
-  bin/sesh-list.sh \
-  bin/sesh-preview.sh \
-  bin/sesh-delete.sh \
-  bin/sesh-refresh-worker.sh \
-  bin/sesh-shortcuts.sh \
-  opencode/tools/sesh-list.ts \
-  tui/sesh-panel.tsx \
-  themes/glow-dark-clean.json; do
-  [ -f "$SOURCE_DIR/$path" ] || fail "installer bundle is incomplete: missing $path."
-done
-
-for tool in bash jq fzf; do
-  command -v "$tool" >/dev/null 2>&1 || fail "required tool '$tool' is unavailable."
-done
-fzf_version=$(fzf --version 2>/dev/null || true)
-if [[ "$fzf_version" =~ ^([0-9]+)\.([0-9]+)(\.([0-9]+))? ]]; then
-  if [ "$((10#${BASH_REMATCH[1]}))" -eq 0 ] && [ "$((10#${BASH_REMATCH[2]}))" -lt 73 ]; then
-    fail "fzf >= 0.73.0 is required (found $fzf_version)."
-  fi
-else
-  fail "cannot parse fzf version from: $fzf_version."
-fi
-command -v sqlite3 >/dev/null 2>&1 || command -v opencode >/dev/null 2>&1 \
-  || fail "either sqlite3 or the opencode CLI is required."
-command -v opencode >/dev/null 2>&1 || note "opencode CLI not found: listing and previews work via sqlite3, but resume and delete need opencode."
-
-umask 077
-mkdir -p "$BIN_DIR"
-if [ -e "$LAUNCHER" ] && [ ! -L "$LAUNCHER" ]; then
-  fail "$LAUNCHER already exists and is not a symlink. Move it aside, then retry."
-fi
-if [ -L "$LAUNCHER" ] && ! launcher_is_ours "$LAUNCHER"; then
-  fail "$LAUNCHER is a symlink to $(readlink "$LAUNCHER" 2>/dev/null), which is not a sesh install. Move it aside, then retry."
-fi
-ln -sfn "$SOURCE_DIR/bin/sesh" "$LAUNCHER"
-note "linked $LAUNCHER -> $SOURCE_DIR/bin/sesh"
-
 install_file() {
   local src=$1 dst=$2
   mkdir -p "$(dirname "$dst")"
@@ -181,26 +128,20 @@ install_file() {
   note "installed $dst"
 }
 
-# Earlier versions shipped a markdown `/sesh` command that could only prompt the
-# agent; the TUI plugin now registers the slash itself. Drop the old file so the
-# two do not collide.
-remove_if_marker "$COMMAND_DST" "rich interactive picker" && note "removed obsolete markdown command $COMMAND_DST"
-[ "$INSTALL_TOOL" = 1 ] && install_file "$SOURCE_DIR/opencode/tools/sesh-list.ts" "$TOOL_DST"
-
-opencode_version=''
-if command -v opencode >/dev/null 2>&1; then
-  raw_version=$(opencode --version 2>/dev/null || true)
-  if [[ "$raw_version" =~ ([0-9]+\.[0-9]+\.[0-9]+) ]]; then opencode_version="${BASH_REMATCH[1]}"; fi
-fi
-plugin_version="${opencode_version:-$PLUGIN_VERSION_FALLBACK}"
-
-if [ "$INSTALL_TUI" = 1 ]; then
+install_tui_panel() {
   install_file "$SOURCE_DIR/tui/sesh-panel.tsx" "$PANEL_DST"
 
-  # opencode has no persistent-sidebar API: the panel is an xlarge modal
-  # dialog (see tui/sesh-panel.tsx). Register it idempotently and drop the
-  # previous filename if an older install left it behind.
-  tui_created=0
+  local opencode_version='' raw_version='' plugin_version=''
+  if command -v opencode >/dev/null 2>&1; then
+    raw_version=$(opencode --version 2>/dev/null || true)
+    if [[ "$raw_version" =~ ([0-9]+\.[0-9]+\.[0-9]+) ]]; then opencode_version="${BASH_REMATCH[1]}"; fi
+  fi
+  plugin_version="${opencode_version:-$PLUGIN_VERSION_FALLBACK}"
+
+  # opencode has no persistent-sidebar API: the panel is an xlarge modal dialog
+  # (see tui/sesh-panel.tsx). Register it idempotently and drop the previous
+  # filename if an older install left it behind.
+  local tui_created=0 tui_tmp=''
   if [ ! -f "$TUI_JSON" ]; then
     printf '{\n  "$schema": "https://opencode.ai/tui.json",\n  "plugin": []\n}\n' > "$TUI_JSON"
     tui_created=1
@@ -228,7 +169,7 @@ if [ "$INSTALL_TUI" = 1 ]; then
   # Local plugins resolve their imports from the config directory, and opencode
   # runs `bun install` there at startup. Keep the required packages declared
   # without clobbering versions the user already pinned.
-  pkg_created=0
+  local pkg_created=0 pkg_tmp=''
   if [ ! -f "$PACKAGE_JSON" ]; then
     printf '{\n  "dependencies": {}\n}\n' > "$PACKAGE_JSON"
     pkg_created=1
@@ -257,12 +198,104 @@ if [ "$INSTALL_TUI" = 1 ]; then
     rm -f "$pkg_tmp"
     note "warning: could not update $PACKAGE_JSON; the TUI panel may fail to load"
   fi
+}
+
+# opencode imports plugins once at startup and has no hot reload, so a running
+# instance keeps the old panel until it is fully quit (reloading a window reuses
+# the same process). Say so explicitly and name the processes still holding it.
+note_restart() {
+  note "restart opencode to load the updated panel: quit it completely"
+  note "  (all windows and background processes), then reopen."
+  if command -v pgrep >/dev/null 2>&1; then
+    local pids
+    pids=$(pgrep -x opencode 2>/dev/null | tr '\n' ' ' | sed 's/ $//' || true)
+    [ -n "$pids" ] && note "  still running: opencode PID(s) $pids"
+  fi
+  return 0
+}
+
+if [ "$UNINSTALL" = 1 ]; then
+  if [ -L "$LAUNCHER" ]; then
+    if launcher_is_ours "$LAUNCHER"; then
+      rm -f "$LAUNCHER" && note "removed $LAUNCHER"
+    else
+      note "left $LAUNCHER untouched (not a sesh launcher: $(readlink "$LAUNCHER" 2>/dev/null))"
+    fi
+  fi
+  remove_if_marker "$COMMAND_DST" "rich interactive picker" && note "removed $COMMAND_DST"
+  remove_if_marker "$TOOL_DST" "list opencode sessions for the agent" && note "removed $TOOL_DST"
+  remove_if_marker "$PANEL_DST" "@jsxImportSource @opentui/solid" && note "removed $PANEL_DST"
+  remove_tui_entry && note "unregistered the panel from $TUI_JSON"
+  note "uninstalled (extraction cache and plugin dependencies left intact)"
+  exit 0
+fi
+
+for path in \
+  bin/sesh \
+  bin/sesh.sh \
+  bin/sesh-list.sh \
+  bin/sesh-preview.sh \
+  bin/sesh-delete.sh \
+  bin/sesh-refresh-worker.sh \
+  bin/sesh-shortcuts.sh \
+  opencode/tools/sesh-list.ts \
+  tui/sesh-panel.tsx \
+  themes/glow-dark-clean.json; do
+  [ -f "$SOURCE_DIR/$path" ] || fail "installer bundle is incomplete: missing $path."
+done
+
+if [ "$SYNC_PANEL" = 1 ]; then
+  # Postinstall path: refresh a panel the user already opted into, without
+  # touching the launcher or requiring fzf/sqlite. No-op when the panel is
+  # absent, so `npm install` never adds a TUI panel on its own.
+  [ -f "$PANEL_DST" ] || { note "sesh sidebar panel is not installed; nothing to sync."; exit 0; }
+  umask 077
+  install_tui_panel
+  note_restart
+  exit 0
+fi
+
+for tool in bash jq fzf; do
+  command -v "$tool" >/dev/null 2>&1 || fail "required tool '$tool' is unavailable."
+done
+fzf_version=$(fzf --version 2>/dev/null || true)
+if [[ "$fzf_version" =~ ^([0-9]+)\.([0-9]+)(\.([0-9]+))? ]]; then
+  if [ "$((10#${BASH_REMATCH[1]}))" -eq 0 ] && [ "$((10#${BASH_REMATCH[2]}))" -lt 73 ]; then
+    fail "fzf >= 0.73.0 is required (found $fzf_version)."
+  fi
+else
+  fail "cannot parse fzf version from: $fzf_version."
+fi
+command -v sqlite3 >/dev/null 2>&1 || command -v opencode >/dev/null 2>&1 \
+  || fail "either sqlite3 or the opencode CLI is required."
+command -v opencode >/dev/null 2>&1 || note "opencode CLI not found: listing and previews work via sqlite3, but resume and delete need opencode."
+
+umask 077
+mkdir -p "$BIN_DIR"
+if [ -e "$LAUNCHER" ] && [ ! -L "$LAUNCHER" ]; then
+  fail "$LAUNCHER already exists and is not a symlink. Move it aside, then retry."
+fi
+if [ -L "$LAUNCHER" ] && ! launcher_is_ours "$LAUNCHER"; then
+  fail "$LAUNCHER is a symlink to $(readlink "$LAUNCHER" 2>/dev/null), which is not a sesh install. Move it aside, then retry."
+fi
+ln -sfn "$SOURCE_DIR/bin/sesh" "$LAUNCHER"
+note "linked $LAUNCHER -> $SOURCE_DIR/bin/sesh"
+
+# Earlier versions shipped a markdown `/sesh` command that could only prompt the
+# agent; the TUI plugin now registers the slash itself. Drop the old file so the
+# two do not collide.
+remove_if_marker "$COMMAND_DST" "rich interactive picker" && note "removed obsolete markdown command $COMMAND_DST"
+[ "$INSTALL_TOOL" = 1 ] && install_file "$SOURCE_DIR/opencode/tools/sesh-list.ts" "$TOOL_DST"
+
+if [ "$INSTALL_TUI" = 1 ]; then
+  install_tui_panel
 fi
 
 "$LAUNCHER" --check || fail "post-install check failed."
 note "done"
 note "  picker:  run 'sesh' in any terminal, or '/sesh' inside opencode"
-note "  sidebar: restart opencode to load the panel (ctrl+o opens the full picker)"
+note "  sidebar: ctrl+o opens the full picker"
+note_restart
 case ":$PATH:" in
   *":$BIN_DIR:"*) ;;
   *) note "  note: $BIN_DIR is not on PATH; add it to use the launcher anywhere." ;;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencode-sesh",
-  "version": "0.1.5",
+  "version": "0.1.7",
   "type": "module",
   "description": "Browse, search, preview and resume opencode sessions from the terminal and the TUI.",
   "license": "MIT",
@@ -41,6 +41,7 @@
   },
   "scripts": {
     "prepare": "husky",
+    "postinstall": "bash install.sh --sync-panel || true",
     "test": "bash tests/sesh.sh",
     "test:picker": "python3 tests/picker.py",
     "typecheck": "tsc -p tsconfig.json",

package/tui/sesh-panel.tsx

@@ -130,6 +130,13 @@ function truncate(text: string, width: number): string {
   return text.slice(0, width - 1) + "…"
 }
 
+// Sidebar and home rows should read at a similar length. The sidebar title
+// column is ~2 chars narrower than the group column (status dot + timestamp),
+// so cap it a bit lower to guarantee separation.
+const SIDEBAR_TITLE_WIDTH = 27
+const SIDEBAR_GROUP_WIDTH = 30
+const HOME_TITLE_WIDTH = 30
+
 const SEARCH_KEYS = "abcdefghijklmnopqrstuvwxyz0123456789-_.@/+".split("")
 
 function searchBindings(append: (input: string) => void, exit: () => void) {
@@ -159,20 +166,47 @@ function ensureRootMouse(renderer: TuiPluginApi["renderer"]) {
 }
 
 type Entry = { id: string; title: string; dir: string; group: string; updated: number }
+type EntryResult = { entries: Entry[]; truncated: boolean }
+
+const SESSION_PAGE_LIMIT = 200
+const SESSION_MAX = 5000
 
-async function fetchEntries(api: TuiPluginApi): Promise<Entry[]> {
+async function fetchEntries(api: TuiPluginApi): Promise<EntryResult> {
   const home = process.env.HOME ?? ""
-  const [sessionResult, projectResult] = await Promise.all([
-    api.client.experimental.session.list({ limit: 500, roots: true, directory: "" }),
-    api.client.project.list({}),
-  ])
-  const sessions = ((sessionResult?.data ?? sessionResult) as Session[]) ?? []
+  const projectResult = await api.client.project.list({})
   const projects = ((projectResult?.data ?? projectResult) as Project[]) ?? []
-  if (!Array.isArray(sessions)) return []
   const projectName = new Map<string, string>(
     projects.map((p) => [p.id, p.name?.trim() || shortDir(p.worktree ?? "", home)]),
   )
-  return sessions
+  const sessions: Session[] = []
+  let cursor: number | undefined
+  let truncated = false
+  // Page through the global list instead of one fixed window, so sessions in
+  // older directories stay searchable. `cursor` is the previous page's oldest
+  // `time.updated`; a repeated or missing cursor stops the walk.
+  for (;;) {
+    const result = await api.client.experimental.session.list({
+      limit: SESSION_PAGE_LIMIT,
+      roots: true,
+      directory: "",
+      ...(cursor === undefined ? {} : { cursor }),
+    })
+    const page = ((result?.data ?? result) as Session[]) ?? []
+    if (!Array.isArray(page) || page.length === 0) break
+    sessions.push(...page)
+    if (page.length < SESSION_PAGE_LIMIT) break
+    if (sessions.length >= SESSION_MAX) {
+      truncated = true
+      break
+    }
+    const next = page[page.length - 1]?.time?.updated
+    if (typeof next !== "number" || next === cursor) {
+      truncated = true
+      break
+    }
+    cursor = next
+  }
+  const entries = sessions
     .filter((s) => !s.time?.archived && !s.parentID)
     .sort((a, b) => b.time.updated - a.time.updated)
     .map((s) => {
@@ -187,76 +221,118 @@ async function fetchEntries(api: TuiPluginApi): Promise<Entry[]> {
         updated: s.time.updated,
       }
     })
+  return { entries, truncated }
 }
 
-const TRANSCRIPT_INDEX_LIMIT = 150
 const SESSION_ID_PATTERN = /^ses_[A-Za-z0-9]+$/
+const TRANSCRIPT_BATCH = 64
+const REMOTE_CONCURRENCY = 8
 
-async function buildSearchIndex(api: TuiPluginApi, entries: Entry[]): Promise<Map<string, string>> {
-  const index = new Map<string, string>()
-  const targets = entries.slice(0, TRANSCRIPT_INDEX_LIMIT)
-  for (const entry of targets) {
-    index.set(entry.id, `${entry.title.toLowerCase()} ${entry.dir.toLowerCase()}`)
-  }
-  const ids = targets.map((entry) => entry.id).filter((id) => SESSION_ID_PATTERN.test(id))
-  if (ids.length === 0) return index
+type IndexProgress = { indexed: number; total: number; complete: boolean }
+
+const nextTick = () => new Promise<void>((resolve) => setTimeout(resolve, 0))
+
+async function openTranscriptDb(): Promise<any | undefined> {
   try {
     const home = process.env.HOME ?? ""
     const dataHome = process.env.XDG_DATA_HOME ?? `${home}/.local/share`
     // @ts-ignore - bun:sqlite ships with the Bun runtime (verified); no type package installed
     const sqlite: any = await import("bun:sqlite")
-    if (typeof sqlite?.Database !== "function") throw new Error("bun:sqlite unavailable")
-    const db = new sqlite.Database(`${dataHome}/opencode/opencode.db`, { readonly: true })
+    if (typeof sqlite?.Database !== "function") return undefined
+    return new sqlite.Database(`${dataHome}/opencode/opencode.db`, { readonly: true })
+  } catch {
+    return undefined
+  }
+}
+
+function addTranscript(index: Map<string, string>, sid: string, data: string): void {
+  try {
+    const part = JSON.parse(data) as { type?: unknown; text?: unknown }
+    if (part?.type !== "text" || typeof part.text !== "string") return
+    const base = index.get(sid) ?? ""
+    index.set(sid, `${base} ${part.text.toLowerCase()}`.trim())
+  } catch {
+    // ignore malformed parts
+  }
+}
+
+// Index titles/directories immediately, then add transcript text progressively
+// in batches so the render thread can breathe. Covers every entry, not a fixed
+// newest window; `onProgress` lets the picker show coverage.
+async function buildSearchIndex(
+  api: TuiPluginApi,
+  entries: Entry[],
+  onProgress?: (progress: IndexProgress) => void,
+): Promise<Map<string, string>> {
+  const index = new Map<string, string>()
+  for (const entry of entries) {
+    index.set(entry.id, `${entry.title.toLowerCase()} ${entry.dir.toLowerCase()}`)
+  }
+  const ids = entries.map((entry) => entry.id).filter((id) => SESSION_ID_PATTERN.test(id))
+  const remaining = new Set(ids)
+  const total = ids.length
+  let indexed = 0
+  const report = (complete: boolean) => onProgress?.({ indexed, total, complete })
+  report(false)
+
+  const db = await openTranscriptDb()
+  if (db) {
     try {
-      const placeholders = ids.map(() => "?").join(",")
-      const rows = (db
-        .query(
-          `SELECT session_id AS sid, data FROM part WHERE session_id IN (${placeholders}) AND json_extract(data, '$.type') = 'text' ORDER BY time_created`,
-        )
-        .all(...ids) ?? []) as { sid: string; data: string }[]
-      const byId = new Map<string, string[]>()
-      for (const row of rows) {
-        try {
-          const part = JSON.parse(row.data) as { type?: unknown; text?: unknown }
-          if (part?.type === "text" && typeof part.text === "string") {
-            const list = byId.get(row.sid) ?? []
-            list.push(part.text)
-            byId.set(row.sid, list)
-          }
-        } catch {}
-      }
-      for (const entry of targets) {
-        const text = (byId.get(entry.id) ?? []).join(" ").toLowerCase()
-        if (text) index.set(entry.id, `${index.get(entry.id)} ${text}`)
+      for (let i = 0; i < ids.length; i += TRANSCRIPT_BATCH) {
+        const batch = ids.slice(i, i + TRANSCRIPT_BATCH)
+        const placeholders = batch.map(() => "?").join(",")
+        const rows = (db
+          .query(
+            `SELECT session_id AS sid, data FROM part WHERE session_id IN (${placeholders}) AND json_extract(data, '$.type') = 'text' ORDER BY time_created`,
+          )
+          .all(...batch) ?? []) as { sid: string; data: string }[]
+        for (const row of rows) addTranscript(index, row.sid, row.data)
+        for (const id of batch) remaining.delete(id)
+        indexed += batch.length
+        report(false)
+        await nextTick()
       }
+    } catch {
+      // local store unavailable mid-walk; fall back to the remote path below
     } finally {
       db.close()
     }
-  } catch {
-    await buildSearchIndexRemote(api, targets, index)
   }
+
+  if (remaining.size > 0) {
+    await buildSearchIndexRemote(api, [...remaining], index, () => {
+      indexed += 1
+      report(false)
+    })
+  }
+  report(true)
   return index
 }
 
 async function buildSearchIndexRemote(
   api: TuiPluginApi,
-  targets: Entry[],
+  ids: string[],
   index: Map<string, string>,
+  onEach: () => void,
 ): Promise<void> {
   const home = process.env.HOME ?? ""
   const cacheDir = process.env.SESH_CACHE_DIR ?? `${home}/.cache/sesh`
-  await Promise.all(
-    targets.map(async (entry) => {
-      const base = index.get(entry.id) ?? ""
-      if (!SESSION_ID_PATTERN.test(entry.id)) return
+  let cursor = 0
+  // Bounded concurrency: a fixed worker pool instead of one request per session.
+  const worker = async () => {
+    for (;;) {
+      const i = cursor++
+      if (i >= ids.length) return
+      const id = ids[i]
+      const base = index.get(id) ?? ""
       try {
-        const raw = await readFile(`${cacheDir}/extractions/${entry.id}.json`, "utf8")
+        const raw = await readFile(`${cacheDir}/extractions/${id}.json`, "utf8")
         const record = JSON.parse(raw) as { fulltextLower?: unknown }
         const fulltext = typeof record?.fulltextLower === "string" ? record.fulltextLower : ""
-        index.set(entry.id, `${base} ${fulltext}`)
+        index.set(id, `${base} ${fulltext}`.trim())
       } catch {
         try {
-          const result = await api.client.session.messages({ sessionID: entry.id })
+          const result = await api.client.session.messages({ sessionID: id })
           const messages = result.data ?? []
           const text = messages
             .flatMap((message) =>
@@ -266,11 +342,13 @@ async function buildSearchIndexRemote(
             )
             .join(" ")
             .toLowerCase()
-          index.set(entry.id, `${base} ${text}`)
+          index.set(id, `${base} ${text}`.trim())
         } catch {}
       }
-    }),
-  )
+      onEach()
+    }
+  }
+  await Promise.all(Array.from({ length: Math.min(REMOTE_CONCURRENCY, ids.length) }, worker))
 }
 
 const TRANSCRIPT_PREVIEW_TURNS = 8
@@ -374,7 +452,7 @@ function createTranscriptPreview(api: TuiPluginApi) {
 
 type TreeRow =
   | { kind: "group"; dir: string; label: string; count: number }
-  | { kind: "item"; entry: Entry }
+  | { kind: "item"; entry: Entry; last: boolean }
 
 function SidebarSessions(props: { api: TuiPluginApi }) {
   const theme = () => props.api.theme.current
@@ -397,7 +475,7 @@ function SidebarSessions(props: { api: TuiPluginApi }) {
     let alive = true
     const load = async () => {
       try {
-        const all = await fetchEntries(props.api)
+        const { entries: all } = await fetchEntries(props.api)
         if (alive) setEntries(all)
       } catch {
         // leave the previous list in place rather than flashing to blank
@@ -433,7 +511,9 @@ function SidebarSessions(props: { api: TuiPluginApi }) {
     for (const group of ordered) {
       rows.push({ kind: "group", dir: group.dir, label: prettyDir(group.dir, home), count: group.list.length })
       if (collapsed()[group.dir]) continue
-      for (const entry of group.list) rows.push({ kind: "item", entry })
+      for (let i = 0; i < group.list.length; i++) {
+        rows.push({ kind: "item", entry: group.list[i], last: i === group.list.length - 1 })
+      }
     }
     return rows
   })
@@ -469,7 +549,7 @@ function SidebarSessions(props: { api: TuiPluginApi }) {
         directory: entry.dir || undefined,
       })
       if (result && "error" in result && result.error) throw result.error
-      const remaining = await fetchEntries(props.api)
+      const { entries: remaining } = await fetchEntries(props.api)
       if (remaining.some((item) => item.id === entry.id)) {
         setEntries(remaining)
         props.api.ui.toast({ message: "Session was not deleted", variant: "error" })
@@ -605,10 +685,10 @@ function SidebarSessions(props: { api: TuiPluginApi }) {
           <For each={tree()}>
           {(row) =>
             row.kind === "group" ? (
-              <box flexDirection="row" onMouseDown={() => toggleGroup(row.dir)}>
+              <box flexDirection="row" paddingTop={1} onMouseDown={() => toggleGroup(row.dir)}>
                 <text flexGrow={1} flexShrink={1} wrapMode="none">
                   <span style={{ fg: theme().textMuted }}>{collapsed()[row.dir] ? "▸ " : "▾ "}</span>
-                  <b>{row.label}</b>
+                  <b>{truncate(row.label, SIDEBAR_GROUP_WIDTH)}</b>
                 </text>
                 <text flexShrink={0} style={{ fg: theme().textMuted }}>
                   {" "}({row.count})
@@ -629,14 +709,16 @@ function SidebarSessions(props: { api: TuiPluginApi }) {
                 onMouseOut={() => setHovered(undefined)}
                 onMouseDown={() => props.api.route.navigate("session", { sessionID: row.entry.id })}
               >
-                <text
-                  flexShrink={0}
-                  style={{ fg: row.entry.id === currentID() ? theme().accent : statusColor(row.entry.id) }}
-                >
-                  {row.entry.id === currentID() ? "●" : "○"}
+                <text flexShrink={0}>
+                  <span style={{ fg: theme().textMuted }}>{row.last ? "└" : "├"}</span>
+                  <span
+                    style={{ fg: row.entry.id === currentID() ? theme().accent : statusColor(row.entry.id) }}
+                  >
+                    {row.entry.id === currentID() ? "●" : "○"}
+                  </span>
                 </text>
                 <text flexGrow={1} flexShrink={1} overflow="hidden" wrapMode="none" style={{ fg: theme().text }}>
-                  {row.entry.title}
+                  {truncate(row.entry.title, SIDEBAR_TITLE_WIDTH)}
                 </text>
                 <text flexShrink={0} style={{ fg: theme().textMuted }}>
                   {ago(row.entry.updated)}
@@ -723,7 +805,7 @@ function HomeSessions(props: { api: TuiPluginApi }) {
     let alive = true
     const load = async () => {
       try {
-        const all = await fetchEntries(props.api)
+        const { entries: all } = await fetchEntries(props.api)
         if (alive) setEntries(all)
       } catch {}
     }
@@ -794,7 +876,7 @@ function HomeSessions(props: { api: TuiPluginApi }) {
                 ○
               </text>
               <text flexGrow={1} flexShrink={1} overflow="hidden" wrapMode="none" style={{ fg: theme().text }}>
-                {truncate(entry.title, 52)}
+                {truncate(entry.title, HOME_TITLE_WIDTH)}
               </text>
               <text flexShrink={0} style={{ fg: theme().textMuted }}>
                 {prettyDir(entry.dir, home)} · {ago(entry.updated)}
@@ -827,13 +909,14 @@ const tui: TuiPlugin = async (api) => {
     if (api.mode.current() !== BASE_MODE) return
     if (api.renderer.currentFocusedEditor === null) return
 
-    let entries: Entry[]
+    let entriesResult: EntryResult
     try {
-      entries = await fetchEntries(api)
+      entriesResult = await fetchEntries(api)
     } catch {
       api.ui.toast({ message: "Could not load sessions", variant: "error" })
       return
     }
+    const entries = entriesResult.entries
     if (entries.length === 0) {
       api.ui.toast({ message: "No sessions found", variant: "warning" })
       return
@@ -844,7 +927,12 @@ const tui: TuiPlugin = async (api) => {
     const [query, setQuery] = createSignal("")
     const [cursor, setCursor] = createSignal(0)
     const [searchIndex, setSearchIndex] = createSignal<Map<string, string>>(new Map())
-    void buildSearchIndex(api, entries).then(setSearchIndex)
+    const [indexProgress, setIndexProgress] = createSignal<IndexProgress>({
+      indexed: 0,
+      total: 0,
+      complete: false,
+    })
+    void buildSearchIndex(api, entries, setIndexProgress).then(setSearchIndex)
     let pickerInput: { value: string; isDestroyed?: boolean } | undefined
 
     type DialogRow = { kind: "group"; label: string; count: number } | { kind: "item"; entry: Entry }
@@ -868,6 +956,22 @@ const tui: TuiPlugin = async (api) => {
 
     const selectableEntries = createMemo(() => matchedGroups().flatMap((g) => g.list))
 
+    // Visible bounding: say how much transcript text search actually covers and
+    // when the metadata walk hit its cap, instead of silently under-reporting.
+    const coverageLabel = createMemo(() => {
+      const progress = indexProgress()
+      const bits: string[] = []
+      if (progress.total > 0) {
+        bits.push(
+          progress.complete
+            ? `transcripts ${progress.total}`
+            : `indexing transcripts ${progress.indexed}/${progress.total}`,
+        )
+      }
+      if (entriesResult.truncated) bits.push(`showing newest ${entries.length}`)
+      return bits.join(" · ")
+    })
+
     createEffect(() => {
       const count = selectableEntries().length
       if (cursor() >= count) setCursor(Math.max(0, count - 1))
@@ -939,7 +1043,8 @@ const tui: TuiPlugin = async (api) => {
         setPreviewText(cached)
         return
       }
-      setPreviewText("")
+      // Keep the previous transcript visible while the next one loads so the
+      // preview does not blink away on every cursor move.
       previewTimer = setTimeout(() => void loadPreview(id), 120)
     })
 
@@ -1041,6 +1146,11 @@ const tui: TuiPlugin = async (api) => {
                 }}
               />
             </box>
+            <Show when={coverageLabel()}>
+              <box paddingTop={1}>
+                <text style={{ fg: api.theme.current.textMuted }}>{coverageLabel()}</text>
+              </box>
+            </Show>
           </box>
           <box
             flexDirection="column"
@@ -1069,10 +1179,6 @@ const tui: TuiPlugin = async (api) => {
                           ? api.theme.current.primary
                           : RGBA.fromInts(0, 0, 0, 0)
                       }
-                      onMouseOver={() => {
-                        const i = selectableEntries().findIndex((entry) => entry.id === row.entry.id)
-                        if (i >= 0 && i !== cursor()) setCursor(i)
-                      }}
                       onMouseDown={() => choose(row.entry)}
                     >
                       <Show when={row.entry.id === currentSessionID()}>