opencode-sesh 0.14.1 → 1.0.1

package/AGENTS.md

@@ -10,9 +10,9 @@ territory: read this first, then the specific file you need.
 1. **`bin/`** — a fullscreen [fzf](https://github.com/junegunn/fzf) picker for
    any terminal. Lists **all** sessions across **all** project directories,
    full-text searchable, with transcript preview and resume/fork/delete.
-2. **`tui/sesh-panel.tsx`** — a SolidJS/OpenTUI plugin for the opencode TUI: a
-   recent-sessions section in the sidebar plus an `option+o` / `/sesh` picker.
-3. **`opencode/tools/sesh-list.ts`** — the `sesh-list` custom tool, so the agent
+2. **`tui-plugins/sesh-panel/tui.tsx`** — a SolidJS/OpenTUI plugin for the opencode TUI: a
+   recent-sessions section in the sidebar plus an `alt+o` / `/sesh` picker.
+3. **`plugins/sesh-list.ts`** — the `sesh_list` custom tool, so the agent
    can list sessions across every directory by querying the global `opencode
    db` store (the native `opencode session list` is project-scoped).
 
@@ -29,7 +29,7 @@ bun install            # dev deps (TypeScript, opencode/OpenTUI types)
 bun run test           # fixture-DB regression suite — must stay green
 bun run test:changelog # release-tooling regressions (scripts/changelog.sh)
 bun run test:picker    # PTY picker suite (needs fzf >= 0.73)
-bun run typecheck      # tsc over tui/ and opencode/
+bun run typecheck      # tsc over tui-plugins/ and plugins/
 bun run lint:sh        # bash -n on every script
 HOME=/tmp/fakehome bash install.sh   # installer smoke test (never touches ~/.config)
 ```
@@ -47,15 +47,14 @@ HOME=/tmp/fakehome bash install.sh   # installer smoke test (never touches ~/.co
   stay on `opencode session delete`.
 - `contrib/` — caller-side integrations (currently cmux). Nothing here may add
   window management to sesh itself.
-- `tui/sesh-panel.tsx` — SolidJS panel, `/** @jsxImportSource @opentui/solid */`.
-- `opencode/tools/sesh-list.ts` — the agent-facing `sesh-list` tool.
+- `tui-plugins/sesh-panel/tui.tsx` — SolidJS panel, `/** @jsxImportSource @opentui/solid */`.
+- `plugins/sesh-list.ts` — the agent-facing `sesh_list` tool.
 - `scripts/changelog.sh` — release tooling: drafts conventional commits,
   writes a dated version, prints release notes and
   checks the compare links. `tests/changelog.sh` covers it in a throwaway repo.
 - `themes/`, `tests/`, `install.sh`, `README.md`.
 
-The **filename becomes the tool name** in opencode, so `sesh-list.ts` is the
-`sesh-list` tool. Do not rename it without updating the docs.
+The tool name in opencode is `sesh_list`. Do not rename it without updating the docs.
 
 ## Data flow (fzf picker)
 
@@ -123,7 +122,7 @@ Resume happens in place (`exec` after `cd` to the session's cwd).
   action must come **before** `reload`/`reload-sync`: placed after, fzf silently
   publishes an empty list (verified on 0.74.3).
 - 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 Ctrl-X and
+  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
   merges (never clobbers) the config `package.json`; opencode runs `bun install`
@@ -137,7 +136,7 @@ Resume happens in place (`exec` after `cd` to the session's cwd).
   and writes the new dated version and compare link. The released section is
   used as the GitHub release body.
 
-## TUI panel (`tui/sesh-panel.tsx`)
+## TUI panel (`tui-plugins/sesh-panel/tui.tsx`)
 
 - **Sidebar:** `api.slots.register` on `sidebar_content` (append mode — native
   sidebar content stays). Pinned directories sort first, then directory groups
@@ -145,7 +144,7 @@ Resume happens in place (`exec` after `cd` to the session's cwd).
   Row markers alone signal session state: a running agent animates a loading
   spinner marker, the open session shows its own ●, and every other idle row
   stays neutral (polled every 15 s); Option-P previews
-  a row and ctrl+x deletes one (armed, then confirmed). The section lists every
+  a row and option+d deletes one (armed, then confirmed). The section lists every
   session without a row cap and flex-grows to fill the sidebar, with overflow
   scrolling inside; the picker remains the place for transcript search.
   Sessions waiting on the user (unanswered questions, stuck runs) pin a
@@ -154,7 +153,7 @@ Resume happens in place (`exec` after `cd` to the session's cwd).
 - **Picker:** a custom dialog (not `DialogSelect`) grouped by
   project/directory, recency-ordered, resume via
   `api.route.navigate("session", …)`. `option+o` and the command palette open it;
-  Ctrl-X arms and then confirms a delete through `api.client.session.delete` and
+  Option-D arms and then confirms a delete through `api.client.session.delete` and
   removes the row only after the server confirms; Ctrl-F forks through
   `api.client.session.fork`; Ctrl-G scopes the list to the selected session's
   project.
@@ -208,7 +207,7 @@ Resume happens in place (`exec` after `cd` to the session's cwd).
   same row. The section lists every session with no row cap
   (`tests/tui.mjs` asserts the cap stays out); overflow scrolls inside the
   stretched section.
-- **Delete in the TUI is two-step.** The first `ctrl+x` arms `pendingDelete`,
+- **Delete in the TUI is two-step.** The first `option+d` arms `pendingDelete`,
   the second (or `y`, or Enter in the picker footer) commits the armed row
   wherever the pointer or cursor is, and `n`/Esc (or a five-second timeout)
   cancels. Moving the pointer must never disarm: edge-hover flicker ate the
@@ -231,5 +230,5 @@ Resume happens in place (`exec` after `cd` to the session's cwd).
 - `bun run typecheck` — `tsc` over `tui/` and `opencode/`.
 - `bun run lint:sh` — `bash -n` on every script.
 - `HOME=/tmp/fakehome bash install.sh` — installer smoke test.
-- Keep `tui/sesh-panel.tsx` and any installed copy byte-identical when testing
+- Keep `tui-plugins/sesh-panel/tui.tsx` and any installed copy byte-identical when testing
   the panel locally.

package/CHANGELOG.md

@@ -5,6 +5,23 @@ 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.0.1] - 2026-10-08
+
+### Fixed
+
+- **tui:** Bind delete to option+d, readable selected rows, keep scroll on delete
+
+## [1.0.0] - 2026-10-07
+
+### Breaking changes
+
+- Migrate to OpenCode V2 plugin API with full feature parity _(breaking)_
+
+### Fixed
+
+- **tui:** Adapt V2 theme colors for overlays and markdown previews
+- **tui:** Center home recent sessions list horizontally
+
 ## [0.14.1] - 2026-10-01
 
 ### Fixed
@@ -407,6 +424,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.
 
+[1.0.1]: https://github.com/ozandogrultan/opencode-sesh/compare/v1.0.0...v1.0.1
+[1.0.0]: https://github.com/ozandogrultan/opencode-sesh/compare/v0.14.1...v1.0.0
 [0.14.1]: https://github.com/ozandogrultan/opencode-sesh/compare/v0.14.0...v0.14.1
 [0.14.0]: https://github.com/ozandogrultan/opencode-sesh/compare/v0.13.0...v0.14.0
 [0.13.0]: https://github.com/ozandogrultan/opencode-sesh/compare/v0.12.0...v0.13.0

package/README.md

@@ -2,10 +2,12 @@
 
 [![CI](https://github.com/ozandogrultan/opencode-sesh/actions/workflows/ci.yml/badge.svg)](https://github.com/ozandogrultan/opencode-sesh/actions/workflows/ci.yml)
 
-**A session browser for [opencode](https://opencode.ai).** Search every session
+**An [OpenCode V2](https://opencode.ai/v2/) plugin and terminal session browser.** Search every session
 across every project, preview the transcript, and resume in place — from your
 terminal or from inside the TUI.
 
+The TUI plugin and agent tool require OpenCode V2 and are not compatible with V1.
+
 `opencode` keeps a growing pile of sessions, and its native lists (`<leader>l`,
 `/sessions`) are scoped to the current project. `sesh` shows all of them —
 grouped by directory, full-text searchable, and previewable from anywhere.
@@ -174,7 +176,7 @@ non-interactive `sesh-delete.sh` refuses unless given `--yes`.
 | `↑`/`↓`, `PgUp`/`PgDn`, `Home`/`End` | Move the selection |
 | Option-P | Toggle the transcript preview |
 | Enter | Open the selected session |
-| Ctrl-X | Delete the selected session (asks to confirm) |
+| Option-D | Delete the selected session (asks to confirm) |
 | Ctrl-F | Fork the selected session |
 | Ctrl-G | Toggle scope: the selected session's project, or every project |
 | Option-W / Option-S | Show only sessions needing input / pinned sessions |
@@ -195,7 +197,7 @@ workspace at its directory; outside cmux it shows a toast instead.
 Click the sidebar's `search…` box to filter recent sessions in place; click
 elsewhere or press Esc to leave search. Click the **Sessions** heading to drive
 the list from the keyboard instead of the mouse (`↑`/`↓` to move, Enter to open,
-Option-P to preview, Ctrl-S/Ctrl-D to pin, Ctrl-X to delete, Esc to leave). Pinned
+Option-P to preview, Ctrl-S/Ctrl-D to pin, Option-D to delete, Esc to leave). Pinned
 directories rise first, while sessions within each directory are ordered by
 last update, newest first. The section lists every session and scrolls to fill
 the sidebar, so click **▾ hide** to collapse it when you need the room.
@@ -253,7 +255,7 @@ any SQL interpolation.
 Flat scripts back the terminal UI — the picker (`sesh.sh`), the refresh engine
 (`sesh-list.sh`, driven by a per-picker `sesh-refresh-worker.sh` that serializes
 scans), preview renderer (`sesh-preview.sh`), deleter (`sesh-delete.sh`) and
-shortcut help (`sesh-shortcuts.sh`). The TUI panel (`tui/sesh-panel.tsx`) is a
+shortcut help (`sesh-shortcuts.sh`). The TUI panel (`tui-plugins/sesh-panel/tui.tsx`) is a
 SolidJS OpenTUI plugin that talks to the opencode SDK over the same store; the
 `sesh-list` agent tool reads it through `opencode db`.
 

package/bin/sesh-waiting.sh

@@ -13,7 +13,7 @@
 #
 # Usage: sesh-waiting.sh [--json]
 #   default prints a human table; --json prints [{id,reason,title,directory,updated}]
-# Keep NEEDS_INPUT_SQL in sync with the TUI sidebar copy in tui/sesh-panel.tsx.
+# Keep NEEDS_INPUT_SQL in sync with the TUI sidebar copy in tui-plugins/sesh-panel/tui.tsx.
 set -euo pipefail
 
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
@@ -52,7 +52,7 @@ 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 || date +%s000)
 STUCK_BEFORE=$((NOW_MS - 600000))
 
-# NEEDS_INPUT_SQL (shared heuristic — keep in sync with tui/sesh-panel.tsx).
+# NEEDS_INPUT_SQL (shared heuristic — keep in sync with tui-plugins/sesh-panel/tui.tsx).
 read -r -d '' QUERY <<SQL || true
 SELECT s.id AS id, s.directory AS directory, s.title AS title, s.time_updated AS updated,
   CASE WHEN EXISTS (

package/bin/sesh.sh

@@ -41,8 +41,8 @@ if [ "${1:-}" = --check ]; then
   # 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"
+  panel_bundled="$SCRIPT_DIR/../tui-plugins/sesh-panel/tui.tsx"
+  panel_installed="${XDG_CONFIG_HOME:-$HOME/.config}/opencode/tui-plugins/sesh-panel/tui.tsx"
   if [ -f "$panel_installed" ] && [ -f "$panel_bundled" ]; then
     if cmp -s "$panel_bundled" "$panel_installed"; then
       echo 'sesh: sidebar panel is current'

package/install.sh

@@ -23,12 +23,12 @@ 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="1.18.30"
+PLUGIN_VERSION_FALLBACK="2.0.18"
 # 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).
 OPENTUI_RANGE="^0.5.11"
-SOLID_VERSION="1.9.12"
+SOLID_VERSION="1.9.15"
 if [ -f "$SOURCE_DIR/package.json" ] && command -v jq >/dev/null 2>&1; then
   opentui_range=$(jq -r '.devDependencies["@opentui/solid"] // empty' "$SOURCE_DIR/package.json" 2>/dev/null || true)
   solid_version=$(jq -r '.devDependencies["solid-js"] // empty' "$SOURCE_DIR/package.json" 2>/dev/null || true)
@@ -65,9 +65,11 @@ LAUNCHER="$BIN_DIR/sesh"
 # `/sesh` is registered by the TUI plugin (a markdown command cannot open the
 # dialog); this path only exists so we can clean up an obsolete install.
 COMMAND_DST="$CONFIG_DIR/commands/sesh.md"
-TOOL_DST="$CONFIG_DIR/tools/sesh-list.ts"
-PANEL_DST="$CONFIG_DIR/plugins/sesh-panel.tsx"
+TOOL_DST="$CONFIG_DIR/plugins/sesh-list.ts"
+PANEL_DIR="$CONFIG_DIR/tui-plugins/sesh-panel"
+PANEL_DST="$PANEL_DIR/tui.tsx"
 PACKAGE_JSON="$CONFIG_DIR/package.json"
+OPENCODE_JSON="$CONFIG_DIR/opencode.json"
 TUI_JSON="$CONFIG_DIR/tui.json"
 
 # Remove a file only when it carries our marker, so a user's own file with a
@@ -94,6 +96,19 @@ remove_tui_entry() {
   fi
 }
 
+remove_opencode_entry() {
+  [ -f "$OPENCODE_JSON" ] || return 0
+  command -v jq >/dev/null 2>&1 || return 0
+  local tmp
+  tmp=$(mktemp "${TMPDIR:-/tmp}/sesh-opencode.XXXXXX") || return 0
+  if jq 'if (.plugins | type) == "array" then .plugins = [.plugins[] | select(. != "./tui-plugins/sesh-panel")] else . end' "$OPENCODE_JSON" > "$tmp" 2>/dev/null; then
+    cmp -s "$OPENCODE_JSON" "$tmp" || mv "$tmp" "$OPENCODE_JSON"
+    rm -f "$tmp"
+  else
+    rm -f "$tmp"
+  fi
+}
+
 # The launcher is a symlink we create. Treat it as ours only when it resolves to
 # a sesh launcher, so a foreign symlink is never replaced on install nor deleted
 # on uninstall. Recognized by the exact source path, a `.../bin/sesh` target, or
@@ -125,7 +140,9 @@ install_file() {
 }
 
 install_tui_panel() {
-  install_file "$SOURCE_DIR/tui/sesh-panel.tsx" "$PANEL_DST"
+  install_file "$SOURCE_DIR/tui-plugins/sesh-panel/package.json" "$PANEL_DIR/package.json"
+  install_file "$SOURCE_DIR/tui-plugins/sesh-panel/server.ts" "$PANEL_DIR/server.ts"
+  install_file "$SOURCE_DIR/tui-plugins/sesh-panel/tui.tsx" "$PANEL_DST"
 
   local opencode_version='' raw_version='' plugin_version=''
   if command -v opencode >/dev/null 2>&1; then
@@ -134,33 +151,32 @@ install_tui_panel() {
   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
-    note "created $TUI_JSON"
+  local opencode_created=0 opencode_tmp=''
+  if [ ! -f "$OPENCODE_JSON" ]; then
+    printf '{\n  "$schema": "https://opencode.ai/config.json",\n  "plugins": []\n}\n' > "$OPENCODE_JSON"
+    opencode_created=1
+    note "created $OPENCODE_JSON"
   fi
-  tui_tmp=$(mktemp "${TMPDIR:-/tmp}/sesh-tui.XXXXXX")
+  opencode_tmp=$(mktemp "${TMPDIR:-/tmp}/sesh-opencode.XXXXXX")
   if jq '
-    (.plugin // []) as $plugins
-    | ($plugins | map(select(. != "./plugins/sessions-panel.tsx"))) as $clean
-    | .plugin = (if ($clean | index("./plugins/sesh-panel.tsx")) then $clean else $clean + ["./plugins/sesh-panel.tsx"] end)
-  ' "$TUI_JSON" > "$tui_tmp" 2>/dev/null; then
-    if cmp -s "$TUI_JSON" "$tui_tmp"; then
-      note "tui.json already registers the sesh panel"
-      rm -f "$tui_tmp"
+    (.plugins // []) as $plugins
+    | if ($plugins | index("./tui-plugins/sesh-panel")) then . else .plugins = $plugins + ["./tui-plugins/sesh-panel"] end
+  ' "$OPENCODE_JSON" > "$opencode_tmp" 2>/dev/null; then
+    if cmp -s "$OPENCODE_JSON" "$opencode_tmp"; then
+      note "opencode.json already registers the sesh panel"
+      rm -f "$opencode_tmp"
     else
-      mv "$tui_tmp" "$TUI_JSON"
-      note "registered ./plugins/sesh-panel.tsx in tui.json"
+      mv "$opencode_tmp" "$OPENCODE_JSON"
+      note "registered ./tui-plugins/sesh-panel in opencode.json"
     fi
   else
-    rm -f "$tui_tmp"
-    note "warning: could not update $TUI_JSON; add \"./plugins/sesh-panel.tsx\" to its plugin list by hand"
+    rm -f "$opencode_tmp"
+    note "warning: could not update $OPENCODE_JSON; add \"./tui-plugins/sesh-panel\" to its plugins list by hand"
   fi
 
+  # Clean up obsolete V1 tui.json entry if present
+  remove_tui_entry
+
   # 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.
@@ -171,10 +187,10 @@ install_tui_panel() {
     note "created $PACKAGE_JSON"
   fi
   pkg_tmp=$(mktemp "${TMPDIR:-/tmp}/sesh-pkg.XXXXXX")
-  if jq --arg p "$plugin_version" --arg o "$OPENTUI_RANGE" --arg s "$SOLID_VERSION" '
+  if jq --arg p "^$plugin_version" --arg o "$OPENTUI_RANGE" --arg s "$SOLID_VERSION" '
     .dependencies = ((.dependencies // {}) as $d
       | {
-          "@opencode-ai/plugin": ($d["@opencode-ai/plugin"] // $p),
+          "@opencode/plugin": ($d["@opencode/plugin"] // $p),
           "@opentui/core": ($d["@opentui/core"] // $o),
           "@opentui/keymap": ($d["@opentui/keymap"] // $o),
           "@opentui/solid": ($d["@opentui/solid"] // $o),
@@ -217,8 +233,13 @@ if [ "$UNINSTALL" = 1 ]; then
     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_if_marker "$TOOL_DST" "sesh_list" && note "removed $TOOL_DST"
+  remove_if_marker "$CONFIG_DIR/tools/sesh-list.ts" "list opencode sessions for the agent" && note "removed $CONFIG_DIR/tools/sesh-list.ts"
+  if [ -d "$PANEL_DIR" ]; then
+    rm -rf "$PANEL_DIR" && note "removed $PANEL_DIR"
+  fi
+  remove_if_marker "$CONFIG_DIR/plugins/sesh-panel.tsx" "@jsxImportSource @opentui/solid" && note "removed $CONFIG_DIR/plugins/sesh-panel.tsx"
+  remove_opencode_entry && note "unregistered the panel from $OPENCODE_JSON"
   remove_tui_entry && note "unregistered the panel from $TUI_JSON"
   note "uninstalled (extraction cache and plugin dependencies left intact)"
   exit 0
@@ -236,8 +257,10 @@ for path in \
   bin/sesh-retitle.sh \
   bin/sesh-waiting.sh \
   bin/sesh-shortcuts.sh \
-  opencode/tools/sesh-list.ts \
-  tui/sesh-panel.tsx \
+  plugins/sesh-list.ts \
+  tui-plugins/sesh-panel/package.json \
+  tui-plugins/sesh-panel/server.ts \
+  tui-plugins/sesh-panel/tui.tsx \
   themes/glow-dark-clean.json; do
   [ -f "$SOURCE_DIR/$path" ] || fail "installer bundle is incomplete: missing $path."
 done
@@ -283,7 +306,9 @@ note "linked $LAUNCHER -> $SOURCE_DIR/bin/sesh"
 # 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"
+[ "$INSTALL_TOOL" = 1 ] && install_file "$SOURCE_DIR/plugins/sesh-list.ts" "$TOOL_DST"
+# Clean up obsolete V1 tool if present
+remove_if_marker "$CONFIG_DIR/tools/sesh-list.ts" "list opencode sessions for the agent" && note "removed obsolete V1 tool"
 
 if [ "$INSTALL_TUI" = 1 ]; then
   install_tui_panel
@@ -292,7 +317,7 @@ fi
 "$LAUNCHER" --check || fail "post-install check failed."
 note "done"
 note "  picker:  run 'sesh' in any terminal, or '/sesh' inside opencode"
-note "  sidebar: option+o opens the full picker"
+note "  sidebar: alt+o opens the full picker"
 note_restart
 case ":$PATH:" in
   *":$BIN_DIR:"*) ;;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencode-sesh",
-  "version": "0.14.1",
+  "version": "1.0.1",
   "description": "Browse, search, preview and resume opencode sessions from the terminal and the TUI.",
   "type": "module",
   "license": "MIT",
@@ -21,18 +21,24 @@
     "tui",
     "cli"
   ],
+  "exports": {
+    "./tui": "./tui-plugins/sesh-panel/tui.tsx",
+    "./tool": "./plugins/sesh-list.ts"
+  },
   "bin": {
     "sesh": "bin/sesh"
   },
   "files": [
     "bin/",
     "contrib/",
-    "opencode/",
+    "plugins/",
     "themes/",
-    "tui/",
+    "tui-plugins/",
     "install.sh",
     "AGENTS.md",
     "CHANGELOG.md",
+    "LICENSE",
+    "README.md",
     "ROADMAP.md"
   ],
   "publishConfig": {
@@ -40,7 +46,8 @@
   },
   "packageManager": "bun@1.4.2",
   "engines": {
-    "node": ">=20"
+    "node": ">=20",
+    "opencode": ">=2.0.0"
   },
   "scripts": {
     "prepare": "husky",
@@ -53,17 +60,20 @@
     "postinstall": "bash install.sh --sync-panel || true",
     "prepublishOnly": "bun run test && bun run typecheck"
   },
+  "peerDependencies": {
+    "@opencode/plugin": ">=2.0.0"
+  },
   "devDependencies": {
     "@commitlint/cli": "^21.2.2",
     "@commitlint/config-conventional": "^21.2.2",
-    "@opencode-ai/plugin": "1.18.30",
-    "@opencode-ai/sdk": "1.18.30",
+    "@opencode/client": "2.0.18",
+    "@opencode/plugin": "2.0.18",
     "@opentui/core": "^0.5.11",
     "@opentui/keymap": "^0.5.11",
     "@opentui/solid": "^0.5.11",
     "@types/node": "26.5.1",
     "husky": "^9.1.7",
-    "solid-js": "1.9.12",
+    "solid-js": "1.9.15",
     "typescript": "7.0.2"
   }
 }

package/plugins/sesh-list.ts

@@ -0,0 +1,64 @@
+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")
+}
+
+const input = {
+  type: "object",
+  properties: {
+    limit: {
+      type: "number",
+      description: "Maximum sessions to return (0-1000; 0 returns none)",
+      default: 50,
+    },
+    directory: {
+      type: "string",
+      description: "Only sessions from this directory (default: all directories)",
+    },
+  },
+  required: [],
+  additionalProperties: false,
+} as const
+
+export default Plugin.define({
+  id: "sesh-list",
+  async setup(ctx) {
+    ctx.tool.transform((editor) => {
+      editor.add({
+        name: "sesh_list",
+        description: "List opencode sessions across all project directories, newest first",
+        input,
+        async execute(args: any) {
+          const limit = args.limit === undefined ? 50 : Number(args.limit)
+          if (!Number.isInteger(limit) || limit < 0 || limit > 1000) {
+            throw new Error("limit must be an integer between 0 and 1000")
+          }
+          if (limit === 0) return { content: "[]" }
+
+          const specifier = "bun:sqlite"
+          const sqlite: any = await import(specifier).catch(() => undefined)
+          if (typeof sqlite?.Database !== "function") {
+            throw new Error("sesh_list requires the Bun runtime (bun:sqlite)")
+          }
+
+          const db = new sqlite.Database(join(dataHome(), "opencode", "opencode.db"), { 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 = ?" : ""}
+              ORDER BY time_updated DESC, id DESC
+              LIMIT ${limit}`
+            const rows = scoped ? db.query(query).all(args.directory) : db.query(query).all()
+            return { content: JSON.stringify(rows ?? []) }
+          } finally {
+            db.close?.()
+          }
+        },
+      })
+    })
+  },
+})

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

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

package/tui-plugins/sesh-panel/server.ts

@@ -0,0 +1,2 @@
+import { Plugin } from "@opencode/plugin"
+export default Plugin.define({ id: "tui-sesh-panel", setup() {} })