opencode-sesh 1.0.8 → 2.0.0

package/AGENTS.md

@@ -39,12 +39,10 @@ HOME=/tmp/fakehome bash install.sh   # installer smoke test (never touches ~/.co
 - `bin/` — flat; no subdirs. Scripts resolve siblings from their own location.
   Never hardcode install paths. `sesh-waiting.sh` owns the needs-input query
   (shared heuristic with the TUI sidebar copy, marked `NEEDS_INPUT_SQL` in
-  both); `sesh-prune.sh` archives stale sessions; `sesh-costs.sh` sums
-  assistant-message cost per directory; `sesh-retitle.sh` renames placeholder
-  titles. Reads go through `sqlite3 -readonly` (or `opencode db`); the direct
-  `UPDATE`s in `sesh-prune.sh` (archive) and `sesh-retitle.sh` (title) are the
-  only sanctioned writes — neither has a CLI or API endpoint, and hard deletes
-  stay on `opencode session delete`.
+  both); `sesh-prune.sh` deletes stale sessions; `sesh-costs.sh` sums
+  assistant-message cost per directory. Reads go through `sqlite3 -readonly`
+  (required; `opencode db` no longer exists). Sesh never writes the database
+  directly; deletes go through `opencode session delete`.
 - `contrib/` — caller-side integrations (currently cmux). Nothing here may add
   window management to sesh itself.
 - `tui-plugins/sesh-panel/tui.tsx` — SolidJS panel, `/** @jsxImportSource @opentui/solid */`.
@@ -105,19 +103,21 @@ which is a pure snapshot lookup — and prints a progress line to stderr while i
 waits, because fzf has already exited and the terminal is idle. opencode has no
 live-agent API, so `liveState` is always `unknown` and rows render gray unless
 they are archived (opt-in, tagged `· archived`);
-dispatch is always `opencode --session <id>` (`--fork` with Ctrl-F or --fork).
+dispatch is always `opencode --session <id>`; Ctrl-F or `--fork` first creates the
+fork with `opencode api session.fork` (the CLI has no fork flag) and resumes the new id.
 Resume happens in place (`exec` after `cd` to the session's cwd).
 
 ## Conventions
 
 - Default scope is **all** sessions, every directory. `--cwd`/Ctrl-G narrows.
-  Archived sessions and child sessions (fork children, spawned subagents) are
+  Archived sessions and child sessions (spawned subagents) are
   hidden unless `--archived`; metadata and cache pruning still see them.
 - **Text parts only** in search/preview; reasoning and tool payloads are
   excluded (asserted in tests).
 - Validate session ids (`^ses_[A-Za-z0-9]+$`) before SQL interpolation — never
   interpolate unvalidated input. Open SQLite read-only (`sqlite3 -readonly`).
-- Prefer direct `sqlite3` over `opencode db` (startup latency). Never parse
+- Resolve the database as `SESH_DB`, then `$XDG_DATA_HOME/opencode/opencode.db`, then the
+  `db` line of `opencode debug paths`. Never parse
   `sqlite3 -json` in `-R` mode; it pretty-prints — parse as JSON.
 - `jq -R` output stays JSON-quoted: use `-Rr` when a shell variable needs the
   raw string.
@@ -129,7 +129,7 @@ Resume happens in place (`exec` after `cd` to the session's cwd).
 - Destructive actions confirm. `sesh-delete.sh` prompts on a TTY and refuses
   without `--yes` when stdin is not one; the TUI arms on the first Option-D and
   commits on the second (or `y`).
-- The installer prefers the local opencode version for `@opencode-ai/*` and
+- The installer prefers the local opencode version for `@opencode/*` and
   merges (never clobbers) the config `package.json`; opencode runs `bun install`
   at startup.
 - Commit messages follow [Conventional Commits](https://www.conventionalcommits.org/)

package/CHANGELOG.md

@@ -5,6 +5,22 @@ All notable changes to this project are documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [2.0.0] - 2026-10-10
+
+### Breaking changes
+
+- Finish V2 session compatibility and prune semantics _(breaking)_
+
+### Fixed
+
+- **tui:** Align sidebar search with Sessions heading
+
+## [1.1.0] - 2026-10-09
+
+### Fixed
+
+- Align database access, fork and writes with the OpenCode V2 CLI
+
 ## [1.0.8] - 2026-10-08
 
 ### Fixed
@@ -466,6 +482,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.
 
+[2.0.0]: https://github.com/ozandogrultan/opencode-sesh/compare/v1.1.0...v2.0.0
+[1.1.0]: https://github.com/ozandogrultan/opencode-sesh/compare/v1.0.8...v1.1.0
 [1.0.8]: https://github.com/ozandogrultan/opencode-sesh/compare/v1.0.7...v1.0.8
 [1.0.7]: https://github.com/ozandogrultan/opencode-sesh/compare/v1.0.6...v1.0.7
 [1.0.6]: https://github.com/ozandogrultan/opencode-sesh/compare/v1.0.5...v1.0.6

package/README.md

@@ -19,7 +19,7 @@ grouped by directory, full-text searchable, and previewable from anywhere.
 
 ```text
 Sessions (8)                              ▾ hide
-  search…
+search…
 ▾ …/Projects/portal                          (5)
   ├○ Retry the OAuth token refr…            2h
   ├○ Login rate limiting notes              3d
@@ -100,8 +100,7 @@ option+o          # inside opencode — picker
 
 - [opencode](https://opencode.ai), used at least once
 - `bash`, `jq`, and [`fzf`](https://github.com/junegunn/fzf) `>= 0.73`
-- `sqlite3` recommended — the picker queries the session DB directly in
-  milliseconds and falls back to the slower `opencode db` CLI without it
+- `sqlite3` — the picker queries the session DB directly
 - [`glow`](https://github.com/charmbracelet/glow) optional — styles the
   transcript preview as Markdown; without it the preview shows the plain
   Markdown, unchanged otherwise
@@ -138,20 +137,19 @@ Flags: `--cwd` (current directory only), `--limit N` (default: all),
 `--json` (with `--print`, emit JSON), `--query TEXT`, `--check`,
 `--needs-input` (list sessions waiting on you instead of opening the picker).
 
-`sesh prune [--older-than 30d] [--dry-run] [--yes] [--delete]` archives stale
-sessions (not updated within the threshold) so the list stays triageable.
-Pinned sessions, sessions waiting on you, fork children and already-archived
-sessions are never touched; archiving is reversible, while `--delete`
-hard-deletes through `opencode session delete`. Without `--dry-run`, a TTY run
+`sesh prune [--older-than 30d] [--dry-run] [--yes]` deletes stale
+sessions (not updated within the threshold) through `opencode session delete`, including their children.
+Pinned sessions, sessions waiting on you, subagent child sessions and already-archived
+sessions are never selected. Without `--dry-run`, a TTY run
 confirms first and a non-TTY run needs `--yes`.
 
 `sesh costs [--days N] [--json]` sums assistant-message cost per project, with a
 recent window beside the lifetime total, so a day's work reads as a
-per-project record.
+per-project record. Legacy V1 history is included when available; sessions
+already present in V2 are counted only once.
 
-`sesh retitle [--dry-run] [--yes]` replaces auto-generated placeholder titles
-(`New session - …`) with the start of the session's first user message. Only
-placeholder titles are touched, and the same dry-run/`--yes` gating applies.
+Session browsing uses the V2 store. Sessions remaining only in the legacy V1
+tables are not listed or resumable through sesh.
 
 When searching, title matches outrank transcript-only matches and the current
 project rises, so the list answers "where was that thing I worked on" before it
@@ -230,8 +228,8 @@ All variables are optional.
 
 | Variable | Default | Effect |
 | --- | --- | --- |
-| `SESH_DB` | `opencode db path` | opencode SQLite database |
-| `SESH_SQLITE` | `sqlite3` | query tool (`opencode db` is ~300 ms/call) |
+| `SESH_DB` | `${XDG_DATA_HOME:-~/.local/share}/opencode/opencode.db`, falling back to `opencode debug paths` | opencode SQLite database |
+| `SESH_SQLITE` | `sqlite3` | query tool |
 | `SESH_JQ` / `SESH_FZF` | `PATH` | explicit executable overrides |
 | `SESH_GLOW` | first `glow` on `PATH` | optional Markdown preview renderer |
 | `SESH_OPENCODE` | `opencode` | opencode executable (resume / delete) |

package/bin/sesh

@@ -30,9 +30,5 @@ case ${1:-} in
     shift
     exec bash "$SCRIPT_DIR/sesh-costs.sh" "$@"
     ;;
-  retitle)
-    shift
-    exec bash "$SCRIPT_DIR/sesh-retitle.sh" "$@"
-    ;;
 esac
 exec "$SCRIPT_DIR/sesh.sh" "$@"

package/bin/sesh-costs.sh

@@ -29,12 +29,12 @@ case "$days" in ''|*[!0-9]*) echo "--days must be a non-negative integer" >&2; e
 
 resolve_db() {
   if [ -n "${SESH_DB:-}" ]; then printf '%s\n' "$SESH_DB"; return 0; fi
-  local from_cli=''
+  local default="${XDG_DATA_HOME:-$HOME/.local/share}/opencode/opencode.db" from_cli=''
+  if [ -f "$default" ]; then printf '%s\n' "$default"; return 0; fi
   if command -v "$OPENCODE_BIN" >/dev/null 2>&1; then
-    from_cli=$("$OPENCODE_BIN" db path 2>/dev/null || true)
+    from_cli=$("$OPENCODE_BIN" debug paths 2>/dev/null | awk '$1 == "db" { sub(/^db[ \t]+/, ""); print; exit }' || true)
   fi
   if [ -n "$from_cli" ] && [ -f "$from_cli" ]; then printf '%s\n' "$from_cli"; return 0; fi
-  if [ -f "$HOME/.local/share/opencode/opencode.db" ]; then printf '%s\n' "$HOME/.local/share/opencode/opencode.db"; return 0; fi
   return 1
 }
 
@@ -51,27 +51,37 @@ DB_PATH=$(resolve_db) || { echo 'sesh: session database unavailable' >&2; exit 1
 NOW_MS=$(python3 -c 'import time; print(int(time.time() * 1000))' 2>/dev/null || echo "$(( $(date +%s) * 1000 ))")
 CUTOFF=$((NOW_MS - days * 86400000))
 
+[ -n "$SQLITE_BIN" ] || { echo 'sesh: sqlite3 is required' >&2; exit 1; }
+LEGACY_QUERY=''
+if [ "$("$SQLITE_BIN" -readonly "$DB_PATH" "SELECT count(*) FROM sqlite_master WHERE type = 'table' AND name IN ('session', 'message');")" = 2 ]; then
+  LEGACY_QUERY="UNION ALL
+SELECT s.directory, s.id AS session_id, m.time_created, m.data
+FROM message m JOIN session s ON s.id = m.session_id
+WHERE json_extract(m.data, '\$.role') = 'assistant'
+  AND NOT EXISTS (SELECT 1 FROM session_v2 v WHERE v.id = s.id)"
+fi
+
 # One pass over assistant messages; the window filter is a cheap CASE so the
 # lifetime total and the window total come back together.
 ROWS_QUERY="
-SELECT s.directory AS directory,
+WITH costs AS (
+SELECT s.directory, s.id AS session_id, m.time_created, m.data
+FROM session_message m JOIN session_v2 s ON s.id = m.session_id
+WHERE m.type = 'assistant'
+$LEGACY_QUERY
+)
+SELECT m.directory AS directory,
   ROUND(SUM(CASE WHEN m.time_created >= $CUTOFF THEN COALESCE(json_extract(m.data, '\$.cost'), 0) ELSE 0 END), 4) AS window_cost,
   ROUND(SUM(COALESCE(json_extract(m.data, '\$.cost'), 0)), 4) AS lifetime_cost,
-  COUNT(DISTINCT s.id) AS sessions,
+  COUNT(DISTINCT m.session_id) AS sessions,
   SUM(CASE WHEN m.time_created >= $CUTOFF THEN COALESCE(json_extract(m.data, '\$.tokens.input'), 0) + COALESCE(json_extract(m.data, '\$.tokens.output'), 0) ELSE 0 END) AS window_tokens
-FROM session_message m
-JOIN session_v2 s ON s.id = m.session_id
-WHERE m.type = 'assistant'
-  AND json_extract(m.data, '\$.cost') IS NOT NULL
-GROUP BY s.directory
+FROM costs m
+WHERE json_extract(m.data, '\$.cost') IS NOT NULL
+GROUP BY m.directory
 ORDER BY lifetime_cost DESC;"
 
-if [ -n "$SQLITE_BIN" ]; then
-  ROWS=$("$SQLITE_BIN" -json -readonly "$DB_PATH" "$ROWS_QUERY")
-else
-  command -v "$OPENCODE_BIN" >/dev/null 2>&1 || { echo 'sesh: neither sqlite3 nor opencode is available' >&2; exit 1; }
-  ROWS=$("$OPENCODE_BIN" db "$ROWS_QUERY" --format json)
-fi
+[ -n "$SQLITE_BIN" ] || { echo 'sesh: sqlite3 is required' >&2; exit 1; }
+ROWS=$("$SQLITE_BIN" -json -readonly "$DB_PATH" "$ROWS_QUERY")
 [ -n "$ROWS" ] || ROWS='[]'
 
 if [ "$emit_json" = 1 ]; then

package/bin/sesh-list.sh

@@ -76,12 +76,12 @@ GREEN=$'\033[32m'; CYAN=$'\033[36m'; GRAY=$'\033[90m'; MAGENTA=$'\033[35m'; RED=
 
 resolve_db() {
   if [ -n "${SESH_DB:-}" ]; then printf '%s\n' "$SESH_DB"; return 0; fi
-  local from_cli=''
+  local default="${XDG_DATA_HOME:-$HOME/.local/share}/opencode/opencode.db" from_cli=''
+  if [ -f "$default" ]; then printf '%s\n' "$default"; return 0; fi
   if command -v "$OPENCODE_BIN" >/dev/null 2>&1; then
-    from_cli=$("$OPENCODE_BIN" db path 2>/dev/null || true)
+    from_cli=$("$OPENCODE_BIN" debug paths 2>/dev/null | awk '$1 == "db" { sub(/^db[ \t]+/, ""); print; exit }' || true)
   fi
   if [ -n "$from_cli" ] && [ -f "$from_cli" ]; then printf '%s\n' "$from_cli"; return 0; fi
-  if [ -f "$HOME/.local/share/opencode/opencode.db" ]; then printf '%s\n' "$HOME/.local/share/opencode/opencode.db"; return 0; fi
   return 1
 }
 
@@ -92,18 +92,7 @@ elif command -v sqlite3 >/dev/null 2>&1; then
   SQLITE_BIN=sqlite3
 fi
 
-# db_json SQL → JSON array on stdout. Direct sqlite3 is preferred: it answers
-# in milliseconds, while `opencode db` pays a full CLI startup per call and
-# would make every preview keystroke laggy.
-db_json() {
-  if [ -n "$SQLITE_BIN" ]; then
-    # Read-only: sesh never writes the store directly (deletes go through
-    # `opencode session delete`).
-    "$SQLITE_BIN" -json -readonly "$DB_PATH" "$1"
-  else
-    "$OPENCODE_BIN" db "$1" --format json
-  fi
-}
+db_json() { "$SQLITE_BIN" -json -readonly "$DB_PATH" "$1"; }
 
 valid_session_id() { [[ "$1" =~ ^ses_[A-Za-z0-9]+$ ]]; }
 
@@ -258,8 +247,8 @@ refresh() {
     if [ -f "$SNAPSHOT" ]; then set_status 'stale: opencode database is unavailable; showing last good snapshot'; else set_status 'unavailable: opencode database is unavailable'; fi
     return 0
   }
-  if [ -z "$SQLITE_BIN" ] && ! command -v "$OPENCODE_BIN" >/dev/null 2>&1; then
-    if [ -f "$SNAPSHOT" ]; then set_status 'stale: neither sqlite3 nor opencode is available; showing last good snapshot'; else set_status 'unavailable: neither sqlite3 nor opencode is available'; fi
+  if [ -z "$SQLITE_BIN" ]; then
+    if [ -f "$SNAPSHOT" ]; then set_status 'stale: sqlite3 is not available; showing last good snapshot'; else set_status 'unavailable: sqlite3 is not available'; fi
     return 0
   fi
   local scratch sessions parts cache_records cache_state historical needs_extract out
@@ -290,7 +279,7 @@ refresh() {
   db_json "SELECT session_id, COUNT(*) AS n, MAX(time_updated) AS m FROM session_message GROUP BY session_id;" > "$parts" 2>/dev/null || printf '[]\n' > "$parts"
   "$JQ_BIN" -e 'type == "array"' "$parts" >/dev/null 2>&1 || printf '[]\n' > "$parts"
 
-  # Same bulk cache validation as the Claude list: every cache arrives as its
+  # Same bulk cache validation as the full list: every cache arrives as its
   # own file argument (ARG_MAX), records match on session id plus the two
   # change signals, and only vanished sessions are pruned — metadata always
   # covers the whole database, so pruning is safe under any scope or limit.
@@ -389,8 +378,8 @@ refresh() {
     | ($hist | map({key: .sessionId, value: .}) | from_entries) as $histById
     | [$meta[]
        | select((.id | type) == "string" and (.id | test("^ses_[A-Za-z0-9]+$")))
-       # Child sessions (fork children, spawned subagents) surface only with
-       # --archived; metadata still sees them, so cache pruning stays safe.
+       # Child sessions (spawned subagents) surface only with --archived;
+       # metadata still sees them, so cache pruning stays safe.
        | select($archived == 1 or (.archived == 0 and .parent == ""))
        | select($scope == "" or .directory == $scope)
        | . as $m | ($histById[$m.id] // {}) as $h

package/bin/sesh-preview.sh

@@ -14,13 +14,10 @@ JQ_BIN=${SESH_JQ:-jq}
 "$JQ_BIN" -se --arg sid "$session_id" 'any(.sessionId == $sid)' "$snapshot" >/dev/null 2>&1 \
   || { echo "(selected session is no longer in this snapshot)"; exit 0; }
 
-DB_PATH=${SESH_DB:-}
-if [ -z "$DB_PATH" ]; then
-  OPENCODE_BIN=${SESH_OPENCODE:-opencode}
-  if command -v "$OPENCODE_BIN" >/dev/null 2>&1; then
-    DB_PATH=$("$OPENCODE_BIN" db path 2>/dev/null || true)
-  fi
-  [ -n "$DB_PATH" ] || DB_PATH="$HOME/.local/share/opencode/opencode.db"
+OPENCODE_BIN=${SESH_OPENCODE:-opencode}
+DB_PATH=${SESH_DB:-"${XDG_DATA_HOME:-$HOME/.local/share}/opencode/opencode.db"}
+if [ -z "${SESH_DB:-}" ] && [ ! -f "$DB_PATH" ] && command -v "$OPENCODE_BIN" >/dev/null 2>&1; then
+  DB_PATH=$("$OPENCODE_BIN" debug paths 2>/dev/null | awk '$1 == "db" { sub(/^db[ \t]+/, ""); print; exit }' || true)
 fi
 [ -f "$DB_PATH" ] || { echo "(opencode database is unavailable)"; exit 0; }
 
@@ -28,12 +25,8 @@ SQLITE_BIN=${SESH_SQLITE:-}
 if [ -z "$SQLITE_BIN" ] && command -v sqlite3 >/dev/null 2>&1; then SQLITE_BIN=sqlite3; fi
 SQL="SELECT json_object('role', type) AS msg, json_object('type', 'text', 'text', json_extract(data, '\$.text')) AS part, seq, -1 AS ordinal FROM session_message WHERE session_id = '$session_id' AND type = 'user' AND json_type(data, '\$.text') = 'text'
 UNION ALL SELECT json_object('role', m.type) AS msg, c.value AS part, m.seq, CAST(c.key AS INTEGER) AS ordinal FROM session_message m, json_each(m.data, '\$.content') c WHERE m.session_id = '$session_id' AND m.type = 'assistant' AND json_extract(c.value, '\$.type') = 'text' ORDER BY seq DESC, ordinal DESC LIMIT 200;"
-if [ -n "$SQLITE_BIN" ]; then
-  rows=$("$SQLITE_BIN" -json -readonly "$DB_PATH" "$SQL" 2>/dev/null) || rows=''
-else
-  OPENCODE_BIN=${SESH_OPENCODE:-opencode}
-  rows=$("$OPENCODE_BIN" db "$SQL" --format json 2>/dev/null) || rows=''
-fi
+[ -n "$SQLITE_BIN" ] || { echo "(sqlite3 is required for previews)"; exit 0; }
+rows=$("$SQLITE_BIN" -json -readonly "$DB_PATH" "$SQL" 2>/dev/null) || rows=''
 [ -n "$rows" ] || { echo "(no displayable transcript messages)"; exit 0; }
 
 # Text parts only, newest first, with role headers. The 120-block cap is applied

package/bin/sesh-prune.sh

@@ -1,15 +1,9 @@
 #!/usr/bin/env bash
-# Archive (or, with --delete, hard-delete) stale sessions: not updated within
+# Delete stale sessions: not updated within
 # the threshold, never pinned, never waiting on the user, never already
-# archived, never a fork child.
+# archived, never a child (subagent) session.
 #
-# Archive is the default because it is reversible; hard deletes go through
-# `opencode session delete` so its own safeguards apply. The archive itself
-# is a single atomic UPDATE through the same sqlite3-or-`opencode db` read
-# path the list commands use — there is no archive endpoint in the opencode
-# API or CLI, so a direct write is the only route (deletes stay on the CLI).
-#
-# Usage: sesh-prune.sh [--older-than 30d] [--dry-run] [--yes] [--delete]
+# Usage: sesh-prune.sh [--older-than 30d] [--dry-run] [--yes]
 #   --older-than Nd|Nh|Nw (bare N means days; default 30d)
 #   --dry-run lists candidates and changes nothing
 #   without --dry-run, a TTY run confirms first; a non-TTY run needs --yes
@@ -21,15 +15,13 @@ OPENCODE_BIN=${SESH_OPENCODE:-opencode}
 older_than=30d
 dry_run=0
 assume_yes=0
-hard_delete=0
 while [ "$#" -gt 0 ]; do
   case "$1" in
     --older-than) older_than=${2:-}; shift ;;
     --older-than=*) older_than=${1#--older-than=} ;;
     --dry-run) dry_run=1 ;;
     --yes|-y) assume_yes=1 ;;
-    --delete) hard_delete=1 ;;
-    --help) echo "usage: ${0##*/} [--older-than 30d] [--dry-run] [--yes] [--delete]"; exit 0 ;;
+    --help) echo "usage: ${0##*/} [--older-than 30d] [--dry-run] [--yes]"; exit 0 ;;
     *) echo "unknown option: $1" >&2; exit 2 ;;
   esac
   shift
@@ -53,12 +45,12 @@ CUTOFF=$((NOW_MS - threshold_ms))
 
 resolve_db() {
   if [ -n "${SESH_DB:-}" ]; then printf '%s\n' "$SESH_DB"; return 0; fi
-  local from_cli=''
+  local default="${XDG_DATA_HOME:-$HOME/.local/share}/opencode/opencode.db" from_cli=''
+  if [ -f "$default" ]; then printf '%s\n' "$default"; return 0; fi
   if command -v "$OPENCODE_BIN" >/dev/null 2>&1; then
-    from_cli=$("$OPENCODE_BIN" db path 2>/dev/null || true)
+    from_cli=$("$OPENCODE_BIN" debug paths 2>/dev/null | awk '$1 == "db" { sub(/^db[ \t]+/, ""); print; exit }' || true)
   fi
   if [ -n "$from_cli" ] && [ -f "$from_cli" ]; then printf '%s\n' "$from_cli"; return 0; fi
-  if [ -f "$HOME/.local/share/opencode/opencode.db" ]; then printf '%s\n' "$HOME/.local/share/opencode/opencode.db"; return 0; fi
   return 1
 }
 
@@ -72,14 +64,8 @@ fi
 DB_PATH=$(resolve_db) || { echo 'sesh: session database unavailable' >&2; exit 1; }
 [ -f "$DB_PATH" ] || { echo 'sesh: session database unavailable' >&2; exit 1; }
 
-if [ -n "$SQLITE_BIN" ]; then
-  query() { "$SQLITE_BIN" -json -readonly "$DB_PATH" "$1"; }
-  write_db() { "$SQLITE_BIN" "$DB_PATH" "$1"; }
-else
-  command -v "$OPENCODE_BIN" >/dev/null 2>&1 || { echo 'sesh: neither sqlite3 nor opencode is available' >&2; exit 1; }
-  query() { "$OPENCODE_BIN" db "$1" --format json; }
-  write_db() { "$OPENCODE_BIN" db "$1" --format json > /dev/null; }
-fi
+[ -n "$SQLITE_BIN" ] || { echo 'sesh: sqlite3 is required' >&2; exit 1; }
+query() { "$SQLITE_BIN" -json -readonly "$DB_PATH" "$1"; }
 
 JQ_BIN=${SESH_JQ:-$(command -v jq || true)}
 [ -n "$JQ_BIN" ] || { echo 'sesh: jq is required' >&2; exit 1; }
@@ -103,8 +89,7 @@ ELIGIBLE=$(printf '%s' "$CANDIDATES" | "$JQ_BIN" -c --slurpfile _pins <(printf '
     ]
 ')
 COUNT=$(printf '%s' "$ELIGIBLE" | "$JQ_BIN" -r 'length')
-VERB=Archive
-[ "$hard_delete" = 0 ] || VERB=Delete
+VERB=Delete
 
 if [ "$COUNT" = 0 ]; then
   echo "Nothing to prune older than $older_than."
@@ -142,34 +127,17 @@ if [ "$assume_yes" = 0 ]; then
   fi
 fi
 
-if [ "$hard_delete" = 0 ]; then
-  IDS=$(printf '%s' "$ELIGIBLE" | "$JQ_BIN" -r '.[].id')
-  IN_LIST=''
-  for id in $IDS; do
-    case "$id" in
-      ses_[A-Za-z0-9]*) IN_LIST="$IN_LIST'$id'," ;;
-      *) echo "Refusing: unexpected session id shape." >&2; exit 1 ;;
-    esac
-  done
-  IN_LIST=${IN_LIST%,}
-  write_db "UPDATE session_v2 SET time_archived = $NOW_MS WHERE id IN ($IN_LIST);"
-  echo "Archived $COUNT session(s) older than $older_than."
-else
-  command -v "$OPENCODE_BIN" >/dev/null 2>&1 || { echo 'sesh: opencode executable is unavailable for deletes.' >&2; exit 1; }
-  failed=0
-  done_count=0
-  for id in $(printf '%s' "$ELIGIBLE" | "$JQ_BIN" -r '.[].id'); do
-    case "$id" in
-      ses_[A-Za-z0-9]*) ;;
-      *) echo "Refusing: unexpected session id shape." >&2; exit 1 ;;
-    esac
-    if "$OPENCODE_BIN" session delete "$id" >/dev/null 2>&1; then
-      done_count=$((done_count + 1))
-    else
-      echo "Could not delete $id." >&2
-      failed=$((failed + 1))
-    fi
-  done
-  echo "Deleted $done_count session(s) older than $older_than."
-  [ "$failed" = 0 ] || exit 1
-fi
+command -v "$OPENCODE_BIN" >/dev/null 2>&1 || { echo 'sesh: opencode executable is unavailable for deletes.' >&2; exit 1; }
+failed=0
+done_count=0
+for id in $(printf '%s' "$ELIGIBLE" | "$JQ_BIN" -r '.[].id'); do
+  [[ "$id" =~ ^ses_[A-Za-z0-9]+$ ]] || { echo "Refusing: unexpected session id shape." >&2; exit 1; }
+  if "$OPENCODE_BIN" session delete "$id" >/dev/null 2>&1; then
+    done_count=$((done_count + 1))
+  else
+    echo "Could not delete $id." >&2
+    failed=$((failed + 1))
+  fi
+done
+echo "Deleted $done_count session(s) older than $older_than."
+[ "$failed" = 0 ] || exit 1

package/bin/sesh-waiting.sh

@@ -5,11 +5,16 @@
 # owned by a running TUI server, whose in-memory permission/question state
 # is invisible cross-project.
 #
-# A session waits when it is not archived, is not a fork child, and either
-#   - has a `question` tool part that never completed with no later user
-#     message in the same session (awaiting an answer, errored included), or
-#   - has a `tool` part still marked `running` older than STUCK_AFTER_MS
-#     (awaiting approval, or orphaned by a dead server).
+# A session waits when it is not archived, is not a child (subagent) session,
+# and either
+#   - has a `question` tool part still pending or running with no later user
+#     message in the same session (awaiting an answer; a dismissed question
+#     that errored is not waiting), or
+#   - has a `tool` part still marked `running` older than STUCK_AFTER_MS with
+#     no message activity in the session or its direct children since then
+#     (a long-running subagent/shell tool with recent activity is not stuck;
+#     V2 resumes interrupted runs server-side, so `running` with no activity
+#     means orphaned or awaiting approval).
 #
 # Usage: sesh-waiting.sh [--json]
 #   default prints a human table; --json prints [{id,reason,title,directory,updated}]
@@ -30,12 +35,12 @@ done
 
 resolve_db() {
   if [ -n "${SESH_DB:-}" ]; then printf '%s\n' "$SESH_DB"; return 0; fi
-  local from_cli=''
+  local default="${XDG_DATA_HOME:-$HOME/.local/share}/opencode/opencode.db" from_cli=''
+  if [ -f "$default" ]; then printf '%s\n' "$default"; return 0; fi
   if command -v "$OPENCODE_BIN" >/dev/null 2>&1; then
-    from_cli=$("$OPENCODE_BIN" db path 2>/dev/null || true)
+    from_cli=$("$OPENCODE_BIN" debug paths 2>/dev/null | awk '$1 == "db" { sub(/^db[ \t]+/, ""); print; exit }' || true)
   fi
   if [ -n "$from_cli" ] && [ -f "$from_cli" ]; then printf '%s\n' "$from_cli"; return 0; fi
-  if [ -f "$HOME/.local/share/opencode/opencode.db" ]; then printf '%s\n' "$HOME/.local/share/opencode/opencode.db"; return 0; fi
   return 1
 }
 
@@ -82,20 +87,17 @@ WHERE COALESCE(s.time_archived, 0) = 0
       AND NOT EXISTS (
         SELECT 1 FROM session_message u
         WHERE u.session_id = live.session_id AND u.type = 'user' AND u.seq > live.seq)
-  ) OR EXISTS (
+  ) OR (EXISTS (
     SELECT 1 FROM live
-    WHERE live.session_id = s.id AND live.status = 'running' AND live.created < $STUCK_BEFORE))
+    WHERE live.session_id = s.id AND live.status = 'running' AND live.created < $STUCK_BEFORE)
+    AND NOT EXISTS (
+      SELECT 1 FROM session_message r JOIN session_v2 f ON f.id = r.session_id
+      WHERE (f.id = s.id OR f.parent_id = s.id) AND r.time_updated >= $STUCK_BEFORE)))
 ORDER BY s.time_updated DESC;
 SQL
 
-if [ -n "$SQLITE_BIN" ]; then
-  # Read-only: sesh never writes the store on this path (archive writes go
-  # through `opencode db`, hard deletes through `opencode session delete`).
-  ROWS=$("$SQLITE_BIN" -json -readonly "$DB_PATH" "$QUERY")
-else
-  command -v "$OPENCODE_BIN" >/dev/null 2>&1 || { echo 'sesh: neither sqlite3 nor opencode is available' >&2; exit 1; }
-  ROWS=$("$OPENCODE_BIN" db "$QUERY" --format json)
-fi
+[ -n "$SQLITE_BIN" ] || { echo 'sesh: sqlite3 is required' >&2; exit 1; }
+ROWS=$("$SQLITE_BIN" -json -readonly "$DB_PATH" "$QUERY")
 
 # sqlite3 -json prints nothing (not []) when no rows match.
 [ -n "$ROWS" ] || ROWS='[]'

package/bin/sesh.sh

@@ -37,7 +37,7 @@ 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; }
+  command -v "${SESH_SQLITE:-sqlite3}" >/dev/null 2>&1 || { echo 'sqlite3 is not 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.
@@ -203,9 +203,18 @@ fi
 command -v "$OPENCODE_BIN" >/dev/null 2>&1 || { echo 'sesh: opencode executable unavailable' >&2; exit 1; }
 # Resume in place: this terminal becomes the session. No tabs, no panes.
 if [ "$fork" = 1 ]; then
-  ( cd "$cwd" && exec "$OPENCODE_BIN" --session "$session_id" --fork )
-else
-  ( cd "$cwd" && exec "$OPENCODE_BIN" --session "$session_id" )
+  fork_err="$state_dir/fork-err"
+  forked=$(cd "$cwd" && "$OPENCODE_BIN" api session.fork --param "sessionID=$session_id" -d '{}' 2>"$fork_err" | "$SESH_JQ" -r '.data.id // empty' 2>/dev/null || true)
+  if [[ "$forked" =~ ^ses_[A-Za-z0-9]+$ ]]; then
+    session_id=$forked
+    rm -f "$fork_err"
+  else
+    echo 'sesh: could not fork the session; returning to the picker.' >&2
+    [ -s "$fork_err" ] && sed 's/^/sesh: /' "$fork_err" >&2
+    rm -f "$fork_err"
+    continue
+  fi
 fi
+( cd "$cwd" && exec "$OPENCODE_BIN" --session "$session_id" )
 echo 'sesh: opencode exited; returning to the picker.' >&2
 done

package/install.sh

@@ -2,8 +2,9 @@
 # Install sesh for the current user.
 # Terminal- and OS-agnostic: macOS and Linux, any terminal. No administrator
 # privileges, downloads, or shell-rc edits. Runtime requires jq, fzf >= 0.73
-# and sqlite3 or the opencode CLI; the in-TUI panel additionally needs the
-# packages opencode installs for local plugins (handled below).
+# and sqlite3; resuming and deleting need the opencode CLI. The in-TUI panel
+# additionally needs the packages opencode installs for local plugins (handled
+# below).
 set -euo pipefail
 
 fail() { printf 'sesh install: %s\n' "$*" >&2; exit 1; }
@@ -23,7 +24,7 @@ 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.
-PLUGIN_VERSION_FALLBACK="2.0.18"
+PLUGIN_VERSION_FALLBACK="2.0.25"
 # Peer line the panel was developed and typechecked against. A checkout's
 # package.json overrides these, so dependency bumps cannot drift the installed
 # config out of sync (solid-js moves with OpenTUI via @opentui/keymap's peer).
@@ -251,7 +252,6 @@ for path in \
   bin/sesh-delete.sh \
   bin/sesh-prune.sh \
   bin/sesh-refresh-worker.sh \
-  bin/sesh-retitle.sh \
   bin/sesh-waiting.sh \
   bin/sesh-shortcuts.sh \
   plugins/sesh-list.ts \
@@ -284,8 +284,7 @@ if [[ "$fzf_version" =~ ^([0-9]+)\.([0-9]+)(\.([0-9]+))? ]]; then
 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 sqlite3 >/dev/null 2>&1 || fail "sqlite3 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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencode-sesh",
-  "version": "1.0.8",
+  "version": "2.0.0",
   "description": "Browse, search, preview and resume opencode sessions from the terminal and the TUI.",
   "type": "module",
   "license": "MIT",
@@ -38,8 +38,7 @@
     "AGENTS.md",
     "CHANGELOG.md",
     "LICENSE",
-    "README.md",
-    "ROADMAP.md"
+    "README.md"
   ],
   "publishConfig": {
     "access": "public"
@@ -62,8 +61,8 @@
   },
   "peerDependencies": {
     "@opencode/plugin": ">=2.0.0",
-    "@opentui/core": ">=0.5.8",
-    "@opentui/solid": ">=0.5.8",
+    "@opentui/core": "^0.5.8",
+    "@opentui/solid": "^0.5.8",
     "solid-js": ">=1.9.0"
   },
   "devDependencies": {

package/plugins/sesh-list.ts

@@ -1,9 +1,19 @@
 import { Plugin } from "@opencode/plugin"
+import { spawnSync } from "node:child_process"
+import { existsSync } from "node:fs"
 import { homedir } from "node:os"
 import { join } from "node:path"
 
-function dataHome(): string {
-  return process.env.XDG_DATA_HOME ?? join(homedir(), ".local", "share")
+function dbPath(): string {
+  if (process.env.SESH_DB) return process.env.SESH_DB
+  const xdgPath = join(process.env.XDG_DATA_HOME ?? join(homedir(), ".local", "share"), "opencode", "opencode.db")
+  if (existsSync(xdgPath)) return xdgPath
+  try {
+    const result = spawnSync(process.env.SESH_OPENCODE ?? "opencode", ["debug", "paths"], { encoding: "utf8" })
+    const match = result.stdout?.match(/^db\s+(.+)$/m)
+    if (match) return match[1].trimEnd()
+  } catch {}
+  return xdgPath
 }
 
 const input = {
@@ -44,12 +54,12 @@ export default Plugin.define({
             throw new Error("sesh_list requires the Bun runtime (bun:sqlite)")
           }
 
-          const db = new sqlite.Database(join(dataHome(), "opencode", "opencode.db"), { readonly: true })
+          const db = new sqlite.Database(dbPath(), { readonly: true })
           try {
             const scoped = typeof args.directory === "string" && args.directory.length > 0
             const query = `SELECT id, title, directory, time_updated AS updated, time_created AS created
               FROM session_v2
-              WHERE parent_id IS NULL AND time_archived IS NULL${scoped ? " AND directory = ?" : ""}
+              WHERE parent_id IS NULL AND COALESCE(time_archived, 0) = 0${scoped ? " AND directory = ?" : ""}
               ORDER BY time_updated DESC, id DESC
               LIMIT ${limit}`
             const rows = scoped ? db.query(query).all(args.directory) : db.query(query).all()

package/tui-plugins/sesh-panel/package.json

@@ -1,9 +1,8 @@
 {
   "name": "opencode-tui-sesh-panel",
-  "version": "1.0.0",
   "type": "module",
   "exports": {
     ".": "./server.ts",
     "./tui": "./tui.tsx"
   }
-}
+}

package/tui-plugins/sesh-panel/tui.tsx

@@ -7,8 +7,9 @@ type TuiPluginApi = ReturnType<typeof createApi>
 type TuiPlugin = (api: TuiPluginApi) => Promise<void>
 import { createEffect, createMemo, createRoot, createSignal, For, getOwner, on, onCleanup, onMount, runWithOwner, Show } from "solid-js"
 import { mkdir, readFile, rename, rmdir, unlink, writeFile } from "node:fs/promises"
+import { existsSync } from "node:fs"
 import { dirname, join } from "node:path"
-import { spawn } from "node:child_process"
+import { spawn, spawnSync } from "node:child_process"
 import { getTreeSitterClient, RGBA, SyntaxStyle, TextAttributes } from "@opentui/core"
 import { Portal } from "@opentui/solid"
 
@@ -502,26 +503,63 @@ type IndexProgress = { indexed: number; total: number; complete: boolean }
 
 const nextTick = () => new Promise<void>((resolve) => setTimeout(resolve, 0))
 
+function resolveDbPath(): string {
+  if (process.env.SESH_DB) return process.env.SESH_DB
+  const home = process.env.HOME ?? ""
+  const dataHome = process.env.XDG_DATA_HOME ?? `${home}/.local/share`
+  const xdgPath = `${dataHome}/opencode/opencode.db`
+  if (existsSync(xdgPath)) return xdgPath
+  try {
+    const result = spawnSync(process.env.SESH_OPENCODE ?? "opencode", ["debug", "paths"], { encoding: "utf8" })
+    const match = result.stdout?.match(/^db\s+(.+)$/m)
+    if (match) return match[1].trimEnd()
+  } catch {}
+  return xdgPath
+}
+
 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") return undefined
-    return new sqlite.Database(`${dataHome}/opencode/opencode.db`, { readonly: true })
+    return new sqlite.Database(resolveDbPath(), { readonly: true })
   } catch {
     return undefined
   }
 }
 
+function costRowsQuery(cutoff: number, includeLegacy: boolean): string {
+  const legacy = includeLegacy ? `UNION ALL
+SELECT s.directory, s.id AS session_id, m.time_created, m.data
+FROM message m JOIN session s ON s.id = m.session_id
+WHERE json_extract(m.data, '$.role') = 'assistant'
+  AND NOT EXISTS (SELECT 1 FROM session_v2 v WHERE v.id = s.id)` : ""
+  return `WITH costs AS (
+SELECT s.directory, s.id AS session_id, m.time_created, m.data
+FROM session_message m JOIN session_v2 s ON s.id = m.session_id
+WHERE m.type = 'assistant'
+${legacy}
+)
+SELECT m.directory AS directory,
+  ROUND(SUM(CASE WHEN m.time_created >= ${cutoff} THEN COALESCE(json_extract(m.data, '$.cost'), 0) ELSE 0 END), 4) AS window_cost,
+  ROUND(SUM(COALESCE(json_extract(m.data, '$.cost'), 0)), 4) AS lifetime_cost,
+  COUNT(DISTINCT m.session_id) AS sessions
+FROM costs m
+WHERE json_extract(m.data, '$.cost') IS NOT NULL
+GROUP BY m.directory
+ORDER BY lifetime_cost DESC`
+}
+
 // NEEDS_INPUT_SQL: sessions waiting on the user (shared heuristic — keep in
 // sync with bin/sesh-waiting.sh). A session waits when it is not archived,
-// is not a fork child, and either has an unanswered `question` tool part or
-// a `tool` part still marked running older than STUCK_AFTER_MS (awaiting
-// approval, or orphaned by a dead server). Server-independent on purpose:
-// the TUI sync layer only sees permission/question state for sessions owned
-// by the current server, which is invisible cross-project.
+// is not a child (subagent) session, and either has an unanswered `question`
+// tool part or a `tool` part still marked running older than STUCK_AFTER_MS
+// with no message activity in the session or its direct children since then (a
+// long-running subagent/shell tool with recent activity is not stuck; V2
+// resumes interrupted runs server-side, so `running` with no activity means
+// orphaned or awaiting approval). Server-independent on purpose: the TUI
+// sync layer only sees permission/question state for sessions owned by the
+// current server, which is invisible cross-project.
 const STUCK_AFTER_MS = 600000
 const LIVE_TOOLS_CTE = (sessionFilter: string) => `
 WITH live AS (
@@ -539,6 +577,9 @@ const QUESTION_OPEN = `live.name = 'question'
   AND NOT EXISTS (
     SELECT 1 FROM session_message u
     WHERE u.session_id = live.session_id AND u.type = 'user' AND u.seq > live.seq)`
+const NO_RECENT_ACTIVITY = (sessionIdExpr: string, stuckBefore: number) => `NOT EXISTS (
+      SELECT 1 FROM session_message r JOIN session_v2 f ON f.id = r.session_id
+      WHERE (f.id = ${sessionIdExpr} OR f.parent_id = ${sessionIdExpr}) AND r.time_updated >= ${stuckBefore})`
 const NEEDS_INPUT_SQL = (stuckBefore: number) => `${LIVE_TOOLS_CTE("")}
 SELECT s.id AS id,
   CASE WHEN EXISTS (SELECT 1 FROM live WHERE live.session_id = s.id AND ${QUESTION_OPEN})
@@ -547,9 +588,10 @@ FROM session_v2 s
 WHERE COALESCE(s.time_archived, 0) = 0
   AND s.parent_id IS NULL
   AND (EXISTS (SELECT 1 FROM live WHERE live.session_id = s.id AND ${QUESTION_OPEN})
-    OR EXISTS (
+    OR (EXISTS (
       SELECT 1 FROM live
-      WHERE live.session_id = s.id AND live.status = 'running' AND live.created < ${stuckBefore}))
+      WHERE live.session_id = s.id AND live.status = 'running' AND live.created < ${stuckBefore})
+      AND ${NO_RECENT_ACTIVITY("s.id", stuckBefore)}))
 ORDER BY s.time_updated DESC`
 
 async function queryWaitingIds(db: any): Promise<Map<string, string>> {
@@ -679,7 +721,7 @@ async function buildSearchIndexRemote(
   onEach: () => void,
 ): Promise<void> {
   const home = process.env.HOME ?? ""
-  const cacheDir = process.env.SESH_CACHE_DIR ?? `${home}/.cache/sesh`
+  const cacheDir = process.env.SESH_CACHE_DIR ?? `${process.env.XDG_CACHE_HOME ?? `${home}/.cache`}/sesh`
   let cursor = 0
   // Bounded concurrency: a fixed worker pool instead of one request per session.
   const worker = async () => {
@@ -1558,7 +1600,6 @@ function SidebarSessions(props: { api: TuiPluginApi } & PinProps) {
         <box
           flexDirection="row"
           gap={1}
-          paddingLeft={1}
           paddingRight={1}
           backgroundColor={searching() ? theme().backgroundElement : RGBA.fromInts(0, 0, 0, 0)}
           onMouseDown={(event: { stopPropagation: () => void }) => {
@@ -1576,7 +1617,7 @@ function SidebarSessions(props: { api: TuiPluginApi } & PinProps) {
             wrapMode="none"
             style={{ fg: query() ? theme().text : theme().textMuted }}
           >
-            {query() || "search…"}
+            {query() || (searching() ? "" : "search…")}
             {searching() ? "▏" : ""}
           </text>
           <Show when={query()}>
@@ -2001,7 +2042,7 @@ function HomeSessions(props: { api: TuiPluginApi } & PinProps) {
                   wrapMode="none"
                   style={{ fg: query() ? theme().text : theme().textMuted }}
                 >
-                  {query() || "search…"}
+                  {query() || (searching() ? "" : "search…")}
                   {searching() ? "▏" : ""}
                 </text>
               </box>
@@ -2574,6 +2615,7 @@ const tui: TuiPlugin = async (api) => {
                 focusedBackgroundColor={api.theme.current.backgroundPanel}
                 focusedTextColor={api.theme.current.text}
                 cursorColor={api.theme.current.primary}
+                cursorStyle={{ style: "line", blinking: false }}
                 onInput={(value) => {
                   if (pendingDelete()) return
                   setQuery(value)
@@ -2851,17 +2893,8 @@ const tui: TuiPlugin = async (api) => {
       else {
         try {
           const cutoff = Date.now() - 86400000
-          const raw = (db.query(`
-SELECT s.directory AS directory,
-  ROUND(SUM(CASE WHEN m.time_created >= ${cutoff} THEN COALESCE(json_extract(m.data, '$.cost'), 0) ELSE 0 END), 4) AS window_cost,
-  ROUND(SUM(COALESCE(json_extract(m.data, '$.cost'), 0)), 4) AS lifetime_cost,
-  COUNT(DISTINCT s.id) AS sessions
-FROM session_message m
-JOIN session_v2 s ON s.id = m.session_id
-WHERE m.type = 'assistant'
-  AND json_extract(m.data, '$.cost') IS NOT NULL
-GROUP BY s.directory
-ORDER BY lifetime_cost DESC`).all() ?? []) as {
+          const legacyTables = db.query("SELECT count(*) AS count FROM sqlite_master WHERE type = 'table' AND name IN ('session', 'message')").get()
+          const raw = (db.query(costRowsQuery(cutoff, legacyTables?.count === 2)).all() ?? []) as {
             directory: unknown
             window_cost: unknown
             lifetime_cost: unknown

package/ROADMAP.md

@@ -1,60 +0,0 @@
-# Roadmap
-
-Productivity bets for sesh, roughly ordered by payoff. Status is tracked here
-as items land.
-
-## 1. Needs-input triage (done)
-
-**Problem:** with 100+ sessions, the bottleneck is not finding a session but
-knowing which ones are *waiting on you* (unanswered agent questions, stale
-runs awaiting approval) versus done versus dead. Today that means polling rows
-by hand.
-
-**Approach:** server-independent detection straight from the opencode SQLite
-store, so it works for every session, not just ones owned by the current TUI
-server (whose in-memory permission/question state is invisible cross-project):
-
-- a `question` tool part that is not `completed` with no later user message in
-  the same session → awaiting an answer;
-- a `tool` part stuck in `running` older than ~10 minutes → awaiting approval
-  or orphaned by a dead server.
-
-**Surfaces:** a "Needs input" section pinned above the directory groups in the
-TUI sidebar, plus a terminal listing (`sesh --needs-input`).
-
-## 2. Stale-session pruning (done)
-
-**Problem:** the list grows without bound (127+ rows), which slows scanning
-and bloats the transcript search index with archaeology.
-
-**Approach:** `sesh prune --older-than 30d` archives (never deletes) sessions
-older than the threshold: never pinned ones, never ones flagged as needing
-input. Archive is reversible; `--delete` stays the explicit hard-delete path
-through the existing two-step confirm. Interactive runs confirm with a
-candidate summary; non-TTY runs require `--yes`; `--dry-run` lists only.
-
-## 3. sesh ↔ cmux bridge (done)
-
-**Approach:** [`contrib/cmux/`](contrib/cmux/README.md) ships the cmux
-actions, shortcuts and a `--print --json` recipe that resumes a session in its
-own workspace; the TUI's right-click action opens one directly.
-
-## 4. Per-project cost digest (done)
-
-`sesh costs [--days N] [--json]` sums assistant-message cost per directory with
-a recent window beside the lifetime total, so a day's work reads as a
-per-project record. Message-level summing (not `session.cost`) keeps a
-half-finished day from dragging in a session's earlier history.
-
-## 5. Resume from anywhere (done)
-
-Covered by the same contrib recipes: `sesh --print --json` resolves a session
-non-interactively, so a cmux action, skhd binding or launcher can resume a
-specific session — or open the picker — from any context.
-
-## Smaller items (done)
-
-- Search weighting: title matches outrank transcript-only matches and the
-  current project rises while a query is active; pins still win outright.
-- `sesh retitle [--dry-run] [--yes]` replaces placeholder titles
-  (`New session - …`) with the start of the first user message.

package/bin/sesh-retitle.sh

@@ -1,139 +0,0 @@
-#!/usr/bin/env bash
-# Give auto-generated session titles a readable first line.
-#
-# opencode titles most sessions itself; a few keep their placeholder
-# ("New session - <ISO>") because they ended before a title was derived. This
-# replaces just those placeholders with the start of the session's first user
-# message, so the row scans like the rest of the list.
-#
-# It only ever touches titles matching the placeholder pattern, and the value
-# it overwrites carries no information (a timestamp), so nothing recoverable is
-# lost. The write is a single direct UPDATE through the same sqlite3-or-
-# `opencode db` path as `sesh prune` — opencode exposes no title endpoint in
-# the CLI, so a direct write is the only route.
-#
-# Usage: sesh-retitle.sh [--dry-run] [--yes] [--max-words N]
-set -euo pipefail
-
-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-OPENCODE_BIN=${SESH_OPENCODE:-opencode}
-dry_run=0
-assume_yes=0
-max_words=8
-while [ "$#" -gt 0 ]; do
-  case "$1" in
-    --dry-run) dry_run=1 ;;
-    --yes|-y) assume_yes=1 ;;
-    --max-words) max_words=${2:-}; shift ;;
-    --max-words=*) max_words=${1#--max-words=} ;;
-    --help) echo "usage: ${0##*/} [--dry-run] [--yes] [--max-words N]"; exit 0 ;;
-    *) echo "unknown option: $1" >&2; exit 2 ;;
-  esac
-  shift
-done
-case "$max_words" in ''|*[!0-9]*) echo "--max-words must be a positive integer" >&2; exit 2;; esac
-[ "$max_words" -gt 0 ] || { echo "--max-words must be positive" >&2; exit 2; }
-
-resolve_db() {
-  if [ -n "${SESH_DB:-}" ]; then printf '%s\n' "$SESH_DB"; return 0; fi
-  local from_cli=''
-  if command -v "$OPENCODE_BIN" >/dev/null 2>&1; then
-    from_cli=$("$OPENCODE_BIN" db path 2>/dev/null || true)
-  fi
-  if [ -n "$from_cli" ] && [ -f "$from_cli" ]; then printf '%s\n' "$from_cli"; return 0; fi
-  if [ -f "$HOME/.local/share/opencode/opencode.db" ]; then printf '%s\n' "$HOME/.local/share/opencode/opencode.db"; return 0; fi
-  return 1
-}
-
-SQLITE_BIN=''
-if [ -n "${SESH_SQLITE:-}" ]; then
-  SQLITE_BIN=$SESH_SQLITE
-elif command -v sqlite3 >/dev/null 2>&1; then
-  SQLITE_BIN=sqlite3
-fi
-
-DB_PATH=$(resolve_db) || { echo 'sesh: session database unavailable' >&2; exit 1; }
-[ -f "$DB_PATH" ] || { echo 'sesh: session database unavailable' >&2; exit 1; }
-
-if [ -n "$SQLITE_BIN" ]; then
-  query() { "$SQLITE_BIN" -json -readonly "$DB_PATH" "$1"; }
-  write_db() { "$SQLITE_BIN" "$DB_PATH" "$1"; }
-else
-  command -v "$OPENCODE_BIN" >/dev/null 2>&1 || { echo 'sesh: neither sqlite3 nor opencode is available' >&2; exit 1; }
-  query() { "$OPENCODE_BIN" db "$1" --format json; }
-  write_db() { "$OPENCODE_BIN" db "$1" --format json > /dev/null; }
-fi
-
-JQ_BIN=${SESH_JQ:-$(command -v jq || true)}
-[ -n "$JQ_BIN" ] || { echo 'sesh: jq is required' >&2; exit 1; }
-
-# The first user text part per placeholder-titled session, cleaned into a
-# candidate: image chips and markdown noise dropped, whitespace collapsed,
-# first `max_words` words kept.
-CANDIDATES=$(query "
-SELECT s.id AS id, s.directory AS directory, s.title AS old_title,
-  (SELECT m.data FROM session_message m
-     WHERE m.session_id = s.id AND m.type = 'user'
-       AND json_type(m.data, '\$.text') = 'text'
-     ORDER BY m.seq ASC LIMIT 1) AS first_part
-FROM session_v2 s
-WHERE s.title LIKE 'New session - %'
-   OR TRIM(COALESCE(s.title, '')) = ''
-ORDER BY s.time_updated DESC;")
-[ -n "$CANDIDATES" ] || CANDIDATES='[]'
-
-PLAN=$(printf '%s' "$CANDIDATES" | "$JQ_BIN" -c --argjson words "$max_words" '
-  def derive:
-    (.first_part // "")
-    | (try (fromjson | .text) catch "")
-    | gsub("\\[Image #[0-9]+\\]"; " ")
-    | gsub("[#*_`>]"; " ")
-    | gsub("\\s+"; " ")
-    | sub("^ +"; "") | sub(" +$"; "")
-    | (split(" ") | map(select(. != "")))
-    | (if length == 0 then "" else .[0:$words] | join(" ") end)
-    | if length > 60 then .[0:57] + "..." else . end;
-  [ .[] | .new_title = derive | select(.new_title != "") ]')
-COUNT=$(printf '%s' "$PLAN" | "$JQ_BIN" -r 'length')
-
-if [ "$COUNT" = 0 ]; then
-  echo "No placeholder-titled sessions with a usable first message."
-  exit 0
-fi
-
-printf '%s' "$PLAN" | "$JQ_BIN" -r '
-  .[] | "\(.id)\t\(.new_title)\t\(.old_title)"' | while IFS=$'\t' read -r id new old; do
-  printf '%s\n  \033[90m%s\033[0m\n  → %s\n' "$id" "$old" "$new"
-done
-
-if [ "$dry_run" = 1 ]; then
-  printf 'Retitle %s session(s) (--dry-run: nothing changed).\n' "$COUNT" >&2
-  exit 0
-fi
-
-if [ "$assume_yes" = 0 ]; then
-  if [ -t 0 ]; then
-    printf 'Retitle %s session(s)? [y/N] ' "$COUNT"
-    reply=''
-    IFS= read -r -n 1 reply || reply=''
-    printf '\n'
-    case "$reply" in
-      y|Y) ;;
-      *) echo 'Cancelled; nothing was changed.'; exit 0 ;;
-    esac
-  else
-    echo "Refusing to retitle $COUNT session(s): pass --yes when stdin is not a terminal." >&2
-    exit 2
-  fi
-fi
-
-# Escape single quotes for the SQL string literal; ids are validated by shape.
-sql_escape() { printf '%s' "$1" | sed "s/'/''/g"; }
-printf '%s' "$PLAN" | "$JQ_BIN" -r '.[] | [.id, .new_title] | @tsv' | while IFS=$'\t' read -r id new; do
-  case "$id" in
-    ses_[A-Za-z0-9]*) ;;
-    *) echo "Refusing: unexpected session id shape." >&2; exit 1 ;;
-  esac
-  write_db "UPDATE session_v2 SET title = '$(sql_escape "$new")' WHERE id = '$id' AND (title LIKE 'New session - %' OR TRIM(COALESCE(title, '')) = '');"
-done
-echo "Retitled $COUNT session(s)."