opencode-sesh 0.1.6 → 0.1.7

package/CHANGELOG.md

@@ -7,6 +7,28 @@ 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
@@ -119,7 +141,8 @@ 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.6...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

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

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.6",
+  "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) {
@@ -445,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
@@ -504,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
   })
@@ -676,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})
@@ -700,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)}
@@ -865,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)}
@@ -1032,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)
     })
 
@@ -1167,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()}>