opencode-sesh 2.0.1 → 2.0.3

package/AGENTS.md

@@ -11,24 +11,25 @@ territory: read this first, then the specific file you need.
    any terminal. Lists **all** sessions across **all** project directories,
    full-text searchable, with transcript preview and resume/fork/delete.
 2. **`tui-plugins/sesh-panel/tui.tsx`** — a SolidJS/OpenTUI plugin for the opencode TUI: a
-   sessions section in the sidebar plus an `option+o` / `/sesh` picker.
+   sessions section in the sidebar and on the home screen, plus an `option+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
    SQLite store (the native `opencode session list` is project-scoped).
 
 No iTerm2, no AppleScript, no panes, no window management — **never add any.**
-The one exception is the TUI's right-click action, which shells out to
+The one exception is the TUI's right-click workspace action, which shells out to
 `cmux new-workspace` when running inside cmux.
-opencode has no persistent-sidebar API, so the "sidebar" is a `sidebar_content`
-slot section plus an xlarge modal picker; the terminal UI is fullscreen fzf.
+opencode has no persistent-sidebar API, so the TUI uses `sidebar_content` and
+`home_bottom` slot sections plus an xlarge modal picker; the terminal UI is fullscreen fzf.
 
 ## Start here
 
 ```bash
 bun install            # dev deps (TypeScript, opencode/OpenTUI types)
-bun run test           # fixture-DB regression suite — must stay green
+bun run build          # compile the panel to dist/tui.js
+bun run test           # build + 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 test:picker    # PTY picker suite
 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)
@@ -39,7 +40,8 @@ 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` deletes stale sessions; `sesh-costs.sh` sums
+  both); `sesh-pins.sh` manages persistent session/directory pins;
+  `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`.
@@ -47,9 +49,16 @@ HOME=/tmp/fakehome bash install.sh   # installer smoke test (never touches ~/.co
   window management to sesh itself.
 - `tui-plugins/sesh-panel/tui.tsx` — SolidJS panel, `/** @jsxImportSource @opentui/solid */`.
 - `plugins/sesh-list.ts` — the agent-facing `sesh_list` tool.
+- `scripts/build-tui.mjs` — compiles the panel with Babel + `babel-preset-solid`
+  (`moduleName: "@opentui/solid"`, universal) to `dist/tui.js` (gitignored).
+  `package.json` exports `./tui` from `dist/tui.js`; `bun run build`, `bun run
+  test`, `prepack` and CI all run it. OpenCode applies its Solid transform only
+  to sources outside `node_modules`, so shipping raw `tui.tsx` in the npm package
+  renders a non-reactive (empty) panel — never export the `.tsx` source.
 - `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.
+- `assets/` — README logo (`logo.svg`) and square mark (`icon.svg`); wordmark is outlined paths, no font dependency.
 - `themes/`, `tests/`, `install.sh`, `README.md`.
 
 The tool name in opencode is `sesh_list`. Do not rename it without updating the docs.
@@ -58,13 +67,13 @@ The tool name in opencode is `sesh_list`. Do not rename it without updating the
 
 `bin/sesh-list.sh` owns the fzf picker's session store access (opencode SQLite
 DB: `session_v2` / `session_message` tables); the `sesh_list` agent tool queries
-the same store read-only through `bun:sqlite`. V2 discovers the tool from the
+the same store read-only through `bun:sqlite`. OpenCode discovers the tool from the
 global config directory's `plugins/`. Keep its SQL column names in sync with
 the schema below. Keystrokes never touch the database:
 
 - `--refresh` (expensive): bulk-reads session metadata and per-session text
   parts, validates the persistent extraction cache
-  (`$SESH_CACHE_DIR/extractions/<ses_*.json>`, schema 3) against `time_updated`,
+  (`$SESH_CACHE_DIR/extractions/<ses_*.json>`) against `time_updated`,
   message count and the latest message timestamp, re-extracts only changed sessions,
   prunes vanished ones, and atomically publishes `STATE_DIR/snapshot.jsonl`.
   Extraction reads user `data.text` and assistant `data.content` text entries,
@@ -91,8 +100,10 @@ the schema below. Keystrokes never touch the database:
   `ctrl+d` itself (composer delete-char, session delete), so ctrl pins would
   shadow the composer. Pinned directories sort before groups
   containing pinned sessions. The terminal picker puts pinned sessions first
-  inside each group; the TUI picker and sidebar keep sessions recency-ordered
-  within each directory. The home list puts pinned sessions first.
+  inside each group; the TUI picker ranks pinned sessions first before filtering
+  and keeps sessions within each directory ordered by recency; the sidebar keeps
+  sessions within each directory ordered by recency; the home list puts pinned
+  sessions first.
 
 **Output contract** (TSV, 6 fields):
 `agentId  sessionId  liveState  display  cwd  trackingId`. `display` is the only
@@ -100,8 +111,8 @@ rendered column; `trackingId` is fzf's `--id-nth`. Headers/notices carry an
 empty `sessionId` and are a selection no-op — keep that guard.
 
 One worker (`sesh-refresh-worker.sh`, per picker, TERMed on exit) serializes
-scans; fzf's `start`/`every(3)`/`change` bindings render only. Selection requests
-a fresh poll (`request`/`wait`, ≤12 s) before dispatch — skipped for `--print`,
+scans; fzf's `start`/`every(...)`/`change` bindings render only. Selection requests
+a fresh poll (`request`/`wait`) before dispatch — skipped for `--print`,
 which is a pure snapshot lookup — and prints a progress line to stderr while it
 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
@@ -125,14 +136,14 @@ when opencode exits, the picker reopens with the query preserved.
   `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.
-- fzf: stock only, `>= 0.73` (`transform:`, `every():`). `{q}` in binds is
+- fzf: stock only (`transform:`, `every():`). `{q}` in binds is
   shell-quoted by fzf — don't add quoting. Ctrl-G is bind-only (stays open);
   Ctrl-F is `--expect` (accepts with fork). A `transform-header` inside a chained
   action must come **before** `reload`/`reload-sync`: placed after, fzf silently
-  publishes an empty list (verified on 0.74.3).
+  publishes an empty list.
 - 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`).
+  commits on the second, `y`, or Enter.
 - The installer prefers the local opencode version for `@opencode/*` and
   merges (never clobbers) the config `package.json`; opencode runs `bun install`
   at startup.
@@ -147,13 +158,18 @@ when opencode exits, the picker reopens with the query preserved.
 
 ## TUI panel (`tui-plugins/sesh-panel/tui.tsx`)
 
-- **Sidebar:** `api.slots.register` on `sidebar_content` (prepend mode — native
-  sidebar content stays). Pinned directories sort first, then directory groups
+- **Sidebar & Home list:** `api.slots.register` on `sidebar_content` (`sidebar.content`
+  prepend mode — native sidebar content stays) and `home_bottom` (`home.footer`
+  prepend mode). In the sidebar, pinned directories sort first, then directory groups
   by recency; sessions within each group sort by last update regardless of pins.
+  In the home list, pinned sessions sort first.
   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 option+d deletes one (armed, then confirmed). The section lists every
+  stays neutral (polled periodically); Option-P previews
+  a row and option+d deletes one (armed, then confirmed). Right-clicking a
+  sidebar row opens an action context menu (open, preview, cmux workspace when
+  inside cmux, fork, pin/unpin, delete); right-clicking a home or picker row
+  opens the session in a new cmux workspace. The sidebar 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
@@ -167,7 +183,7 @@ when opencode exits, the picker reopens with the query preserved.
   `api.client.session.fork`; Ctrl-G scopes the list to the selected session's
   project.
 - **Picker search:** pages the global session list (`SESSION_PAGE_LIMIT`, capped
-  at `SESSION_MAX` and reported when truncated) instead of a fixed 500-row
+  at `SESSION_MAX` and reported when truncated) rather than a fixed-size
   window, then indexes transcript text for **every** session in batches
   (`TRANSCRIPT_BATCH`) with bounded remote concurrency (`REMOTE_CONCURRENCY`).
   The header shows indexing progress/coverage. Visible transcript hits get
@@ -177,7 +193,7 @@ when opencode exits, the picker reopens with the query preserved.
   `/sesh-needs` uses the shared needs-input set plus the oldest unresolved
   question or running-tool timestamp, lists longest-waiting first, and `n`
   opens the next waiting session. `tests/tui.mjs` locks the data layer.
-- **Durable install:** V2 reloads plugins on watched configuration changes;
+- **Durable install:** OpenCode reloads plugins on watched configuration changes;
   unwatched dependencies may need a restart. If a panel update does not appear,
   fully quit/reopen opencode. `install.sh --sync-panel`
   (run by the `postinstall`) refreshes an already-installed panel and is a
@@ -222,8 +238,8 @@ when opencode exits, the picker reopens with the query preserved.
   (`tests/tui.mjs` asserts the cap stays out); overflow scrolls inside the
   stretched section.
 - **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)
+  the second (or `y`, or Enter) commits the armed row
+  wherever the pointer or cursor is, and `n`/Esc (or a timeout)
   cancels. Moving the pointer must never disarm: edge-hover flicker ate the
   confirm before `confirmArmed` landed. The `y`/`n` layer is registered *only
   while armed*, so it can never shadow the search box's typing.
@@ -240,9 +256,12 @@ when opencode exits, the picker reopens with the query preserved.
 - `bun run test:changelog` — release-tooling regressions; builds its own git
   history in a temp dir (included in `bun run test`).
 - `bun run test:picker` — PTY suite driving the real fzf picker (needs fzf
-  `>= 0.73` and Python 3).
+  and Python 3).
 - `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.
 - Keep `tui-plugins/sesh-panel/tui.tsx` and any installed copy byte-identical when testing
   the panel locally.
+- The npm install path needs the plugin in both `opencode.json` (server tool) and
+  `cli.json` (TUI panel); `plugin.list` shows only server plugins, so verify the
+  panel by launching the TUI against a fixture or the real store.

package/CHANGELOG.md

@@ -5,6 +5,18 @@ 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.3] - 2026-10-17
+
+### Fixed
+
+- **tui:** Support ctrl-n and ctrl-p in the session picker (#11)
+
+## [2.0.2] - 2026-10-10
+
+### Fixed
+
+- **packaging:** Ship precompiled TUI panel for npm installs
+
 ## [2.0.1] - 2026-10-10
 
 ### Fixed
@@ -488,6 +500,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.3]: https://github.com/ozandogrultan/opencode-sesh/compare/v2.0.2...v2.0.3
+[2.0.2]: https://github.com/ozandogrultan/opencode-sesh/compare/v2.0.1...v2.0.2
 [2.0.1]: https://github.com/ozandogrultan/opencode-sesh/compare/v2.0.0...v2.0.1
 [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

package/README.md

@@ -1,21 +1,23 @@
-# sesh
-
-[![CI](https://github.com/ozandogrultan/opencode-sesh/actions/workflows/ci.yml/badge.svg)](https://github.com/ozandogrultan/opencode-sesh/actions/workflows/ci.yml)
-
-**An [OpenCode V2](https://opencode.ai/v2/) plugin and terminal session browser.** Search every session
+<h1 align="center">
+  <img src="assets/logo.svg" alt="sesh" height="96">
+</h1>
+
+<p align="center">
+  <a href="https://github.com/ozandogrultan/opencode-sesh/actions/workflows/ci.yml"><img src="https://github.com/ozandogrultan/opencode-sesh/actions/workflows/ci.yml/badge.svg" alt="CI"></a>
+  <a href="https://www.npmjs.com/package/opencode-sesh"><img src="https://img.shields.io/npm/v/opencode-sesh" alt="npm"></a>
+  <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue.svg" alt="License: MIT"></a>
+  <a href="#contributing"><img src="https://img.shields.io/badge/PRs-welcome-brightgreen.svg" alt="PRs welcome"></a>
+  <a href="https://github.com/ozandogrultan/opencode-sesh/stargazers"><img src="https://img.shields.io/github/stars/ozandogrultan/opencode-sesh?style=social" alt="GitHub stars"></a>
+</p>
+
+**An [OpenCode](https://opencode.ai) 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.
 
-[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
-[![PRs welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](#contributing)
-[![GitHub stars](https://img.shields.io/github/stars/ozandogrultan/opencode-sesh?style=social)](https://github.com/ozandogrultan/opencode-sesh/stargazers)
-
 ```text
 Sessions (8)                              ▾ hide
 search…
@@ -38,9 +40,10 @@ search…
   subagent child sessions are hidden by default.
 - **Pin what matters.** Ctrl-S pins a session and Ctrl-D pins its directory in
   either picker; the TUI sidebar and home list use Option-S and Option-R.
-  Pins are shared and persist across restarts. Pinned directories rise first;
-  pinned sessions sort first in the terminal picker and home list. The TUI picker
-  and sidebar keep sessions within each directory recency-ordered.
+  Pins are shared and persist across restarts. Pinned directories rise first
+  (followed by directories containing pinned sessions in the TUI picker);
+  pinned sessions sort first in the terminal picker and home list, while the
+  TUI picker and sidebar keep sessions within each directory ordered by recency.
 - **Full-text search.** Type to match against session titles *and* the text of
   the conversation itself. Reasoning and tool output are excluded, so the index
   stays clean.
@@ -59,18 +62,19 @@ search…
 
 ### OpenCode plugin
 
-Add the package to `plugins` in your OpenCode V2 `opencode.json` or
-`opencode.jsonc`:
+Add the package to `plugins` in your `opencode.json` (server tool)
+and `cli.json` (TUI panel):
 
 ```json
 {
-  "$schema": "https://opencode.ai/config.json",
   "plugins": ["opencode-sesh"]
 }
 ```
 
-OpenCode installs the package and loads its server tool and TUI panel. Merge
-this entry with your existing plugins. Remove the copied
+OpenCode installs the package and loads its server tool and TUI panel. The
+published panel is precompiled (`dist/tui.js`) because OpenCode does not apply
+its Solid transform to sources under `node_modules`. Merge this entry with your
+existing plugins. Remove any copied
 `./tui-plugins/sesh-panel` registration and `plugins/sesh-list.ts` tool before
 switching to avoid loading them twice.
 
@@ -94,15 +98,15 @@ bash install.sh
 `sesh install` (or `bash install.sh`) links `sesh` into `$XDG_BIN_HOME`
 (default `~/.local/bin`), copies
 the `sesh_list` tool and the TUI panel into
-`${XDG_CONFIG_HOME:-~/.config}/opencode`, registers the panel in `opencode.json`, and
+`${XDG_CONFIG_HOME:-~/.config}/opencode`, registers `./tui-plugins/sesh-panel` in `opencode.json`, and
 declares the plugin dependencies (opencode installs them on next start). The
-panel registers the `/sesh` slash command. It never edits your shell rc, and any
-file it would overwrite is backed up first.
+panel registers the `/sesh` slash command. It never edits your shell rc or
+overwrites a foreign `sesh` symlink.
 
 The npm package ships the same scripts and installer; the runtime tools below
 are still required.
 
-V2 reloads plugins when watched configuration files change. If a panel update
+OpenCode reloads plugins when watched configuration files change. If a panel update
 does not appear, fully quit opencode and reopen it. Upgrades
 refresh an already-installed panel automatically (the npm `postinstall` syncs
 it), and `sesh --check` reports when the installed panel is out of date.
@@ -121,7 +125,7 @@ option+o          # inside opencode — picker
 ### Requirements
 
 - [opencode](https://opencode.ai), used at least once
-- `bash`, `jq`, and [`fzf`](https://github.com/junegunn/fzf) `>= 0.73`
+- `bash`, `jq`, and [`fzf`](https://github.com/junegunn/fzf) (modern stock build; run `sesh --check` to verify)
 - `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
@@ -167,11 +171,8 @@ 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. Legacy V1 history is included when available; sessions
-already present in V2 are counted only once.
-
-Session browsing uses the V2 store. Sessions remaining only in the legacy V1
-tables are not listed or resumable through sesh.
+per-project record. Earlier history tables are included when present in the
+database, and sessions are counted only once.
 
 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
@@ -197,7 +198,8 @@ non-interactive `sesh-delete.sh` refuses unless given `--yes`.
 | `/sesh-needs` | Sessions waiting on you (Enter opens) |
 | `option+o` | Open the full picker (also in the command palette) |
 | Type | Search titles, directories and transcript text |
-| `↑`/`↓`, `PgUp`/`PgDn`, `Home`/`End` | Move the selection |
+| `↑`/`↓` or Ctrl-P/Ctrl-N | Move the selection up/down |
+| `PgUp`/`PgDn`, `Home`/`End` | Move by page or jump to the first/last session |
 | Option-P | Toggle the transcript preview |
 | Enter | Open the selected session |
 | Option-D | Arm deletion; press Option-D again, `y`, or Enter to confirm |
@@ -213,7 +215,8 @@ Option-O opens the picker globally; the other keys above apply inside it.
 The picker groups sessions under collapsible directory headings (click ▾/▸).
 Mouse-wheel scrolling moves through the tree without changing the selection
 under a stationary pointer. Option-P opens a full-size transcript preview over
-the picker; use ↑/↓ to preview other sessions, then Esc to return to the list.
+the picker; use ↑/↓ or Ctrl-P/Ctrl-N to preview other sessions, then Esc to
+return to the list.
 Right-click a sidebar session to open its action menu: open, preview, fork,
 pin/unpin, or delete with confirmation. Inside cmux, the menu also offers opening
 the session in a new workspace at its directory. Use ↑/↓ and Enter to choose an
@@ -227,7 +230,7 @@ Click the sidebar's `search…` box to filter 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, Option-S to pin a session, Option-R to pin its directory,
-Option-D to arm deletion, Esc to leave). Press Option-D again or `y` to confirm
+Option-D to arm deletion, Esc to leave). Press Option-D again, `y`, or Enter to confirm
 an armed deletion; `n` or Esc cancels. 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
@@ -247,14 +250,15 @@ replace the picker's Ctrl-S/Ctrl-D bindings; Option-S in the picker filters pins
 
 ### Transcript search and needs-input triage
 
-The full picker pages through your whole global session list (no fixed window)
+The full picker pages through your global session list
 and indexes transcript text for every session in the background, showing
-indexing progress under the search box. It only stops at a safety cap of 5,000
-sessions, and says so when it does. Transcript matches show a short excerpt
+indexing progress under the search box (and noting if the safety cap is reached).
+Transcript matches show a short excerpt
 under the result; the Project, Needs input, and Pinned filters combine with
 search. The picker remembers your query and filters until you restart opencode.
 The Needs input dialog (`/sesh-needs`) shows why and how long each session has
-been waiting, oldest first. Press `n` there to open the next waiting session,
+been waiting, oldest first. Use ↑/↓ or Ctrl-P/Ctrl-N to navigate and Enter to
+open the selected session. Press `n` there to open the next waiting session,
 or reopen it after answering one to continue through the list.
 
 ## Configuration
@@ -280,8 +284,8 @@ workspace, and a global "resume from anywhere" hotkey — all caller-side.
 
 ## How it works
 
-The `bin/` readers use the V2 opencode session
-store (SQLite: `session_v2` / `session_message`). Each refresh extracts session
+The `bin/` readers query the opencode session
+store in SQLite (`session_v2` / `session_message`). Each refresh extracts session
 metadata and text-only parts into a persistent per-session cache keyed on
 `time_updated`, message count and the latest message timestamp, then atomically
 publishes a `snapshot.jsonl`. Every keystroke re-renders that snapshot with `jq`
@@ -289,13 +293,14 @@ alone, so typing never starts competing database scans. Reasoning and tool
 payloads are never indexed or previewed, and session ids are validated before
 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-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 read-only through `bun:sqlite`. V2 discovers
-the installed tool automatically in the global config directory's `plugins/`.
+Flat scripts in `bin/` back the terminal UI and CLI subcommands — the picker,
+serialized refresh worker, preview renderer, pin store, deleter, pruner,
+waiting-session check, cost digest, and shortcut help. 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 npm package ships it precompiled as
+`dist/tui.js`. The `sesh_list` agent tool reads the store read-only through
+`bun:sqlite` and is discovered automatically from the global config directory's
+`plugins/`.
 
 ## FAQ
 
@@ -325,8 +330,8 @@ checks before opening a PR:
 
 ```bash
 bun install
-bun run test         # fixture-database regression suite
-bun run test:picker  # PTY picker suite (needs fzf >= 0.73)
+bun run test         # builds dist/tui.js, then the fixture-database regression suite
+bun run test:picker  # PTY picker suite
 bun run typecheck    # tsc over tui-plugins/ and plugins/
 bun run lint:sh      # bash -n on every script
 ```