opencode-sesh 1.0.8 → 1.1.0

package/AGENTS.md

@@ -40,11 +40,10 @@ HOME=/tmp/fakehome bash install.sh   # installer smoke test (never touches ~/.co
   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`.
+  assistant-message cost per directory. Reads go through `sqlite3 -readonly`
+  (required; `opencode db` no longer exists); the direct `UPDATE` in
+  `sesh-prune.sh` (archive) is the only sanctioned database write — the API has
+  no archive endpoint — and hard deletes stay on `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 +104,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.

package/CHANGELOG.md

@@ -5,6 +5,12 @@ 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).
 
+## [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 +472,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Fixture-database regression suite, TypeScript typechecking, and ShellCheck in
   CI.
 
+[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

@@ -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
@@ -140,7 +139,7 @@ Flags: `--cwd` (current directory only), `--limit N` (default: all),
 
 `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
+Pinned sessions, sessions waiting on you, subagent child sessions and already-archived
 sessions are never touched; archiving is reversible, while `--delete`
 hard-deletes through `opencode session delete`. Without `--dry-run`, a TTY run
 confirms first and a non-TTY run needs `--yes`.
@@ -149,10 +148,6 @@ confirms first and a non-TTY run needs `--yes`.
 recent window beside the lifetime total, so a day's work reads as a
 per-project record.
 
-`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.
-
 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
 answers "what is newest". Pins still win outright.
@@ -230,8 +225,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` | `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" { print $2; 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
 }
 
@@ -66,12 +66,8 @@ WHERE m.type = 'assistant'
 GROUP BY s.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" { print $2; 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

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" { print $2; 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,13 +1,13 @@
 #!/usr/bin/env bash
 # Archive (or, with --delete, hard-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).
+# is a single atomic UPDATE through sqlite3 — the opencode server API has no
+# archive endpoint, so a direct write is the only route (deletes stay on the
+# CLI).
 #
 # Usage: sesh-prune.sh [--older-than 30d] [--dry-run] [--yes] [--delete]
 #   --older-than Nd|Nh|Nw (bare N means days; default 30d)
@@ -53,12 +53,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" { print $2; 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 +72,9 @@ 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"; }
+write_db() { "$SQLITE_BIN" "$DB_PATH" "$1"; }
 
 JQ_BIN=${SESH_JQ:-$(command -v jq || true)}
 [ -n "$JQ_BIN" ] || { echo 'sesh: jq is required' >&2; exit 1; }
@@ -146,10 +141,8 @@ 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
+    [[ "$id" =~ ^ses_[A-Za-z0-9]+$ ]] || { echo "Refusing: unexpected session id shape." >&2; exit 1; }
+    IN_LIST="$IN_LIST'$id',"
   done
   IN_LIST=${IN_LIST%,}
   write_db "UPDATE session_v2 SET time_archived = $NOW_MS WHERE id IN ($IN_LIST);"
@@ -159,10 +152,7 @@ else
   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
+    [[ "$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

package/bin/sesh-waiting.sh

@@ -6,8 +6,9 @@
 # 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 `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
 #     (awaiting approval, or orphaned by a dead server).
 #
@@ -30,12 +31,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" { print $2; 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
 }
 
@@ -88,14 +89,8 @@ WHERE COALESCE(s.time_archived, 0) = 0
 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,14 @@ 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" )
+  forked=$(cd "$cwd" && "$OPENCODE_BIN" api session.fork --param "sessionID=$session_id" -d '{}' 2>/dev/null | "$SESH_JQ" -r '.data.id // empty' 2>/dev/null || true)
+  if [[ "$forked" =~ ^ses_[A-Za-z0-9]+$ ]]; then
+    session_id=$forked
+  else
+    echo 'sesh: could not fork the session; returning to the picker.' >&2
+    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; }
@@ -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": "1.1.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"

package/plugins/sesh-list.ts

@@ -2,8 +2,8 @@ import { Plugin } from "@opencode/plugin"
 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 {
+  return process.env.SESH_DB ?? join(process.env.XDG_DATA_HOME ?? join(homedir(), ".local", "share"), "opencode", "opencode.db")
 }
 
 const input = {
@@ -44,12 +44,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

@@ -509,7 +509,7 @@ async function openTranscriptDb(): Promise<any | undefined> {
     // @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(process.env.SESH_DB ?? `${dataHome}/opencode/opencode.db`, { readonly: true })
   } catch {
     return undefined
   }

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)."