opencode-sesh 0.11.1 → 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,16 @@ 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
@@ -378,7 +388,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.
 
-[Unreleased]: https://github.com/ozandogrultan/opencode-sesh/compare/v0.11.1...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

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.1",
+  "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 = ["⠋", "⠙", "⠹", "⠸", "⠼", "⠴", "⠦", "⠧", "⠇", "⠏"]
 
@@ -1319,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>
@@ -1617,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 }}>
                 ○
@@ -2242,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