opencode-sesh 0.11.0 → 0.12.0

package/AGENTS.md

@@ -17,6 +17,8 @@ territory: read this first, then the specific file you need.
    db` 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
+`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.
 

package/CHANGELOG.md

@@ -7,6 +7,23 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.12.0] - 2026-09-30
+
+### Added
+
+- Right-clicking a session in the TUI sidebar, home list or picker opens it in a
+  new cmux workspace at its directory; outside cmux it shows a toast.
+
+### Fixed
+
+- Avoid creating `.bak` backup files on install
+## [0.11.1] - 2026-09-25
+
+### Fixed
+
+- Confirming a session delete in the TUI picker no longer leaks `y` or `n` into
+  the search input; `Enter` and a second `Ctrl-X` commit the armed delete, and
+  session deletion is supported on the home screen.
 ## [0.11.0] - 2026-09-25
 
 ### Changed
@@ -371,7 +388,9 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Fixture-database regression suite, TypeScript typechecking, and ShellCheck in
   CI.
 
-[Unreleased]: https://github.com/ozandogrultan/opencode-sesh/compare/v0.11.0...HEAD
+[Unreleased]: https://github.com/ozandogrultan/opencode-sesh/compare/v0.12.0...HEAD
+[0.12.0]: https://github.com/ozandogrultan/opencode-sesh/compare/v0.11.1...v0.12.0
+[0.11.1]: https://github.com/ozandogrultan/opencode-sesh/compare/v0.11.0...v0.11.1
 [0.11.0]: https://github.com/ozandogrultan/opencode-sesh/compare/v0.10.0...v0.11.0
 [0.10.0]: https://github.com/ozandogrultan/opencode-sesh/compare/v0.9.1...v0.10.0
 [0.9.1]: https://github.com/ozandogrultan/opencode-sesh/compare/v0.9.0...v0.9.1

package/README.md

@@ -185,6 +185,8 @@ 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.
+Right-click a session (sidebar, 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
 elsewhere or press Esc to leave search. Click the **Sessions** heading to drive
@@ -228,7 +230,7 @@ All variables are optional.
 
 ## Integrations
 
-sesh is terminal-agnostic on purpose: it has no window-management code. The
+sesh is terminal-agnostic apart from the TUI's right-click action. The
 [`contrib/cmux/`](contrib/cmux/README.md) directory shows how to drive it from
 cmux — command-palette entries, shortcuts, resuming a session in its own
 workspace, and a global "resume from anywhere" hotkey — all caller-side.

package/ROADMAP.md

@@ -35,10 +35,9 @@ candidate summary; non-TTY runs require `--yes`; `--dry-run` lists only.
 
 ## 3. sesh ↔ cmux bridge (done)
 
-**Approach:** kept caller-side. sesh has no window-management code (a hard
-repo rule), so [`contrib/cmux/`](contrib/cmux/README.md) ships the cmux
+**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. cmux calls sesh; sesh never calls cmux.
+own workspace; the TUI's right-click action opens one directly.
 
 ## 4. Per-project cost digest (done)
 

package/contrib/cmux/README.md

@@ -1,8 +1,8 @@
 # sesh ↔ cmux
 
 Optional glue for running sesh inside [cmux](https://cmux.dev). Nothing here is
-bundled into the picker: sesh has no window-management code, and these recipes
-keep it that way. cmux calls sesh; sesh never calls cmux.
+bundled into the picker: these recipes are caller-side. The only place sesh
+calls cmux is the TUI's right-click action, which runs `cmux new-workspace`.
 
 ## Command palette + shortcuts
 

package/install.sh

@@ -87,7 +87,7 @@ remove_tui_entry() {
   local tmp
   tmp=$(mktemp "${TMPDIR:-/tmp}/sesh-tui.XXXXXX") || return 0
   if jq 'if (.plugin | type) == "array" then .plugin = [.plugin[] | select(. != "./plugins/sesh-panel.tsx")] else . end' "$TUI_JSON" > "$tmp" 2>/dev/null; then
-    cmp -s "$TUI_JSON" "$tmp" || { cp -p "$TUI_JSON" "$TUI_JSON.bak.$(date +%Y%m%d%H%M%S)"; mv "$tmp" "$TUI_JSON"; }
+    cmp -s "$TUI_JSON" "$tmp" || mv "$tmp" "$TUI_JSON"
     rm -f "$tmp"
   else
     rm -f "$tmp"
@@ -120,10 +120,6 @@ install_file() {
     note "up to date $dst"
     return 0
   fi
-  if [ -f "$dst" ]; then
-    cp -p "$dst" "$dst.bak.$(date +%Y%m%d%H%M%S)"
-    note "backed up existing $(basename "$dst")"
-  fi
   cp -p "$src" "$dst"
   note "installed $dst"
 }
@@ -157,7 +153,6 @@ install_tui_panel() {
       note "tui.json already registers the sesh panel"
       rm -f "$tui_tmp"
     else
-      [ "$tui_created" = 1 ] || cp -p "$TUI_JSON" "$TUI_JSON.bak.$(date +%Y%m%d%H%M%S)"
       mv "$tui_tmp" "$TUI_JSON"
       note "registered ./plugins/sesh-panel.tsx in tui.json"
     fi
@@ -190,7 +185,6 @@ install_tui_panel() {
       note "plugin dependencies already present in $PACKAGE_JSON"
       rm -f "$pkg_tmp"
     else
-      [ "$pkg_created" = 1 ] || cp -p "$PACKAGE_JSON" "$PACKAGE_JSON.bak.$(date +%Y%m%d%H%M%S)"
       mv "$pkg_tmp" "$PACKAGE_JSON"
       note "declared plugin dependencies in $PACKAGE_JSON (opencode installs them on next start)"
     fi

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencode-sesh",
-  "version": "0.11.0",
+  "version": "0.12.0",
   "description": "Browse, search, preview and resume opencode sessions from the terminal and the TUI.",
   "type": "module",
   "license": "MIT",

package/tui/sesh-panel.tsx

@@ -4,6 +4,7 @@ import type { Project, Session } from "@opencode-ai/sdk/v2"
 import { createEffect, createMemo, createSignal, For, onCleanup, onMount, Show } from "solid-js"
 import { mkdir, readFile, rename, rmdir, unlink, writeFile } from "node:fs/promises"
 import { dirname, join } from "node:path"
+import { spawn } from "node:child_process"
 import { getTreeSitterClient, RGBA, SyntaxStyle, TextAttributes } from "@opentui/core"
 
 type ThemeColors = TuiPluginApi["theme"]["current"]
@@ -250,6 +251,22 @@ type Entry = { id: string; title: string; dir: string; group: string; updated: n
 type EntryResult = { entries: Entry[]; truncated: boolean }
 type SidebarMarker = "current" | "running" | "idle"
 
+const RIGHT_BUTTON = 2
+
+function openInCmuxWorkspace(api: TuiPluginApi, entry: Entry) {
+  if (!process.env.CMUX_WORKSPACE_ID) {
+    api.ui.toast({ message: "Right-click opens a new workspace only inside cmux", variant: "info" })
+    return
+  }
+  const args = ["new-workspace", "--name", entry.title || entry.id, "--command", `opencode --session ${entry.id}`, "--focus", "true"]
+  if (entry.dir) args.push("--cwd", entry.dir)
+  const child = spawn("cmux", args, { stdio: "ignore" })
+  child.on("error", () => api.ui.toast({ message: "Could not open a cmux workspace", variant: "error" }))
+  child.on("exit", (code) => {
+    if (code) api.ui.toast({ message: "Could not open a cmux workspace", variant: "error" })
+  })
+}
+
 // Loading-spinner frames for the marker of a session whose agent is working.
 const SIDEBAR_SPINNER = ["⠋", "⠙", "⠹", "⠸", "⠼", "⠴", "⠦", "⠧", "⠇", "⠏"]
 
@@ -1013,8 +1030,47 @@ function SidebarSessions(props: { api: TuiPluginApi } & PinProps) {
   let disposeHoverSpace: (() => void) | undefined
   let disposeSearch: (() => void) | undefined
   let disposeNav: (() => void) | undefined
+  let disposeConfirm: (() => void) | undefined
   let insideSearchBox = false
 
+  createEffect(() => {
+    disposeConfirm?.()
+    disposeConfirm = undefined
+    if (!pendingDelete()) return
+    disposeConfirm = props.api.keymap.registerLayer({
+      mode: "base",
+      priority: 25,
+      bindings: [
+        {
+          key: "y",
+          desc: "Confirm delete",
+          preventDefault: true,
+          cmd: () => {
+            confirmArmed()
+          },
+        },
+        {
+          key: "ctrl+x",
+          desc: "Confirm delete",
+          preventDefault: true,
+          cmd: () => {
+            confirmArmed()
+          },
+        },
+        {
+          key: "enter",
+          desc: "Confirm delete",
+          preventDefault: true,
+          cmd: () => {
+            confirmArmed()
+          },
+        },
+        { key: "n", desc: "Cancel delete", preventDefault: true, cmd: cancelDelete },
+        { key: "escape", desc: "Cancel delete", preventDefault: true, cmd: cancelDelete },
+      ],
+    })
+  })
+
   const onRootMouseDown = () => {
     if (insideSearchBox) {
       insideSearchBox = false
@@ -1144,6 +1200,7 @@ function SidebarSessions(props: { api: TuiPluginApi } & PinProps) {
         desc: "Open session",
         preventDefault: true,
         cmd: () => {
+          if (confirmArmed()) return
           const entry = itemRows()[cursor()]
           if (entry) void openSession(entry)
         },
@@ -1178,6 +1235,7 @@ function SidebarSessions(props: { api: TuiPluginApi } & PinProps) {
     disposeHoverSpace?.()
     disposeSearch?.()
     disposeNav?.()
+    disposeConfirm?.()
     if (confirmTimer) clearTimeout(confirmTimer)
   })
 
@@ -1278,7 +1336,9 @@ function SidebarSessions(props: { api: TuiPluginApi } & PinProps) {
                   }
                 }}
                 onMouseOut={() => setHovered(undefined)}
-                onMouseDown={() => void openSession(row.entry)}
+                onMouseDown={(event: { button?: number }) =>
+                  event.button === RIGHT_BUTTON ? openInCmuxWorkspace(props.api, row.entry) : void openSession(row.entry)
+                }
               >
                 <text flexShrink={0}>
                   <span style={{ fg: theme().textMuted }}>{row.last ? "└" : "├"}</span>
@@ -1337,11 +1397,89 @@ function HomeSessions(props: { api: TuiPluginApi } & PinProps) {
   const [hovered, setHovered] = createSignal<string>()
   const [searching, setSearching] = createSignal(false)
   const [loadFailed, setLoadFailed] = createSignal(false)
+  const [pendingDelete, setPendingDelete] = createSignal<string>()
+  const [deleting, setDeleting] = createSignal<string>()
+  let confirmTimer: ReturnType<typeof setTimeout> | undefined
+  let disposeConfirm: (() => void) | undefined
   const preview = createTranscriptPreview(props.api)
   let disposeHoverSpace: (() => void) | undefined
   let disposeSearch: (() => void) | undefined
   let insideSearchBox = false
 
+  const cancelDelete = () => {
+    if (confirmTimer) clearTimeout(confirmTimer)
+    confirmTimer = undefined
+    disposeConfirm?.()
+    disposeConfirm = undefined
+    setPendingDelete(undefined)
+  }
+
+  const confirmArmed = (): boolean => {
+    const id = pendingDelete()
+    if (!id) return false
+    const entry = entries().find((e) => e.id === id)
+    if (!entry) cancelDelete()
+    else void deleteEntry(entry)
+    return true
+  }
+
+  const requestDelete = (entry: Entry) => {
+    if (deleting()) return
+    if (pendingDelete() === entry.id) {
+      void deleteEntry(entry)
+      return
+    }
+    setPendingDelete(entry.id)
+    if (confirmTimer) clearTimeout(confirmTimer)
+    confirmTimer = setTimeout(() => setPendingDelete(undefined), 5000)
+  }
+
+  const deleteEntry = async (entry: Entry) => {
+    cancelDelete()
+    if (deleting()) return
+    setDeleting(entry.id)
+    try {
+      const result = await props.api.client.session.delete({
+        sessionID: entry.id,
+        directory: entry.dir || undefined,
+      })
+      if (result && "error" in result && result.error) throw result.error
+      const { entries: remaining } = await fetchEntries(props.api)
+      if (remaining.some((item) => item.id === entry.id)) {
+        setEntries(remaining)
+        props.api.ui.toast({ message: "Session was not deleted", variant: "error" })
+        return
+      }
+      setEntries(remaining)
+      setHovered(undefined)
+      props.api.ui.toast({ message: `Deleted "${truncate(entry.title, 40)}"`, variant: "info" })
+      if ("params" in props.api.route.current && (props.api.route.current.params as any)?.sessionID === entry.id) {
+        props.api.route.navigate("home")
+      }
+    } catch {
+      props.api.ui.toast({ message: "Could not delete session", variant: "error" })
+    } finally {
+      setDeleting(undefined)
+    }
+  }
+
+  createEffect(() => {
+    disposeConfirm?.()
+    disposeConfirm = undefined
+    if (!pendingDelete()) return
+    disposeConfirm = props.api.keymap.registerLayer({
+      mode: "base",
+      priority: 25,
+      bindings: [
+        { key: "y", desc: "Confirm delete", preventDefault: true, cmd: () => { confirmArmed() } },
+        { key: "ctrl+x", desc: "Confirm delete", preventDefault: true, cmd: () => { confirmArmed() } },
+        { key: "enter", desc: "Confirm delete", preventDefault: true, cmd: () => { confirmArmed() } },
+        { key: "n", desc: "Cancel delete", preventDefault: true, cmd: cancelDelete },
+        { key: "escape", desc: "Cancel delete", preventDefault: true, cmd: cancelDelete },
+      ],
+    })
+  })
+
   const onRootMouseDown = () => {
     if (insideSearchBox) {
       insideSearchBox = false
@@ -1389,14 +1527,26 @@ function HomeSessions(props: { api: TuiPluginApi } & PinProps) {
           preventDefault: true,
           cmd: () => preview.open(entry),
         },
+        {
+          key: "ctrl+x",
+          desc: "Delete session",
+          preventDefault: true,
+          cmd: () => {
+            if (!confirmArmed()) requestDelete(entry)
+          },
+        },
         { key: "ctrl+s", desc: "Pin session", preventDefault: true, cmd: () => props.onTogglePin("sessions", entry.id) },
         { key: "ctrl+d", desc: "Pin directory", preventDefault: true, cmd: () => props.onTogglePin("directories", entry.dir) },
       ],
     })
   })
 
-  onCleanup(() => disposeSearch?.())
-  onCleanup(() => disposeHoverSpace?.())
+  onCleanup(() => {
+    disposeSearch?.()
+    disposeHoverSpace?.()
+    disposeConfirm?.()
+    if (confirmTimer) clearTimeout(confirmTimer)
+  })
 
   onMount(() => {
     let alive = true
@@ -1486,7 +1636,11 @@ function HomeSessions(props: { api: TuiPluginApi } & PinProps) {
               backgroundColor={entry.id === hovered() ? theme().backgroundElement : RGBA.fromInts(0, 0, 0, 0)}
               onMouseOver={() => setHovered(entry.id)}
               onMouseOut={() => setHovered(undefined)}
-              onMouseDown={() => props.api.route.navigate("session", { sessionID: entry.id })}
+              onMouseDown={(event: { button?: number }) =>
+                event.button === RIGHT_BUTTON
+                  ? openInCmuxWorkspace(props.api, entry)
+                  : props.api.route.navigate("session", { sessionID: entry.id })
+              }
             >
               <text flexShrink={0} style={{ fg: theme().textMuted }}>
                 ○
@@ -1497,8 +1651,10 @@ function HomeSessions(props: { api: TuiPluginApi } & PinProps) {
                 color={theme().text}
                 matchColor={theme().warning}
               />
-              <text flexShrink={0} style={{ fg: theme().textMuted }}>
-                {props.pins().directories.includes(entry.dir) ? "★ " : ""}{prettyDir(entry.dir, home)} · {ago(entry.updated)}
+              <text flexShrink={0} style={{ fg: pendingDelete() === entry.id ? theme().error : theme().textMuted }}>
+                {pendingDelete() === entry.id
+                  ? "ctrl+x again"
+                  : `${props.pins().directories.includes(entry.dir) ? "★ " : ""}${prettyDir(entry.dir, home)} · ${ago(entry.updated)}`}
               </text>
             </box>
           )}
@@ -1789,12 +1945,22 @@ const tui: TuiPlugin = async (api) => {
     // Delete confirmation lives in its own layer, registered only while a row
     // is armed, so y/n never shadow the search box's typing.
     let disposeConfirm: (() => void) | undefined
+    let confirmTimer: ReturnType<typeof setTimeout> | undefined
     const cancelDelete = () => {
+      if (confirmTimer) clearTimeout(confirmTimer)
+      confirmTimer = undefined
       disposeConfirm?.()
       disposeConfirm = undefined
       setPendingDelete(undefined)
     }
 
+    const confirmArmed = (): boolean => {
+      const armed = pendingDelete()
+      if (!armed) return false
+      void deleteEntry(armed)
+      return true
+    }
+
     // Escape first closes the transcript overlay, then the picker. One Escape
     // can reach both the focused search input and the key layer (sometimes in
     // separate ticks), so ignore the duplicate that trails right behind.
@@ -1807,6 +1973,11 @@ const tui: TuiPlugin = async (api) => {
         escapeHandledAt = now + 150
         return
       }
+      if (pendingDelete()) {
+        cancelDelete()
+        escapeHandledAt = now + 150
+        return
+      }
       cancelDelete()
       close()
     }
@@ -1827,6 +1998,7 @@ const tui: TuiPlugin = async (api) => {
         }
         setAllEntries(remaining)
         api.ui.toast({ message: `Deleted "${truncate(entry.title, 40)}"`, variant: "info" })
+        if (currentSessionID() === entry.id) api.route.navigate("home")
       } catch {
         api.ui.toast({ message: "Could not delete session", variant: "error" })
       }
@@ -1834,19 +2006,38 @@ const tui: TuiPlugin = async (api) => {
 
     const armDelete = (entry: Entry) => {
       setPendingDelete(entry)
+      if (confirmTimer) clearTimeout(confirmTimer)
+      confirmTimer = setTimeout(cancelDelete, 5000)
       disposeConfirm?.()
       disposeConfirm = api.keymap.registerLayer({
+        priority: 20,
         bindings: [
           {
             key: "y",
             desc: "Confirm delete",
             preventDefault: true,
             cmd: () => {
-              const armed = pendingDelete()
-              if (armed) void deleteEntry(armed)
+              confirmArmed()
+            },
+          },
+          {
+            key: "ctrl+x",
+            desc: "Confirm delete",
+            preventDefault: true,
+            cmd: () => {
+              confirmArmed()
+            },
+          },
+          {
+            key: "enter",
+            desc: "Confirm delete",
+            preventDefault: true,
+            cmd: () => {
+              confirmArmed()
             },
           },
           { key: "n", desc: "Cancel delete", preventDefault: true, cmd: cancelDelete },
+          { key: "escape", desc: "Cancel delete", preventDefault: true, cmd: cancelDelete },
         ],
       })
     }
@@ -1892,7 +2083,15 @@ const tui: TuiPlugin = async (api) => {
           preventDefault: true,
           cmd: () => selectCursor(selectableEntries().length - 1),
         },
-        { key: "enter", desc: "Open session", preventDefault: true, cmd: () => choose() },
+        {
+          key: "enter",
+          desc: "Open session",
+          preventDefault: true,
+          cmd: () => {
+            if (confirmArmed()) return
+            choose()
+          },
+        },
         { key: "option+p", desc: "Toggle transcript preview", preventDefault: true, cmd: togglePreview },
         { key: "ctrl+s", desc: "Pin session", preventDefault: true, cmd: () => {
           const entry = selectableEntries()[cursor()]
@@ -1907,11 +2106,9 @@ const tui: TuiPlugin = async (api) => {
           desc: "Delete session",
           preventDefault: true,
           cmd: () => {
+            if (confirmArmed()) return
             const target = selectableEntries()[cursor()]
-            if (!target) return
-            const armed = pendingDelete()
-            if (armed && armed.id === target.id) void deleteEntry(target)
-            else armDelete(target)
+            if (target) armDelete(target)
           },
         },
         {
@@ -1946,6 +2143,7 @@ const tui: TuiPlugin = async (api) => {
 
     const cleanup = () => {
       alive = false
+      if (confirmTimer) clearTimeout(confirmTimer)
       pickerState = { query: query(), scope: scope(), waitingOnly: waitingOnly(), pinnedOnly: pinnedOnly() }
       disposeNav()
       disposeConfirm?.()
@@ -1981,12 +2179,31 @@ const tui: TuiPlugin = async (api) => {
                 focusedBackgroundColor={api.theme.current.backgroundPanel}
                 focusedTextColor={api.theme.current.text}
                 cursorColor={api.theme.current.primary}
-                onInput={setQuery}
-                onSubmit={() => choose()}
+                onInput={(value) => {
+                  if (pendingDelete()) return
+                  setQuery(value)
+                }}
+                onSubmit={() => {
+                  if (confirmArmed()) return
+                  choose()
+                }}
                 onKeyDown={(event) => {
                   if (event.name === "escape") {
                     event.preventDefault()
                     handleEscape()
+                    return
+                  }
+                  if (pendingDelete()) {
+                    if (event.name === "y" || (event.ctrl && event.name === "x") || event.name === "enter" || event.name === "return") {
+                      event.preventDefault()
+                      confirmArmed()
+                      return
+                    }
+                    if (event.name === "n") {
+                      event.preventDefault()
+                      cancelDelete()
+                      return
+                    }
                   }
                 }}
               />
@@ -2048,7 +2265,9 @@ const tui: TuiPlugin = async (api) => {
                         const index = selectableEntries().findIndex((entry) => entry.id === row.entry.id)
                         if (index >= 0) setCursor(index)
                       }}
-                      onMouseDown={() => choose(row.entry)}
+                      onMouseDown={(event: { button?: number }) =>
+                        event.button === RIGHT_BUTTON ? (cleanup(), api.ui.dialog.clear(), openInCmuxWorkspace(api, row.entry)) : choose(row.entry)
+                      }
                     >
                       <box flexDirection="row" gap={1}>
                       <text flexShrink={0} style={{ fg: row.entry.id === selectableEntries()[cursor()]?.id