opencode-sesh 2.0.0 → 2.0.2

package/AGENTS.md

@@ -11,10 +11,10 @@ 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
-   recent-sessions section in the sidebar plus an `alt+o` / `/sesh` picker.
+   sessions section in the sidebar 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
-   db` store (the native `opencode session list` is project-scoped).
+   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
@@ -57,7 +57,7 @@ The tool name in opencode is `sesh_list`. Do not rename it without updating the
 ## Data flow (fzf picker)
 
 `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
+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
 global config directory's `plugins/`. Keep its SQL column names in sync with
 the schema below. Keystrokes never touch the database:
@@ -75,7 +75,8 @@ the schema below. Keystrokes never touch the database:
   the whole DB and pruning is always safe.
 - render (cheap, pure `jq`): reads the snapshot only. Filters on `searchText`
   (title + `fulltextLower`, both lowercased at extraction), groups by `cwd`,
-  sorts groups/items by recency, renders the TSV. Notice rows (headers, a
+  sorts groups/items by pins and recency, with current-project and title-match
+  priority while searching, and renders the TSV. Notice rows (headers, a
   vanished selection, an empty store, a query matching nothing) carry an empty
   `sessionId` and a unique `trackingId`. `--header` prints the one-line
   scope/count/status that the picker uses as fzf's header, and a non-actionable
@@ -89,7 +90,9 @@ the schema below. Keystrokes never touch the database:
   The sidebar and home lists use Option-S / Option-R instead: opencode binds
   `ctrl+d` itself (composer delete-char, session delete), so ctrl pins would
   shadow the composer. Pinned directories sort before groups
-  containing pinned sessions, with pinned sessions first inside each group.
+  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.
 
 **Output contract** (TSV, 6 fields):
 `agentId  sessionId  liveState  display  cwd  trackingId`. `display` is the only
@@ -105,7 +108,8 @@ 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>`; 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).
+Resume runs opencode in a subshell at the session's cwd in the same terminal;
+when opencode exits, the picker reopens with the query preserved.
 
 ## Conventions
 

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.2] - 2026-10-10
+
+### Fixed
+
+- **packaging:** Ship precompiled TUI panel for npm installs
+
+## [2.0.1] - 2026-10-10
+
+### Fixed
+
+- **packaging:** Add root export for opencode plugin and broaden opentui peer range
+
 ## [2.0.0] - 2026-10-10
 
 ### Breaking changes
@@ -482,6 +494,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.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
 [1.0.8]: https://github.com/ozandogrultan/opencode-sesh/compare/v1.0.7...v1.0.8

package/README.md

@@ -12,7 +12,6 @@ The TUI plugin and agent tool require OpenCode V2 and are not compatible with V1
 `/sessions`) are scoped to the current project. `sesh` shows all of them —
 grouped by directory, full-text searchable, and previewable from anywhere.
 
-[![CI](https://github.com/ozandogrultan/opencode-sesh/actions/workflows/ci.yml/badge.svg)](https://github.com/ozandogrultan/opencode-sesh/actions/workflows/ci.yml)
 [![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)
@@ -35,26 +34,50 @@ search…
 ## Why sesh
 
 - **Every session, everywhere.** Sessions are grouped by project directory and
-  sorted by pins, then recency — across *all* your projects, not just the current one.
+  shown across *all* your projects, not just the current one. Archived and
+  subagent child sessions are hidden by default.
 - **Pin what matters.** Ctrl-S pins a session and Ctrl-D pins its directory in
-  either picker. Pins are shared across the terminal and opencode TUI and
-  persist across restarts; pinned directories and sessions sort first.
+  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.
 - **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.
-- **Transcript preview.** Space shows the most recent messages first, rendered as
-  Markdown (with `glow` if you have it).
-- **Resume in place.** Enter `exec`s `opencode --session <id>` in the session's
-  own directory. Ctrl-F forks instead. Your terminal becomes the session — no
-  tabs, no panes, no window management.
-- **Native TUI, too.** A recent-sessions section in the opencode sidebar plus an
+- **Transcript preview.** Ctrl-P in the terminal picker or Option-P in the TUI
+  shows the most recent messages first, rendered as Markdown (with `glow` in
+  the terminal if you have it).
+- **Resume in place.** Enter runs `opencode --session <id>` in the session's
+  own directory. Ctrl-F forks instead. The session opens in the same terminal,
+  and exiting opencode returns to the picker — no tabs, panes, or window management.
+- **Native TUI, too.** A sessions section in the opencode sidebar plus an
   `option+o` picker, both themed by your opencode theme.
 - **Fast.** The database is scanned once per refresh and cached; keystrokes only
   re-render the last snapshot, so typing never triggers a query storm.
 
 ## Install
 
-With npm:
+### OpenCode plugin
+
+Add the package to `plugins` in your OpenCode V2 `opencode.json` (server tool)
+and `cli.json` (TUI panel):
+
+```json
+{
+  "plugins": ["opencode-sesh"]
+}
+```
+
+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 the copied
+`./tui-plugins/sesh-panel` registration and `plugins/sesh-list.ts` tool before
+switching to avoid loading them twice.
+
+### Terminal picker
+
+Install the CLI with npm:
 
 ```bash
 npm install -g opencode-sesh
@@ -71,7 +94,7 @@ 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
+the `sesh_list` tool and the TUI panel into
 `${XDG_CONFIG_HOME:-~/.config}/opencode`, registers the 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
@@ -139,7 +162,7 @@ Flags: `--cwd` (current directory only), `--limit N` (default: all),
 
 `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
+Pinned sessions and directories, 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`.
 
@@ -155,8 +178,8 @@ 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.
 
-Because `--print` just emits the id and directory, `sesh` doubles as a scriptable
-session lookup:
+`--print` still opens the interactive picker, but emits the selected id and
+directory instead of resuming. `--query` supplies the initial search text:
 
 ```bash
 read -r id cwd < <(sesh --print --query "auth")
@@ -166,7 +189,7 @@ sesh --print --json --query "auth" | jq -r .cwd
 Deleting is irreversible, so the picker asks before dispatching it, and a
 non-interactive `sesh-delete.sh` refuses unless given `--yes`.
 
-### TUI panel
+### TUI picker
 
 | Key | Action |
 | --- | --- |
@@ -178,13 +201,16 @@ 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 |
-| Option-D | Delete the selected session (asks to confirm) |
+| Option-D | Arm deletion; press Option-D again, `y`, or Enter 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 |
 | Ctrl-S / Ctrl-D | Pin or unpin the selected session / directory |
 | Esc | Close the preview first, then the picker |
 
+While deletion is armed, `n` or Esc cancels; it also cancels after five seconds.
+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
@@ -196,10 +222,14 @@ action, or Esc to dismiss the menu.
 Right-click a session in the home list or picker to open it in a new cmux
 workspace at its directory; outside cmux it shows a toast instead.
 
-Click the sidebar's `search…` box to filter recent sessions in place; click
+### TUI sidebar and home list
+
+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/Option-R to pin, Option-D to delete, Esc to leave). Pinned
+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
+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
 the sidebar, so click **▾ hide** to collapse it when you need the room.
@@ -212,6 +242,12 @@ Hovering a row while keyboard navigation is active selects it for the next
 shortcut. Clicking (or Enter on) a session opens it here. The full picker is one
 keystroke away.
 
+The home list also supports search and the Option-P, Option-S, Option-R, and
+Option-D actions on the hovered session. These Option pin shortcuts do not
+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)
 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
@@ -233,7 +269,7 @@ All variables are optional.
 | `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) |
-| `SESH_CACHE_DIR` | `~/.cache/sesh` | persistent search-index cache |
+| `SESH_CACHE_DIR` | `${XDG_CACHE_HOME:-~/.cache}/sesh` | persistent search-index cache |
 | `SESH_PINS_FILE` | `${XDG_DATA_HOME:-~/.local/share}/sesh/pins.json` | shared persistent session/directory pins |
 
 ## Integrations
@@ -259,7 +295,7 @@ Flat scripts back the terminal UI — the picker (`sesh.sh`), the refresh engine
 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
+`sesh_list` agent tool reads it read-only through `bun:sqlite`. V2 discovers
 the installed tool automatically in the global config directory's `plugins/`.
 
 ## FAQ
@@ -267,12 +303,13 @@ the installed tool automatically in the global config directory's `plugins/`.
 **Does it replace opencode's native session list?** No. `<leader>l` and the
 native `/sessions` command are untouched; `sesh` is additive.
 
-**Is there an agent-facing list?** Yes — the `sesh-list` tool lets the model list
+**Is there an agent-facing list?** Yes — the `sesh_list` tool lets the model list
 every session across all directories (the native `opencode session list` only
 covers the current project) and offer to resume one.
 
 **Where is my data?** It reads the opencode database read-only and caches
-extracted text under `~/.cache/sesh`. Nothing is uploaded anywhere.
+extracted text under `${XDG_CACHE_HOME:-~/.cache}/sesh` (or `SESH_CACHE_DIR`).
+Nothing is uploaded anywhere.
 
 **Does it work on Windows?** It targets macOS and Linux. WSL should work; native
 Windows is untested.

package/bin/sesh-shortcuts.sh

@@ -15,6 +15,11 @@ sesh shortcuts
   Escape            Exit the picker
 
 Flags: --cwd (current directory only), --limit N (default: all),
-       --archived (include archived), --print (print id instead of resuming),
-       --json (with --print, emit JSON)
+       --archived (include archived and child sessions),
+       --print (print selected id<TAB>cwd instead of resuming),
+       --json (with --print, emit JSON), --fork (resume as a fork),
+       --query TEXT (initial search), --check (check dependencies),
+       --needs-input [--json] (list sessions waiting on you)
+
+--print still opens the picker; select a session with Enter or Ctrl-F.
 HELP

package/contrib/cmux/README.md

@@ -20,7 +20,8 @@ Paste only the actions you want; the `ui.newWorkspace` block is optional.
 
 ## Resume a session in its own cmux workspace
 
-The picker resumes in place (it `cd`s and `exec`s opencode). To instead open a
+The picker runs opencode in the selected session's directory and returns to the
+picker when opencode exits. To instead open a
 session in a **new cmux workspace** at its directory, shell out to cmux after
 resolving the session with sesh's scriptable lookup:
 
@@ -57,9 +58,10 @@ sesh is a normal CLI, so any system-wide launcher works — a cmux `shortcut`, a
 cmd + shift - s : cmux new-workspace --command "sesh"
 ```
 
-Because `--print --json` resolves a session non-interactively, the same hook can
-resume a specific session without any UI:
+`--print --json` still opens the interactive picker; `--query` initializes its
+search and `--limit` caps the list rather than automatically accepting a result.
+To resume a known session without the picker, use its id and directory directly:
 
 ```bash
-cmd + alt - r : cmux new-workspace --command "opencode --session $(sesh --print --json --limit 1 | jq -r .sessionId)"
+cmd + alt - r : cmux new-workspace --cwd /path/to/project --command "opencode --session ses_EXAMPLE"
 ```