opencode-sesh 0.11.1 → 0.13.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,25 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.13.0] - 2026-09-30
+
+### Changed
+
+- Right-clicking a session in the TUI sidebar opens a floating menu at the click
+  with Open, Preview transcript, Open in new cmux workspace (inside cmux), Fork,
+  Pin/Unpin and Delete (with confirmation). It stays inside the terminal, moves
+  with ↑/↓/Enter, and closes on Esc or a click elsewhere. The home list and
+  picker keep the direct cmux action.
+## [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 +397,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.1...HEAD
+[Unreleased]: https://github.com/ozandogrultan/opencode-sesh/compare/v0.13.0...HEAD
+[0.13.0]: https://github.com/ozandogrultan/opencode-sesh/compare/v0.12.0...v0.13.0
+[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,12 @@ 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 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
+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
 elsewhere or press Esc to leave search. Click the **Sessions** heading to drive
@@ -228,7 +234,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.13.0",
   "description": "Browse, search, preview and resume opencode sessions from the terminal and the TUI.",
   "type": "module",
   "license": "MIT",

package/tui/sesh-panel.tsx

@@ -1,10 +1,12 @@
 /** @jsxImportSource @opentui/solid */
 import type { TuiPlugin, TuiPluginApi } from "@opencode-ai/plugin/tui"
 import type { Project, Session } from "@opencode-ai/sdk/v2"
-import { createEffect, createMemo, createSignal, For, onCleanup, onMount, Show } from "solid-js"
+import { createEffect, createMemo, createSignal, For, on, 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"
+import { Portal } from "@opentui/solid"
 
 type ThemeColors = TuiPluginApi["theme"]["current"]
 
@@ -250,6 +252,145 @@ type Entry = { id: string; title: string; dir: string; group: string; updated: n
 type EntryResult = { entries: Entry[]; truncated: boolean }
 type SidebarMarker = "current" | "running" | "idle"
 
+const LEFT_BUTTON = 0
+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" })
+  })
+}
+
+type MenuAction = "open" | "preview" | "workspace" | "fork" | "pin" | "delete" | "confirm" | "cancel"
+type MenuItem = { id: MenuAction; label: string }
+type MenuState = { entry: Entry; x: number; y: number; items: MenuItem[]; index: number; confirming: boolean }
+type MenuLayer = {
+  mode: "base"
+  priority: number
+  bindings: { key: string; desc: string; preventDefault: boolean; cmd: () => void }[]
+}
+type ContextMenuHost = {
+  registerLayer: (layer: MenuLayer) => () => void
+  actions: Record<"open" | "preview" | "workspace" | "fork" | "pin" | "delete", (entry: Entry) => void>
+  pinned: (entry: Entry) => boolean
+  cmux: () => boolean
+  blocked: () => boolean
+  onChange: (state: MenuState | undefined) => void
+}
+
+const CONTEXT_MENU_LAYER_PRIORITY = 30
+
+function contextMenuItems(pinned: boolean, cmux: boolean): MenuItem[] {
+  return [
+    { id: "open", label: "Open" },
+    { id: "preview", label: "Preview transcript" },
+    ...(cmux ? [{ id: "workspace" as const, label: "Open in new cmux workspace" }] : []),
+    { id: "fork", label: "Fork" },
+    { id: "pin", label: pinned ? "Unpin" : "Pin" },
+    { id: "delete", label: "Delete" },
+  ]
+}
+
+function contextMenuSize(items: MenuItem[]): { width: number; height: number } {
+  return { width: Math.max(...items.map((item) => item.label.length)) + 4, height: items.length + 2 }
+}
+
+function contextMenuBox(
+  anchor: { x: number; y: number; width: number; height: number },
+  cols: number,
+  rows: number,
+): { left: number; top: number; width: number; height: number } {
+  const width = Math.max(1, Math.min(anchor.width, cols))
+  const height = Math.max(1, Math.min(anchor.height, rows))
+  const left = Math.max(0, Math.min(anchor.x, cols - width))
+  const below = anchor.y + 1
+  const top = below + height <= rows ? below : Math.max(0, anchor.y - height)
+  return { left, top, width, height }
+}
+
+function createContextMenu(host: ContextMenuHost) {
+  let state: MenuState | undefined
+  let dispose: (() => void) | undefined
+
+  const publish = (next: MenuState | undefined) => {
+    state = next
+    host.onChange(next)
+  }
+
+  const close = () => {
+    dispose?.()
+    dispose = undefined
+    if (state) publish(undefined)
+  }
+
+  const select = (index: number) => {
+    if (state) publish({ ...state, index: Math.max(0, Math.min(state.items.length - 1, index)) })
+  }
+
+  const move = (delta: number) => {
+    if (!state) return
+    const count = state.items.length
+    publish({ ...state, index: (state.index + delta + count) % count })
+  }
+
+  const activate = (index?: number) => {
+    if (!state) return
+    const current = state
+    const item = current.items[index ?? current.index]
+    if (!item) return
+    if (item.id === "delete") {
+      publish({
+        ...current,
+        confirming: true,
+        items: [
+          { id: "confirm", label: "Confirm delete" },
+          { id: "cancel", label: "Cancel" },
+        ],
+        index: 1,
+      })
+      return
+    }
+    close()
+    if (item.id === "confirm") host.actions.delete(current.entry)
+    else if (item.id !== "cancel") host.actions[item.id](current.entry)
+  }
+
+  const click = (index: number, button?: number) => {
+    if ((button ?? LEFT_BUTTON) === LEFT_BUTTON) activate(index)
+  }
+
+  const guarded = (run: () => void) => () => {
+    if (host.blocked()) close()
+    else run()
+  }
+
+  const open = (entry: Entry, x: number, y: number) => {
+    if (host.blocked()) return
+    publish({ entry, x, y, items: contextMenuItems(host.pinned(entry), host.cmux()), index: 0, confirming: false })
+    if (dispose) return
+    dispose = host.registerLayer({
+      mode: "base",
+      priority: CONTEXT_MENU_LAYER_PRIORITY,
+      bindings: [
+        { key: "up", desc: "Previous menu item", preventDefault: true, cmd: guarded(() => move(-1)) },
+        { key: "down", desc: "Next menu item", preventDefault: true, cmd: guarded(() => move(1)) },
+        { key: "enter", desc: "Choose menu item", preventDefault: true, cmd: guarded(() => activate()) },
+        { key: "escape", desc: "Close menu", preventDefault: true, cmd: close },
+      ],
+    })
+  }
+
+  return { open, close, select, activate, click, current: () => state }
+}
+
 // Loading-spinner frames for the marker of a session whose agent is working.
 const SIDEBAR_SPINNER = ["⠋", "⠙", "⠹", "⠸", "⠼", "⠴", "⠦", "⠧", "⠇", "⠏"]
 
@@ -767,6 +908,14 @@ function pickerLastStart(rows: PickerRow[], height: number, excerpt: (entry: Ent
   return start
 }
 
+type PortalContainer = {
+  position?: string
+  left?: number
+  top?: number
+  zIndex?: number
+  destroyRecursively?: () => void
+}
+
 type PinProps = { pins: () => Pins; onTogglePin: (kind: keyof Pins, value: string) => void; refreshPins: () => void }
 
 function SidebarSessions(props: { api: TuiPluginApi } & PinProps) {
@@ -785,6 +934,8 @@ function SidebarSessions(props: { api: TuiPluginApi } & PinProps) {
   const [cursor, setCursor] = createSignal(0)
   const [pendingDelete, setPendingDelete] = createSignal<string>()
   const [waiting, setWaiting] = createSignal<Map<string, string>>(new Map())
+  const [menuState, setMenuState] = createSignal<MenuState>()
+  let portalContainer: PortalContainer | undefined
   let confirmTimer: ReturnType<typeof setTimeout> | undefined
   const currentID = createMemo(() => {
     const route = props.api.route.current
@@ -890,6 +1041,7 @@ function SidebarSessions(props: { api: TuiPluginApi } & PinProps) {
   }
 
   const toggleSection = () => {
+    menu.close()
     if (!sectionCollapsed()) {
       cancelDelete()
       setNavActive(false)
@@ -901,6 +1053,47 @@ function SidebarSessions(props: { api: TuiPluginApi } & PinProps) {
 
   const openSession = (entry: Entry) => props.api.route.navigate("session", { sessionID: entry.id })
 
+  const forkEntry = async (entry: Entry) => {
+    try {
+      const result = await props.api.client.session.fork({
+        sessionID: entry.id,
+        directory: entry.dir || undefined,
+      })
+      const created = (result?.data ?? result) as Session | undefined
+      if (!created?.id) throw new Error("fork returned no session")
+      props.api.route.navigate("session", { sessionID: created.id })
+      props.api.ui.toast({ message: `Forked "${truncate(entry.title, 40)}"`, variant: "info" })
+    } catch {
+      props.api.ui.toast({ message: "Could not fork session", variant: "error" })
+    }
+  }
+
+  const menu = createContextMenu({
+    registerLayer: (layer) => props.api.keymap.registerLayer(layer),
+    actions: {
+      open: (entry) => void openSession(entry),
+      preview: (entry) => preview.open(entry),
+      workspace: (entry) => openInCmuxWorkspace(props.api, entry),
+      fork: (entry) => void forkEntry(entry),
+      pin: (entry) => props.onTogglePin("sessions", entry.id),
+      delete: (entry) => void deleteEntry(entry),
+    },
+    pinned: (entry) => props.pins().sessions.includes(entry.id),
+    cmux: () => Boolean(process.env.CMUX_WORKSPACE_ID),
+    blocked: () => props.api.ui.dialog.open,
+    onChange: setMenuState,
+  })
+
+  const menuBox = createMemo(() => {
+    const state = menuState()
+    if (!state) return undefined
+    return contextMenuBox(
+      { x: state.x, y: state.y, ...contextMenuSize(state.items) },
+      props.api.renderer.width,
+      props.api.renderer.height,
+    )
+  })
+
   // Flat order of the rows a cursor can land on, so keyboard navigation and
   // mouse hover resolve to the same row.
   const itemRows = createMemo(() => tree().flatMap((row) => (row.kind === "item" ? [row.entry] : [])))
@@ -921,6 +1114,20 @@ function SidebarSessions(props: { api: TuiPluginApi } & PinProps) {
     previousRows = rows
   })
 
+  const routeKey = createMemo(() => {
+    const route = props.api.route.current
+    const id = route.name === "session" && typeof route.params?.sessionID === "string" ? route.params.sessionID : ""
+    return `${route.name}:${id}`
+  })
+  createEffect(on(routeKey, () => menu.close(), { defer: true }))
+  createEffect(() => {
+    const state = menuState()
+    if (state && !itemRows().some((entry) => entry.id === state.entry.id)) menu.close()
+  })
+  createEffect(() => {
+    if (props.api.ui.dialog.open) menu.close()
+  })
+
   // Marker only: a spinner for a working agent, the open-session dot, and the
   // neutral row for idle sessions. Titles stay plain and no status text is
   // rendered.
@@ -1055,6 +1262,7 @@ function SidebarSessions(props: { api: TuiPluginApi } & PinProps) {
   })
 
   const onRootMouseDown = () => {
+    menu.close()
     if (insideSearchBox) {
       insideSearchBox = false
       return
@@ -1065,7 +1273,12 @@ function SidebarSessions(props: { api: TuiPluginApi } & PinProps) {
   onMount(() => {
     ensureRootMouse(props.api.renderer)
     rootMouseHandlers.add(onRootMouseDown)
-    onCleanup(() => rootMouseHandlers.delete(onRootMouseDown))
+    const closeMenu = () => menu.close()
+    props.api.renderer.on("resize", closeMenu)
+    onCleanup(() => {
+      rootMouseHandlers.delete(onRootMouseDown)
+      props.api.renderer.off("resize", closeMenu)
+    })
   })
 
   const appendQuery = (input: string) => {
@@ -1219,6 +1432,10 @@ function SidebarSessions(props: { api: TuiPluginApi } & PinProps) {
     disposeSearch?.()
     disposeNav?.()
     disposeConfirm?.()
+    menu.close()
+    const container = portalContainer
+    portalContainer = undefined
+    process.nextTick(() => container?.destroyRecursively?.())
     if (confirmTimer) clearTimeout(confirmTimer)
   })
 
@@ -1282,6 +1499,7 @@ function SidebarSessions(props: { api: TuiPluginApi } & PinProps) {
           flexShrink={1}
           verticalScrollbarOptions={{ visible: false }}
           horizontalScrollbarOptions={{ visible: false }}
+          onMouseScroll={() => menu.close()}
         >
           <For each={tree()}>
           {(row) => {
@@ -1319,7 +1537,12 @@ function SidebarSessions(props: { api: TuiPluginApi } & PinProps) {
                   }
                 }}
                 onMouseOut={() => setHovered(undefined)}
-                onMouseDown={() => void openSession(row.entry)}
+                onMouseDown={(event: { button?: number; x: number; y: number; stopPropagation: () => void }) => {
+                  if (event.button === RIGHT_BUTTON) {
+                    event.stopPropagation()
+                    menu.open(row.entry, event.x, event.y)
+                  } else void openSession(row.entry)
+                }}
               >
                 <text flexShrink={0}>
                   <span style={{ fg: theme().textMuted }}>{row.last ? "└" : "├"}</span>
@@ -1364,6 +1587,62 @@ function SidebarSessions(props: { api: TuiPluginApi } & PinProps) {
         </Show>
       </Show>
       </Show>
+      <Portal
+        mount={props.api.renderer.root as never}
+        ref={(container: PortalContainer) => {
+          portalContainer = container
+          container.position = "absolute"
+          container.left = 0
+          container.top = 0
+          container.zIndex = 1000
+        }}
+      >
+        <Show when={menuState()}>
+          <box
+            position="absolute"
+            left={menuBox()!.left}
+            top={menuBox()!.top}
+            width={menuBox()!.width}
+            height={menuBox()!.height}
+            flexDirection="column"
+            border
+            borderStyle="rounded"
+            borderColor={theme().borderActive}
+            backgroundColor={theme().backgroundPanel}
+            paddingLeft={1}
+            paddingRight={1}
+            onMouseDown={(event: { stopPropagation: () => void }) => event.stopPropagation()}
+          >
+            <For each={menuState()!.items}>
+              {(item, index) => (
+                <box
+                  height={1}
+                  backgroundColor={menuState()!.index === index() ? theme().backgroundElement : RGBA.fromInts(0, 0, 0, 0)}
+                  onMouseOver={() => menu.select(index())}
+                  onMouseDown={(event: { button?: number; stopPropagation: () => void }) => {
+                    event.stopPropagation()
+                    menu.click(index(), event.button)
+                  }}
+                >
+                  <text
+                    wrapMode="none"
+                    style={{
+                      fg:
+                        item.id === "delete" || item.id === "confirm"
+                          ? theme().error
+                          : menuState()!.index === index()
+                            ? theme().text
+                            : theme().textMuted,
+                    }}
+                  >
+                    {item.label}
+                  </text>
+                </box>
+              )}
+            </For>
+          </box>
+        </Show>
+      </Portal>
     </box>
   )
 }
@@ -1617,7 +1896,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 +2525,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