opencode-sesh 0.5.0 → 0.6.0

package/AGENTS.md

@@ -147,6 +147,17 @@ Resume happens in place (`exec` after `cd` to the session's cwd).
   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`.
+- **Presence / click-to-focus (cmux-only).** Each sidebar pane heartbeats
+  `{workspace, surface, updated}` to the session file
+  `${XDG_DATA_HOME:-~/.local/share}/sesh/presence/<sessionId>.json` every poll,
+  but only when `CMUX_WORKSPACE_ID` is set; without it nothing is written and a
+  click always navigates locally. Opening a session reads that file and, when a
+  *fresh* (≤45 s), *foreign* workspace claims it, runs
+  `cmux workspace select <id>` instead of `api.route.navigate`. One file per
+  session means concurrent panes never share a file; writes are tmp+rename and
+  stale files are swept on each poll. A crashed pane falls through to a local
+  open after the TTL. The dispatch lives in the sidebar only — the picker and
+  home list always open locally.
 - **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,15 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.6.0] - 2026-09-24
+
+### Added
+
+- Clicking (or Enter on) a sidebar session now switches to the live cmux
+  workspace already showing it, instead of opening a duplicate in the current
+  pane. Panes advertise their open session (cmux-only, one heartbeat file per
+  session, ~45 s TTL); outside cmux or with no live claimant, the click opens
+  the session locally as before.
 ## [0.5.0] - 2026-09-24
 
 ### Added
@@ -16,6 +25,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - `/sesh-needs` opens the sessions waiting on you as an openable list (Enter
   opens, Esc closes). Both new slashes are read-only; prune and retitle stay
   CLI-only.
+
 ## [0.4.0] - 2026-09-24
 
 ### Added
@@ -267,7 +277,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.5.0...HEAD
+[Unreleased]: https://github.com/ozandogrultan/opencode-sesh/compare/v0.6.0...HEAD
+[0.6.0]: https://github.com/ozandogrultan/opencode-sesh/compare/v0.5.0...v0.6.0
 [0.5.0]: https://github.com/ozandogrultan/opencode-sesh/compare/v0.4.0...v0.5.0
 [0.4.0]: https://github.com/ozandogrultan/opencode-sesh/compare/v0.3.0...v0.4.0
 [0.3.0]: https://github.com/ozandogrultan/opencode-sesh/compare/v0.2.1...v0.3.0

package/README.md

@@ -188,7 +188,10 @@ 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.
 Hovering a row while keyboard navigation is active selects it for the next
-shortcut. The full picker is one keystroke away.
+shortcut. Clicking (or Enter on) a session opens it here — unless a live cmux
+workspace is already showing that session, in which case the sidebar focuses
+that workspace instead of opening a duplicate. 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/package.json

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

package/tui/sesh-panel.tsx

@@ -2,8 +2,10 @@
 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 { mkdir, readFile, rename, rmdir, unlink, writeFile } from "node:fs/promises"
+import { mkdir, readFile, readdir, 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"]
@@ -388,6 +390,51 @@ async function queryWaitingIds(db: any): Promise<Map<string, string>> {
   return out
 }
 
+// Presence registry: which cmux workspace is showing which session, so opening
+// a session that is already visible elsewhere focuses that workspace instead
+// of opening a duplicate here. Each panel heartbeats its own session file
+// (one file per session: concurrent panes never share a file, and renames are
+// atomic, so no locking is needed); files older than PRESENCE_TTL_MS are
+// treated as gone. Outside cmux nothing is written and nothing is read.
+const PRESENCE_TTL_MS = 45000
+function presenceDir(): string {
+  const home = process.env.HOME ?? ""
+  const dataHome = process.env.XDG_DATA_HOME ?? `${home}/.local/share`
+  return join(dataHome, "sesh", "presence")
+}
+function parsePresence(raw: string, now: number): string | undefined {
+  let parsed: { workspace?: unknown; updated?: unknown }
+  try {
+    parsed = JSON.parse(raw)
+  } catch {
+    return undefined
+  }
+  if (typeof parsed?.workspace !== "string" || !parsed.workspace) return undefined
+  if (typeof parsed?.updated !== "number" || now - parsed.updated > PRESENCE_TTL_MS) return undefined
+  return parsed.workspace
+}
+async function sweepPresence(): Promise<void> {
+  try {
+    const dir = presenceDir()
+    const now = Date.now()
+    const names = await readdir(dir)
+    await Promise.all(
+      names
+        .filter((name) => name.endsWith(".json"))
+        .map(async (name) => {
+          try {
+            const raw = await readFile(join(dir, name), "utf8")
+            if (!parsePresence(raw, now)) await unlink(join(dir, name))
+          } catch {
+            // ignore races with other panes
+          }
+        }),
+    )
+  } catch {
+    // missing directory or concurrent cleanup; presence is best-effort
+  }
+}
+
 function addTranscript(index: Map<string, string>, sid: string, data: string): void {
   try {
     const part = JSON.parse(data) as { type?: unknown; text?: unknown }
@@ -696,6 +743,30 @@ function SidebarSessions(props: { api: TuiPluginApi } & PinProps) {
       } catch {
         // leave the previous waiting set in place rather than flashing
       }
+      // Heartbeat this pane's session so another pane can focus it instead of
+      // opening a duplicate. cmux-only: without CMUX_WORKSPACE_ID nothing is
+      // written and opening a session always navigates locally.
+      try {
+        const workspace = process.env.CMUX_WORKSPACE_ID
+        const id = currentID()
+        if (workspace && id && SESSION_ID_PATTERN.test(id)) {
+          const dir = presenceDir()
+          await mkdir(dir, { recursive: true })
+          const tmp = join(dir, `${id}.tmp`)
+          await writeFile(
+            tmp,
+            JSON.stringify({
+              workspace,
+              surface: process.env.CMUX_SURFACE_ID ?? null,
+              updated: Date.now(),
+            }),
+          )
+          await rename(tmp, join(dir, `${id}.json`))
+        }
+      } catch {
+        // presence is best-effort; a failed heartbeat only disables focusing
+      }
+      if (process.env.CMUX_WORKSPACE_ID) void sweepPresence()
     }
     void load()
     const clock = setInterval(() => void load(), POLL_MS)
@@ -774,6 +845,31 @@ function SidebarSessions(props: { api: TuiPluginApi } & PinProps) {
     setSectionCollapsed((value) => !value)
   }
 
+  // Open a session. If a live cmux workspace is already showing it, focus that
+  // workspace instead of opening a duplicate here. The heartbeat self-entry is
+  // ignored (it is this pane); a stale file (crashed pane) falls through to a
+  // local navigate. Only the sidebar goes through here.
+  const openSession = async (entry: Entry) => {
+    const selfWorkspace = process.env.CMUX_WORKSPACE_ID
+    if (selfWorkspace) {
+      try {
+        const raw = await readFile(join(presenceDir(), `${entry.id}.json`), "utf8")
+        const workspace = parsePresence(raw, Date.now())
+        if (workspace && workspace !== selfWorkspace) {
+          try {
+            await promisify(execFile)("cmux", ["workspace", "select", workspace])
+            return
+          } catch {
+            // cmux unavailable; fall through to a local open
+          }
+        }
+      } catch {
+        // no presence file for this session
+      }
+    }
+    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.
   const itemRows = createMemo(() => tree().flatMap((row) => (row.kind === "item" ? [row.entry] : [])))
@@ -1007,7 +1103,7 @@ function SidebarSessions(props: { api: TuiPluginApi } & PinProps) {
         preventDefault: true,
         cmd: () => {
           const entry = itemRows()[cursor()]
-          if (entry) props.api.route.navigate("session", { sessionID: entry.id })
+          if (entry) void openSession(entry)
         },
       },
       {
@@ -1138,7 +1234,7 @@ function SidebarSessions(props: { api: TuiPluginApi } & PinProps) {
                   }
                 }}
                 onMouseOut={() => setHovered(undefined)}
-                onMouseDown={() => props.api.route.navigate("session", { sessionID: row.entry.id })}
+                onMouseDown={() => void openSession(row.entry)}
               >
                 <text flexShrink={0}>
                   <span style={{ fg: theme().textMuted }}>{row.last ? "└" : "├"}</span>