opencode-sesh 0.7.2 → 0.8.0

package/AGENTS.md

@@ -139,34 +139,16 @@ Resume happens in place (`exec` after `cd` to the session's cwd).
 ## TUI panel (`tui/sesh-panel.tsx`)
 
 - **Sidebar:** `api.slots.register` on `sidebar_content` (append mode — native
-  sidebar content stays). Renders pinned sessions before the newest unarchived
-  sessions, with the current one highlighted, polled every 15 s; Ctrl-P previews
+  sidebar content stays). Pinned directories sort first, then directory groups
+  by recency; sessions within each group sort by last update regardless of pins.
+  Waiting, running, and current-idle sessions have distinct title colors and
+  text labels (in addition to row markers), polled every 15 s; Ctrl-P previews
   a row and ctrl+x deletes one (armed, then confirmed). The 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
   **Needs input** group above the directories, with the count in the heading —
   same `NEEDS_INPUT_SQL` heuristic as `bin/sesh-waiting.sh`.
-- **cmux bridge (cmux-only, opt-out by absence).** When `CMUX_WORKSPACE_ID` is
-  set the sidebar talks to the `cmux` CLI; outside cmux no cmux call is made and
-  every click opens locally. Two behaviors, both keyed on cmux's *own* per-
-  surface resume record (`cmux surface resume show` → `restore_record.
-  checkpoint_id`), not on anything sesh writes:
-  - **Click-to-focus.** `pickFocusWorkspace` (pure, covered by `tests/tui.mjs`)
-    scans `cmux tree --json --all` plus each surface's checkpoint and, when
-    another workspace runs the clicked session, runs
-    `cmux workspace select <ref>` instead of `api.route.navigate`. The caller's
-    own surface/workspace never match (a same-workspace focus is a no-op, so it
-    opens locally). Works for background agents and older panels too.
-  - **Workspace naming.** The poll renames this workspace to the current
-    session title (`cmux workspace rename <id> --title …`), skipping titles that
-    must never name a workspace: the pre-first-turn placeholder
-    (`/^New session\b/`) and plugin sentinels (`ghost-hidden`, which
-    opencode-ghost titles its internal sessions). `bin/sesh-cmux-sync.sh` does
-    the same for every workspace at once. The session title is the source of
-    truth; a manual cmux rename is overwritten on the next session-title change.
-  These are the only cmux calls in the panel; keep them behind the
-  `CMUX_WORKSPACE_ID` guard.
 - **Picker:** a custom dialog (not `DialogSelect`) grouped by
   project/directory, recency-ordered, resume via
   `api.route.navigate("session", …)`. `ctrl+o` and the command palette open it;

package/CHANGELOG.md

@@ -7,6 +7,21 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.8.0] - 2026-09-24
+
+### Changed
+
+- Sidebar and picker sessions within each directory now sort by last update,
+  newest first, even when a session is pinned. Sidebar titles and labels make
+  waiting, running, and currently open idle sessions distinguishable at a glance.
+## [0.7.3] - 2026-09-24
+
+### Removed
+
+- The cmux bridge, panel and CLI. Click-to-focus, the sidebar's workspace
+  renaming, and the `sesh cmux-sync` command (with `bin/sesh-cmux-sync.sh`) are
+  gone: cmux already tracks each surface's session and names workspaces, so sesh
+  no longer shells out to the `cmux` CLI at all.
 ## [0.7.2] - 2026-09-24
 
 ### Fixed
@@ -318,7 +333,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.7.2...HEAD
+[Unreleased]: https://github.com/ozandogrultan/opencode-sesh/compare/v0.8.0...HEAD
+[0.8.0]: https://github.com/ozandogrultan/opencode-sesh/compare/v0.7.3...v0.8.0
+[0.7.3]: https://github.com/ozandogrultan/opencode-sesh/compare/v0.7.2...v0.7.3
 [0.7.2]: https://github.com/ozandogrultan/opencode-sesh/compare/v0.7.1...v0.7.2
 [0.7.1]: https://github.com/ozandogrultan/opencode-sesh/compare/v0.7.0...v0.7.1
 [0.7.0]: https://github.com/ozandogrultan/opencode-sesh/compare/v0.6.0...v0.7.0

package/README.md

@@ -145,10 +145,6 @@ per-project record.
 (`New session - …`) with the start of the session's first user message. Only
 placeholder titles are touched, and the same dry-run/`--yes` gating applies.
 
-`sesh cmux-sync [--dry-run] [--json]` names every [cmux](https://cmux.dev)
-workspace after the opencode session its pane is running, so the sidebar and the
-workspace list agree. cmux-only; a no-op without the cmux CLI.
-
 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.
@@ -186,16 +182,17 @@ 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
 the list from the keyboard instead of the mouse (`↑`/`↓` to move, Enter to open,
 Ctrl-P to preview, Option-S/Option-D to pin, Ctrl-X to delete, Esc to leave). Pinned
-sessions appear ahead of the rest; the section lists every session and scrolls
-to fill the sidebar, so click **▾ hide** to collapse it when you need the room.
+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.
 Sessions waiting on you (unanswered agent questions, runs stuck mid-tool) pin
 themselves to a **Needs input** group above the directories, with the count in
-the heading; `sesh --needs-input` lists the same set in the terminal.
+the heading; `sesh --needs-input` lists the same set in the terminal. Row titles
+and labels mark waiting (warning), running (success), and the current idle
+session (accent); other sessions stay neutral.
 Hovering a row while keyboard navigation is active selects it for the next
-shortcut. Clicking (or Enter on) a session opens it here — unless another cmux
-workspace is already running that session, in which case the sidebar focuses
-that workspace instead of opening a duplicate (and the workspace is kept named
-after its session). The full picker is one keystroke away.
+shortcut. Clicking (or Enter on) a session opens it here. The full picker is one
+keystroke away.
 
 The full picker pages through your whole global session list (no fixed window)
 and indexes transcript text for every session in the background, showing

package/bin/sesh

@@ -34,9 +34,5 @@ case ${1:-} in
     shift
     exec bash "$SCRIPT_DIR/sesh-retitle.sh" "$@"
     ;;
-  cmux-sync)
-    shift
-    exec bash "$SCRIPT_DIR/sesh-cmux-sync.sh" "$@"
-    ;;
 esac
 exec "$SCRIPT_DIR/sesh.sh" "$@"

package/contrib/cmux/README.md

@@ -37,16 +37,9 @@ caller-side on purpose, so sesh stays terminal-agnostic.
 
 ## Keep workspace names in step
 
-The sidebar renames its workspace to the opencode session title as you work, and
-`sesh cmux-sync` does it for every workspace at once:
-
-```bash
-sesh cmux-sync --dry-run   # preview
-sesh cmux-sync             # rename to match
-```
-
-It reads cmux's own per-surface resume record, so it also names workspaces whose
-agent was started outside the sidebar.
+sesh no longer renames workspaces — that's cmux's own concern (its auto-naming,
+or a title-mirroring hook on the session title). The sidebar only shows the
+session; naming stays caller-side like everything else here.
 
 ## Needs-input triage from cmux
 

package/install.sh

@@ -235,7 +235,6 @@ for path in \
   bin/sesh.sh \
   bin/sesh-list.sh \
   bin/sesh-preview.sh \
-  bin/sesh-cmux-sync.sh \
   bin/sesh-costs.sh \
   bin/sesh-delete.sh \
   bin/sesh-prune.sh \

package/package.json

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

package/tui/sesh-panel.tsx

@@ -4,8 +4,6 @@ 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 { execFile } from "node:child_process"
-import { promisify } from "node:util"
 import { getTreeSitterClient, RGBA, SyntaxStyle, TextAttributes } from "@opentui/core"
 
 type ThemeColors = TuiPluginApi["theme"]["current"]
@@ -177,10 +175,6 @@ function pinnedFirst(entries: Entry[], pins: Pins): Entry[] {
 // dialog). Native `/sessions` and session_list (<leader>l) stay untouched.
 const BASE_MODE = "base"
 const POLL_MS = 15_000
-// Titles that must never become a cmux workspace name: opencode's pre-first-
-// turn placeholder, and the sentinel other plugins (opencode-ghost) use for
-// internal sessions so their scaffolding rows stay out of the UI.
-const PLACEHOLDER_TITLE = /^New session\b|^ghost-hidden$/i
 
 function shortDir(dir: string, home: string): string {
   if (!dir || dir === "/") return "other"
@@ -254,6 +248,20 @@ function ensureRootMouse(renderer: TuiPluginApi["renderer"]) {
 
 type Entry = { id: string; title: string; dir: string; group: string; updated: number }
 type EntryResult = { entries: Entry[]; truncated: boolean }
+type SidebarActivity = "waiting" | "running" | "active" | "idle"
+
+function newestFirst(entries: Entry[]): Entry[] {
+  return [...entries].sort((a, b) => b.updated - a.updated || a.id.localeCompare(b.id))
+}
+
+// A question needs an answer even if the agent is busy. A stale running-tool
+// record, on the other hand, must not hide a currently busy agent.
+function sidebarActivity(current: boolean, live?: string, pending = false, reason?: string): SidebarActivity {
+  if (pending || reason === "question") return "waiting"
+  if (live === "busy" || live === "retry") return "running"
+  if (reason === "stuck") return "waiting"
+  return current ? "active" : "idle"
+}
 
 const SESSION_PAGE_LIMIT = 200
 const SESSION_MAX = 5000
@@ -394,96 +402,6 @@ async function queryWaitingIds(db: any): Promise<Map<string, string>> {
   return out
 }
 
-// cmux bridge: which surface is running which agent session, so opening a
-// session that is live in another cmux workspace focuses that workspace
-// instead of opening a duplicate here. The truth is cmux's own resume record
-// (`checkpoint_id` per surface), not anything this panel writes — so it also
-// covers background agents and panes running an older panel. Outside cmux
-// (no CMUX_WORKSPACE_ID) no cmux call is made.
-type CmuxSurface = { ref: string; workspaceRef: string; here: boolean; checkpoint?: string }
-
-async function cmuxJson(args: string[]): Promise<any | undefined> {
-  try {
-    const { stdout } = await promisify(execFile)("cmux", args)
-    return JSON.parse(stdout)
-  } catch {
-    return undefined
-  }
-}
-
-async function cmuxSurfaces(): Promise<CmuxSurface[]> {
-  const tree = await cmuxJson(["tree", "--json", "--all"])
-  if (!tree) return []
-  const surfaces: CmuxSurface[] = []
-  for (const w of tree.windows ?? []) {
-    for (const ws of w.workspaces ?? []) {
-      if (typeof ws?.ref !== "string") continue
-      for (const pane of ws.panes ?? []) {
-        for (const s of pane.surfaces ?? []) {
-          if (s?.type === "terminal" && typeof s.ref === "string") {
-            surfaces.push({ ref: s.ref, workspaceRef: ws.ref, here: s.here === true })
-          }
-        }
-      }
-    }
-  }
-  await Promise.all(
-    surfaces.map(async (surface) => {
-      const info = await cmuxJson(["surface", "resume", "show", "--surface", surface.ref, "--json"])
-      const checkpoint = info?.restore_record?.checkpoint_id
-      if (typeof checkpoint === "string") surface.checkpoint = checkpoint
-    }),
-  )
-  return surfaces
-}
-
-// The bridge walks `cmux tree` plus one `surface resume show` per surface, and
-// switching sessions is frequent while the surface set changes rarely, so reuse
-// a recent scan for a moment instead of re-walking cmux on every open.
-let cmuxSurfacesCache: { at: number; surfaces: CmuxSurface[] } | undefined
-async function cmuxSurfacesCached(): Promise<CmuxSurface[]> {
-  const now = Date.now()
-  if (cmuxSurfacesCache && now - cmuxSurfacesCache.at < 1500) return cmuxSurfacesCache.surfaces
-  const surfaces = await cmuxSurfaces()
-  cmuxSurfacesCache = { at: now, surfaces }
-  return surfaces
-}
-
-// Pure selection: the workspace to focus for a session, or undefined to open
-// locally. Prefers a live surface in a different workspace; ignores the
-// caller's own surface and workspace (focusing where you already are is a
-// no-op, so a local open is the better answer).
-function pickFocusWorkspace(surfaces: CmuxSurface[], sessionID: string): string | undefined {
-  const self = surfaces.find((surface) => surface.here)
-  for (const surface of surfaces) {
-    if (self && surface.ref === self.ref) continue
-    if (surface.checkpoint !== sessionID) continue
-    if (self && surface.workspaceRef === self.workspaceRef) continue
-    return surface.workspaceRef
-  }
-  return undefined
-}
-
-// Open a session from anywhere in the panel, cmux-aware: if another cmux
-// workspace is already running it, focus that workspace instead of opening a
-// duplicate here; otherwise open it locally. Every switch path (sidebar, home
-// list, picker, needs-input picker) goes through here so none of them silently
-// skips the bridge. cmux calls only run inside cmux.
-async function openSessionEntry(api: TuiPluginApi, entry: Entry): Promise<void> {
-  if (process.env.CMUX_WORKSPACE_ID) {
-    const target = pickFocusWorkspace(await cmuxSurfacesCached(), entry.id)
-    if (target) {
-      try {
-        await promisify(execFile)("cmux", ["workspace", "select", target])
-        return
-      } catch {
-        // cmux unavailable; fall through to a local open
-      }
-    }
-  }
-  api.route.navigate("session", { sessionID: entry.id })
-}
-
 function addTranscript(index: Map<string, string>, sid: string, data: string): void {
   try {
     const part = JSON.parse(data) as { type?: unknown; text?: unknown }
@@ -757,7 +675,6 @@ function SidebarSessions(props: { api: TuiPluginApi } & PinProps) {
   const [pendingDelete, setPendingDelete] = createSignal<string>()
   const [waiting, setWaiting] = createSignal<Map<string, string>>(new Map())
   let confirmTimer: ReturnType<typeof setTimeout> | undefined
-  let lastSyncedTitle: string | undefined
   const currentID = createMemo(() => {
     const route = props.api.route.current
     if (route.name !== "session") return undefined
@@ -793,20 +710,6 @@ function SidebarSessions(props: { api: TuiPluginApi } & PinProps) {
       } catch {
         // leave the previous waiting set in place rather than flashing
       }
-      // Keep this cmux workspace named after the session it is showing, so the
-      // sidebar and the workspace list agree. The session title is the source
-      // of truth; a placeholder title is never pushed. cmux-only.
-      try {
-        const workspace = process.env.CMUX_WORKSPACE_ID
-        const id = currentID()
-        const title = id ? (props.api.state.session.get(id)?.title ?? "").trim() : ""
-        if (workspace && title && !PLACEHOLDER_TITLE.test(title) && title !== lastSyncedTitle) {
-          await promisify(execFile)("cmux", ["workspace", "rename", workspace, "--title", title])
-          lastSyncedTitle = title
-        }
-      } catch {
-        // renaming is best-effort; a failure leaves the workspace name alone
-      }
     }
     void load()
     const clock = setInterval(() => void load(), POLL_MS)
@@ -818,7 +721,7 @@ function SidebarSessions(props: { api: TuiPluginApi } & PinProps) {
 
   const filteredEntries = createMemo(() => {
     const q = query().trim().toLowerCase()
-    const ordered = pinnedFirst(entries(), props.pins())
+    const ordered = entries()
     if (!q) return ordered
     return ordered.filter(
       (entry) => entry.title.toLowerCase().includes(q) || entry.dir.toLowerCase().includes(q),
@@ -831,9 +734,10 @@ function SidebarSessions(props: { api: TuiPluginApi } & PinProps) {
   const NEEDS_INPUT_DIR = "__needs_input__"
   const waitingEntries = createMemo(() => {
     const ids = waiting()
-    return shownEntries().filter((entry) => ids.has(entry.id))
+    return newestFirst(shownEntries().filter((entry) => ids.has(entry.id)))
   })
-  const waitingReason = (id: string) => (waiting().get(id) === "question" ? "awaiting answer" : "run stuck")
+  const waitingReason = (id: string) =>
+    waiting().get(id) === "question" ? "awaiting answer" : waiting().get(id) === "stuck" ? "run stuck" : "needs input"
 
   const tree = createMemo<TreeRow[]>(() => {
     const rows: TreeRow[] = []
@@ -862,10 +766,11 @@ function SidebarSessions(props: { api: TuiPluginApi } & PinProps) {
         return rank(b) - rank(a) || b.updated - a.updated
       })
     for (const group of ordered) {
+      const sessions = newestFirst(group.list)
       rows.push({ kind: "group", dir: group.dir, label: prettyDir(group.dir, home), count: group.list.length })
       if (collapsed()[group.dir]) continue
-      for (let i = 0; i < group.list.length; i++) {
-        rows.push({ kind: "item", entry: group.list[i], last: i === group.list.length - 1 })
+      for (let i = 0; i < sessions.length; i++) {
+        rows.push({ kind: "item", entry: sessions[i], last: i === sessions.length - 1 })
       }
     }
     return rows
@@ -885,9 +790,7 @@ function SidebarSessions(props: { api: TuiPluginApi } & PinProps) {
     setSectionCollapsed((value) => !value)
   }
 
-  // Sidebar rows open through the shared cmux-aware path, so they focus the
-  // workspace already running the session instead of opening a duplicate.
-  const openSession = (entry: Entry) => openSessionEntry(props.api, entry)
+  const openSession = (entry: Entry) => props.api.route.navigate("session", { sessionID: entry.id })
 
   // Flat order of the rows a cursor can land on, so keyboard navigation and
   // mouse hover resolve to the same row.
@@ -909,21 +812,24 @@ function SidebarSessions(props: { api: TuiPluginApi } & PinProps) {
     previousRows = rows
   })
 
-  const sessionStatus = (id: string): "running" | "waiting" | "idle" => {
+  const sessionStatus = (id: string): SidebarActivity => {
     try {
       const permissions = props.api.state.session.permission(id)
       const questions = props.api.state.session.question(id)
-      if ((permissions?.length ?? 0) > 0 || (questions?.length ?? 0) > 0) return "waiting"
-      const status = props.api.state.session.status(id)
-      if (status?.type === "busy" || status?.type === "retry") return "running"
+      return sidebarActivity(
+        id === currentID(),
+        props.api.state.session.status(id)?.type,
+        (permissions?.length ?? 0) > 0 || (questions?.length ?? 0) > 0,
+        waiting().get(id),
+      )
     } catch {}
-    return "idle"
+    return sidebarActivity(id === currentID(), undefined, false, waiting().get(id))
   }
 
-  const statusColor = (id: string) => {
-    const status = sessionStatus(id)
+  const statusColor = (status: SidebarActivity) => {
     if (status === "running") return theme().success
     if (status === "waiting") return theme().warning
+    if (status === "active") return theme().accent
     return theme().textMuted
   }
 
@@ -1220,8 +1126,8 @@ function SidebarSessions(props: { api: TuiPluginApi } & PinProps) {
           horizontalScrollbarOptions={{ visible: false }}
         >
           <For each={tree()}>
-          {(row) =>
-            row.kind === "group" ? (
+          {(row) => {
+            if (row.kind === "group") return (
               <box flexDirection="row" paddingTop={1} onMouseDown={() => toggleGroup(row.dir)}>
                 <text flexGrow={1} flexShrink={1} wrapMode="none">
                   <span style={{ fg: theme().textMuted }}>{collapsed()[row.dir] ? "▸ " : "▾ "}</span>
@@ -1231,7 +1137,9 @@ function SidebarSessions(props: { api: TuiPluginApi } & PinProps) {
                   {" "}({row.count})
                 </text>
               </box>
-            ) : (
+            )
+            const activity = createMemo(() => sessionStatus(row.entry.id))
+            return (
               <box
                 flexDirection="row"
                 gap={1}
@@ -1263,24 +1171,24 @@ function SidebarSessions(props: { api: TuiPluginApi } & PinProps) {
                         ? theme().error
                         : row.entry.id === currentID()
                           ? theme().accent
-                          : statusColor(row.entry.id),
+                          : statusColor(activity()),
                     }}
                   >
-                    {row.entry.id === currentID() ? "●" : isActive(row.entry.id) ? "▸" : "○"}
+                    {row.entry.id === currentID() ? "●" : activity() === "waiting" ? "!" : activity() === "running" ? "▶" : isActive(row.entry.id) ? "▸" : "○"}
                   </span>
                 </text>
                 <Highlighted
                   text={`${props.pins().sessions.includes(row.entry.id) ? "★ " : ""}${truncate(row.entry.title, SIDEBAR_TITLE_WIDTH - (props.pins().sessions.includes(row.entry.id) ? 2 : 0))}`}
                   query={query()}
-                  color={isPendingDelete(row.entry.id) ? theme().error : theme().text}
+                  color={isPendingDelete(row.entry.id) ? theme().error : activity() === "idle" ? theme().text : statusColor(activity())}
                   matchColor={theme().warning}
                 />
                 <text flexShrink={0} style={{ fg: isPendingDelete(row.entry.id) ? theme().error : theme().textMuted }}>
                   {isPendingDelete(row.entry.id) ? (
                     "ctrl+x again"
-                  ) : waiting().has(row.entry.id) ? (
+                  ) : activity() !== "idle" ? (
                     <span>
-                      {ago(row.entry.updated)} · <span style={{ fg: theme().warning }}>{waitingReason(row.entry.id)}</span>
+                      {ago(row.entry.updated)} · <span style={{ fg: statusColor(activity()) }}>{activity() === "waiting" ? waitingReason(row.entry.id) : activity()}</span>
                     </span>
                   ) : (
                     ago(row.entry.updated)
@@ -1288,7 +1196,7 @@ function SidebarSessions(props: { api: TuiPluginApi } & PinProps) {
                 </text>
               </box>
             )
-          }
+          }}
         </For>
         </scrollbox>
         <Show when={remaining() > 0}>
@@ -1467,7 +1375,7 @@ 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={() => void openSessionEntry(props.api, entry)}
+              onMouseDown={() => props.api.route.navigate("session", { sessionID: entry.id })}
             >
               <text flexShrink={0} style={{ fg: theme().textMuted }}>
                 ○
@@ -1581,7 +1489,7 @@ const tui: TuiPlugin = async (api) => {
         list.push(entry)
         byGroup.set(entry.group, list)
       }
-      const groups = [...byGroup.entries()].map(([name, list]) => ({ name, list }))
+      const groups = [...byGroup.entries()].map(([name, list]) => ({ name, list: newestFirst(list) }))
       const currentPins = pins()
       const rank = (group: (typeof groups)[number]) =>
         group.list.some((entry) => currentPins.directories.includes(entry.dir)) ? 2
@@ -1771,7 +1679,7 @@ const tui: TuiPlugin = async (api) => {
       if (!target) return
       cleanup()
       api.ui.dialog.clear()
-      void openSessionEntry(api, target)
+      api.route.navigate("session", { sessionID: target.id })
     }
 
     const disposeNav = api.keymap.registerLayer({
@@ -2172,7 +2080,7 @@ ORDER BY lifetime_cost DESC`).all() ?? []) as {
       if (!target) return
       disposeNav()
       api.ui.dialog.clear()
-      void openSessionEntry(api, target.entry)
+      api.route.navigate("session", { sessionID: target.entry.id })
     }
     const disposeNav = api.keymap.registerLayer({
       bindings: [

package/bin/sesh-cmux-sync.sh

@@ -1,149 +0,0 @@
-#!/usr/bin/env bash
-# Name each cmux workspace after the opencode session it is running.
-#
-# cmux records the session behind every terminal surface (its resume
-# `checkpoint_id`), so the mapping needs no bookkeeping: for each surface whose
-# checkpoint is an opencode session (`ses_…`), rename its workspace to that
-# session's current title. Titles are the opencode session title (the source of
-# truth) unless it is still the pre-first-turn placeholder, which is skipped.
-#
-# cmux-only: exits cleanly when the cmux CLI is unavailable. Renames are
-# lossless (a title), so there is no confirmation; --dry-run previews instead.
-#
-# Usage: sesh-cmux-sync.sh [--dry-run] [--json]
-set -euo pipefail
-
-OPENCODE_BIN=${SESH_OPENCODE:-opencode}
-CMUX_BIN=${SESH_CMUX:-cmux}
-dry_run=0
-emit_json=0
-while [ "$#" -gt 0 ]; do
-  case "$1" in
-    --dry-run) dry_run=1 ;;
-    --json) emit_json=1 ;;
-    --help) echo "usage: ${0##*/} [--dry-run] [--json]"; exit 0 ;;
-    *) echo "unknown option: $1" >&2; exit 2 ;;
-  esac
-  shift
-done
-
-command -v "$CMUX_BIN" >/dev/null 2>&1 || { echo 'sesh: cmux is not available' >&2; exit 1; }
-export CMUX_QUIET=1
-
-resolve_db() {
-  if [ -n "${SESH_DB:-}" ]; then printf '%s\n' "$SESH_DB"; return 0; fi
-  local from_cli=''
-  if command -v "$OPENCODE_BIN" >/dev/null 2>&1; then
-    from_cli=$("$OPENCODE_BIN" db path 2>/dev/null || true)
-  fi
-  if [ -n "$from_cli" ] && [ -f "$from_cli" ]; then printf '%s\n' "$from_cli"; return 0; fi
-  if [ -f "$HOME/.local/share/opencode/opencode.db" ]; then printf '%s\n' "$HOME/.local/share/opencode/opencode.db"; return 0; fi
-  return 1
-}
-
-SQLITE_BIN=''
-if [ -n "${SESH_SQLITE:-}" ]; then
-  SQLITE_BIN=$SESH_SQLITE
-elif command -v sqlite3 >/dev/null 2>&1; then
-  SQLITE_BIN=sqlite3
-fi
-
-JQ_BIN=${SESH_JQ:-$(command -v jq || true)}
-[ -n "$JQ_BIN" ] || { echo 'sesh: jq is required' >&2; exit 1; }
-
-DB_PATH=$(resolve_db) || { echo 'sesh: session database unavailable' >&2; exit 1; }
-[ -f "$DB_PATH" ] || { echo 'sesh: session database unavailable' >&2; exit 1; }
-
-# 1. Every terminal surface cmux knows about, with its workspace.
-SURFACES=$("$CMUX_BIN" tree --json --all 2>/dev/null | "$JQ_BIN" -c '
-  [ .windows[]?.workspaces[]? as $w
-    | $w.panes[]?.surfaces[]?
-    | select(.type == "terminal" and (.ref | type) == "string")
-    | {surface: .ref, workspace: $w.ref} ]') || SURFACES='[]'
-[ -n "$SURFACES" ] || SURFACES='[]'
-
-# 2. The opencode session each surface is running (cmux resume checkpoint).
-PAIRS='[]'
-while IFS=$'\t' read -r surface workspace; do
-  [ -n "$surface" ] || continue
-  checkpoint=$("$CMUX_BIN" surface resume show --surface "$surface" --json 2>/dev/null \
-    | "$JQ_BIN" -r '.restore_record.checkpoint_id // empty' 2>/dev/null || true)
-  case "$checkpoint" in
-    ses_[A-Za-z0-9]*) ;;
-    *) continue ;;
-  esac
-  PAIRS=$(printf '%s' "$PAIRS" | "$JQ_BIN" -c \
-    --arg ws "$workspace" --arg sid "$checkpoint" \
-    '. + [{workspace: $ws, session: $sid}]')
-done < <(printf '%s' "$SURFACES" | "$JQ_BIN" -r '.[] | [.surface, .workspace] | @tsv')
-
-if [ "$(printf '%s' "$PAIRS" | "$JQ_BIN" 'length')" = 0 ]; then
-  echo 'No cmux workspace is running an opencode session.'
-  exit 0
-fi
-
-# 3. Session titles (one query) and current workspace titles.
-IN_LIST=''
-for id in $(printf '%s' "$PAIRS" | "$JQ_BIN" -r '.[].session'); do
-  case "$id" in
-    ses_[A-Za-z0-9]*) IN_LIST="$IN_LIST'$id'," ;;
-    *) echo 'sesh: unexpected session id shape' >&2; exit 1 ;;
-  esac
-done
-IN_LIST=${IN_LIST%,}
-if [ -n "$SQLITE_BIN" ]; then
-  TITLE_ROWS=$("$SQLITE_BIN" -json -readonly "$DB_PATH" "SELECT id, title FROM session WHERE id IN ($IN_LIST);")
-else
-  TITLE_ROWS=$("$OPENCODE_BIN" db "SELECT id, title FROM session WHERE id IN ($IN_LIST);" --format json)
-fi
-[ -n "$TITLE_ROWS" ] || TITLE_ROWS='[]'
-
-CURRENT=$("$CMUX_BIN" workspace list --json 2>/dev/null | "$JQ_BIN" -c \
-  '[.workspaces[] | {workspace: .ref, title: (.custom_title // .title // "")}]') || CURRENT='[]'
-[ -n "$CURRENT" ] || CURRENT='[]'
-
-# 4. Keep only the real renames: a non-placeholder session title that differs
-#    from what the workspace already shows.
-FINAL=$(printf '%s' "$PAIRS" | "$JQ_BIN" -c \
-  --slurpfile sessions <(printf '%s' "$TITLE_ROWS") \
-  --slurpfile current <(printf '%s' "$CURRENT") '
-  ($sessions[0] | map({key: .id, value: .title}) | from_entries) as $byId
-  | ($current[0] | map({key: .workspace, value: .title}) | from_entries) as $shown
-  | [ .[]
-      | ($byId[.session] // "" | gsub("^ +| +$"; "")) as $t
-      | select($t != "")
-      # Never push a placeholder or a plugin sentinel (opencode-ghost titles its
-      # internal sessions "ghost-hidden").
-      | select(($t | test("^New session\\b|^ghost-hidden$"; "i") | not))
-      | select(($shown[.workspace] // "") != $t)
-      | . + {title: $t} ]')
-
-COUNT=$(printf '%s' "$FINAL" | "$JQ_BIN" 'length')
-if [ "$COUNT" = 0 ]; then
-  echo 'Every cmux workspace already matches its session.'
-  exit 0
-fi
-
-if [ "$emit_json" = 1 ]; then
-  printf '%s\n' "$FINAL"
-  exit 0
-fi
-
-printf '%s' "$FINAL" | "$JQ_BIN" -r '.[] | "\(.workspace)\t\(.title)"' | while IFS=$'\t' read -r ws title; do
-  printf '%s → %s\n' "$ws" "$title"
-done
-
-if [ "$dry_run" = 1 ]; then
-  printf 'Would rename %s workspace(s) (--dry-run: nothing changed).\n' "$COUNT" >&2
-  exit 0
-fi
-
-renamed=0
-while IFS=$'\t' read -r ws title; do
-  if "$CMUX_BIN" workspace rename "$ws" --title "$title" >/dev/null 2>&1; then
-    renamed=$((renamed + 1))
-  else
-    echo "sesh: could not rename $ws" >&2
-  fi
-done < <(printf '%s' "$FINAL" | "$JQ_BIN" -r '.[] | [.workspace, .title] | @tsv')
-echo "Renamed $renamed workspace(s)."