opencode-sesh 0.4.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;
@@ -179,7 +190,9 @@ Resume happens in place (`exec` after `cd` to the session's cwd).
   `slash: { name: "sesh" }` on the `api.command.register` entry — that is the
   only way to open the dialog. A markdown command under `commands/` cannot drive
   the picker (it just prompts the model), so never ship one; the installer
-  removes any leftover `commands/sesh.md`.
+  removes any leftover `commands/sesh.md`. The command API never passes slash
+  arguments, so subcommands are separate registrations (`/sesh-costs`,
+  `/sesh-needs`) — all read-only. Destructive actions stay CLI-only.
 - Do not bind `<leader>l` (native `session_list`) or shadow the native
   `/sessions` command.
 - **The sidebar never binds arrow keys globally.** Keyboard navigation is

package/CHANGELOG.md

@@ -7,6 +7,25 @@ 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
+
+- `/sesh-costs` opens the per-project cost digest inside the TUI (24h beside
+  lifetime, same message-level sums as `sesh costs`).
+- `/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
@@ -258,7 +277,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.4.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
 [0.2.1]: https://github.com/ozandogrultan/opencode-sesh/compare/v0.2.0...v0.2.1

package/README.md

@@ -165,6 +165,8 @@ non-interactive `sesh-delete.sh` refuses unless given `--yes`.
 | Key | Action |
 | --- | --- |
 | `/sesh` | Open the full picker |
+| `/sesh-costs` | Per-project cost digest (24h beside lifetime) |
+| `/sesh-needs` | Sessions waiting on you (Enter opens) |
 | `ctrl+o` | Open the full picker (also in the command palette) |
 | Type | Search titles, directories and transcript text |
 | `↑`/`↓`, `PgUp`/`PgDn`, `Home`/`End` | Move the selection |
@@ -186,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.4.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>
@@ -1906,6 +2002,249 @@ const tui: TuiPlugin = async (api) => {
     api.ui.dialog.setSize("xlarge")
   }
 
+  // Read-only digest dialog: spend per project, last day beside lifetime.
+  // Same message-level sums as `sesh costs`; the dialog just renders them.
+  const openCosts = async () => {
+    if (api.mode.current() !== BASE_MODE) return
+    if (api.renderer.currentFocusedEditor === null) return
+    type CostRow = { directory: string; window: number; lifetime: number; sessions: number }
+    let rows: CostRow[] = []
+    let failed = false
+    try {
+      const db = await openTranscriptDb()
+      if (!db) failed = true
+      else {
+        try {
+          const cutoff = Date.now() - 86400000
+          const raw = (db.query(`
+SELECT s.directory AS directory,
+  ROUND(SUM(CASE WHEN m.time_created >= ${cutoff} THEN COALESCE(json_extract(m.data, '$.cost'), 0) ELSE 0 END), 4) AS window_cost,
+  ROUND(SUM(COALESCE(json_extract(m.data, '$.cost'), 0)), 4) AS lifetime_cost,
+  COUNT(DISTINCT s.id) AS sessions
+FROM message m
+JOIN session s ON s.id = m.session_id
+WHERE json_extract(m.data, '$.role') = 'assistant'
+  AND json_extract(m.data, '$.cost') IS NOT NULL
+GROUP BY s.directory
+ORDER BY lifetime_cost DESC`).all() ?? []) as {
+            directory: unknown
+            window_cost: unknown
+            lifetime_cost: unknown
+            sessions: unknown
+          }[]
+          rows = raw
+            .filter(
+              (
+                row,
+              ): row is {
+                directory: string
+                window_cost: number
+                lifetime_cost: number
+                sessions: number
+              } =>
+                typeof row?.directory === "string" &&
+                typeof row?.window_cost === "number" &&
+                typeof row?.lifetime_cost === "number" &&
+                typeof row?.sessions === "number" &&
+                row.lifetime_cost > 0,
+            )
+            .map((row) => ({
+              directory: row.directory,
+              window: row.window_cost,
+              lifetime: row.lifetime_cost,
+              sessions: row.sessions,
+            }))
+        } finally {
+          db.close()
+        }
+      }
+    } catch {
+      failed = true
+    }
+    const money = (n: number) => (n === 0 ? "—" : `$${n.toFixed(2)}`)
+    const home = process.env.HOME ?? ""
+    const disposeKeys = api.keymap.registerLayer({
+      bindings: [
+        { key: "escape", desc: "Close", preventDefault: true, cmd: () => api.ui.dialog.clear() },
+      ],
+    })
+    api.ui.dialog.replace(
+      () => (
+        <box flexDirection="column" paddingLeft={4} paddingRight={4} paddingTop={1} gap={1}>
+          <text attributes={TextAttributes.BOLD}>
+            Cost digest{" "}
+            <span style={{ fg: api.theme.current.textMuted }}>(24h · lifetime)</span>
+          </text>
+          <Show
+            when={!failed && rows.length > 0}
+            fallback={
+              <text style={{ fg: api.theme.current.textMuted }}>
+                {failed ? "Cost data unavailable." : "No assistant cost recorded."}
+              </text>
+            }
+          >
+            <For each={rows}>
+              {(row) => (
+                <box flexDirection="row" gap={2}>
+                  <text flexShrink={0} style={{ fg: api.theme.current.success }}>
+                    {money(row.window)}
+                  </text>
+                  <text flexShrink={0} style={{ fg: api.theme.current.textMuted }}>
+                    {money(row.lifetime)}
+                  </text>
+                  <text flexShrink={0} style={{ fg: api.theme.current.textMuted }}>
+                    ({row.sessions})
+                  </text>
+                  <text flexGrow={1} flexShrink={1} wrapMode="none">
+                    {prettyDir(row.directory, home)}
+                  </text>
+                </box>
+              )}
+            </For>
+          </Show>
+          <box flexShrink={0}>
+            <text style={{ fg: api.theme.current.textMuted }}>esc close</text>
+          </box>
+        </box>
+      ),
+      () => {
+        disposeKeys()
+      },
+    )
+    api.ui.dialog.setSize("large")
+  }
+
+  // Triage dialog: the waiting set as an openable list. Enter opens the
+  // highlighted session; the sidebar section stays the always-visible view.
+  const openNeeds = async () => {
+    if (api.mode.current() !== BASE_MODE) return
+    if (api.renderer.currentFocusedEditor === null) return
+    let items: { entry: Entry; reason: string }[] = []
+    try {
+      const { entries } = await fetchEntries(api)
+      const db = await openTranscriptDb()
+      let waiting = new Map<string, string>()
+      if (db) {
+        try {
+          waiting = await queryWaitingIds(db)
+        } finally {
+          db.close()
+        }
+      }
+      items = entries
+        .filter((entry) => waiting.has(entry.id))
+        .map((entry) => ({
+          entry,
+          reason: waiting.get(entry.id) === "question" ? "awaiting answer" : "run stuck",
+        }))
+    } catch {
+      api.ui.toast({ message: "Could not load sessions", variant: "error" })
+      return
+    }
+    if (items.length === 0) {
+      api.ui.toast({ message: "No sessions are waiting on you.", variant: "info" })
+      return
+    }
+    const [cursor, setCursor] = createSignal(0)
+    const moveCursor = (delta: number) =>
+      setCursor((value) => Math.max(0, Math.min(items.length - 1, value + delta)))
+    const choose = () => {
+      const target = items[cursor()]
+      if (!target) return
+      disposeNav()
+      api.ui.dialog.clear()
+      api.route.navigate("session", { sessionID: target.entry.id })
+    }
+    const disposeNav = api.keymap.registerLayer({
+      bindings: [
+        { key: "up", desc: "Previous session", preventDefault: true, cmd: () => moveCursor(-1) },
+        { key: "down", desc: "Next session", preventDefault: true, cmd: () => moveCursor(1) },
+        { key: "enter", desc: "Open session", preventDefault: true, cmd: () => choose() },
+        {
+          key: "escape",
+          desc: "Close",
+          preventDefault: true,
+          cmd: () => api.ui.dialog.clear(),
+        },
+      ],
+    })
+    const home = process.env.HOME ?? ""
+    api.ui.dialog.replace(
+      () => (
+        <box flexDirection="column" paddingLeft={4} paddingRight={4} paddingTop={1} gap={1}>
+          <text attributes={TextAttributes.BOLD}>
+            Needs input{" "}
+            <span style={{ fg: api.theme.current.textMuted }}>({items.length})</span>
+          </text>
+          <box flexDirection="column">
+            <For each={items}>
+              {(item, index) => (
+                <box
+                  flexDirection="row"
+                  gap={2}
+                  paddingLeft={1}
+                  paddingRight={1}
+                  backgroundColor={
+                    index() === cursor()
+                      ? api.theme.current.primary
+                      : RGBA.fromInts(0, 0, 0, 0)
+                  }
+                  onMouseDown={() => {
+                    setCursor(index())
+                    choose()
+                  }}
+                >
+                  <text
+                    flexGrow={1}
+                    flexShrink={1}
+                    wrapMode="none"
+                    style={{
+                      fg:
+                        index() === cursor()
+                          ? api.theme.current.selectedListItemText
+                          : api.theme.current.text,
+                    }}
+                  >
+                    {truncate(item.entry.title, 48)}
+                  </text>
+                  <text
+                    flexShrink={0}
+                    style={{
+                      fg:
+                        index() === cursor()
+                          ? api.theme.current.selectedListItemText
+                          : api.theme.current.warning,
+                    }}
+                  >
+                    {item.reason}
+                  </text>
+                  <text
+                    flexShrink={0}
+                    style={{
+                      fg:
+                        index() === cursor()
+                          ? api.theme.current.selectedListItemText
+                          : api.theme.current.textMuted,
+                    }}
+                  >
+                    {prettyDir(item.entry.dir, home)} · {ago(item.entry.updated)}
+                  </text>
+                </box>
+              )}
+            </For>
+          </box>
+          <box flexShrink={0}>
+            <text style={{ fg: api.theme.current.textMuted }}>↑↓ navigate · enter open · esc close</text>
+          </box>
+        </box>
+      ),
+      () => {
+        disposeNav()
+      },
+    )
+    api.ui.dialog.setSize("large")
+  }
+
   api.command?.register(() => [
     {
       title: "Pick session (all directories)",
@@ -1917,6 +2256,26 @@ const tui: TuiPlugin = async (api) => {
         void openPicker()
       },
     },
+    {
+      title: "Cost digest (per project)",
+      value: "sesh.costs",
+      description: "Spend per project, last day and lifetime",
+      category: "Sessions",
+      slash: { name: "sesh-costs" },
+      onSelect: () => {
+        void openCosts()
+      },
+    },
+    {
+      title: "Sessions waiting on you",
+      value: "sesh.needs",
+      description: "Unanswered questions and stuck runs",
+      category: "Sessions",
+      slash: { name: "sesh-needs" },
+      onSelect: () => {
+        void openNeeds()
+      },
+    },
   ])
 
   api.keymap.registerLayer({