sessionview 0.3.2__tar.gz → 0.3.3__tar.gz

{sessionview-0.3.2 → sessionview-0.3.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: sessionview
-Version: 0.3.2
+Version: 0.3.3
 Summary: A sidebar for tmux: your projects (sessions) and your agents, here and on remote hosts.
 Project-URL: Homepage, https://github.com/sessionkit/sessionview
 Project-URL: Repository, https://github.com/sessionkit/sessionview
@@ -285,7 +285,9 @@ beside it. Each line says what puts it there and what takes it away.
 - **Services (launchd agents):** none. sessionview runs no daemon and
   writes nothing in `~/Library/LaunchAgents/`. While a frame is open it
   runs a tmux server of its own, `sessionview-frame`, beside yours; the
-  server exits when the last frame closes.
+  server exits when the last frame closes. With `pane_menu` on, an
+  Option + right-click on that server's pane that holds your tmux goes
+  through to yours.
 - **Plugin and skills, optional:** `claude plugin marketplace add` and
   `claude plugin install` ([Install](#install)). Claude Code names the
   marketplace and the plugin in `~/.claude/settings.json`
@@ -310,9 +312,10 @@ beside it. Each line says what puts it there and what takes it away.
   mouse bindings on the status line (`MouseDown1Status`,
   `MouseDown1StatusRight`, `MouseDrag1Status`). It gives each session it
   opens the sessionview look, with options set on that session only.
-  With `pane_menu` on, it also binds a right-click in a pane
-  (`MouseDown3Pane`), in place of yours, and sets two global
-  `@sessionview_agent_menu_` options. Nothing is written to
+  With `pane_menu` on, it also binds both right-clicks in a pane
+  (`MouseDown3Pane`, and `M-MouseDown3Pane` for Option + right-click),
+  in place of yours, and sets two global `@sessionview_agent_menu_`
+  options. Nothing is written to
   `~/.tmux.conf`: these last until that tmux server exits.
 - **Outside these folders, only on a verb:** with `fullscreen` on, the
   Dock app on Terminal.app needs the Accessibility permission you grant
@@ -372,17 +375,20 @@ keep theirs beside it in `~/.sessionkit/`.
   picker (type to filter, ↑↓, enter); `+` at the bottom → start an
   agent; the store name → that store's session and store view, its `⋯`
   (or `s`) → Switch store, right-click → Kick; `all · grouped` on the agents
-  heading are toggles; drag the border to resize; `q` reloads, `Q`
+  heading are toggles (the first cycles all / store / project); drag the border to resize; `q` reloads, `Q`
   quits, esc backs out of any view
 - tab bar: `◧` at the far left hides/shows the sidebar; click selects,
   drag reorders, `+` new tab (the picker); a close `×`, on by default;
   `tmux set -g @sessionview_tab_close 0` turns it off
 - menu: ↑↓ / j k move, the letter or enter picks, esc or a click
   anywhere else closes
-- agent panes (opt-in): right-click an agent's pane for Speak, Continue,
-  Read Clipboard, Park or Succeed; each mails that agent. Turn it on
-  with `sessionview-config set pane_menu true`. It replaces your own tmux right-click menu, which is
-  why it is off by default. Using tmux without session view? Add
+- agent panes (opt-in): right-click or Option + right-click an agent's
+  pane for Speak, Continue, Read Clipboard, Park or Succeed; each mails
+  that agent. It opens even on an agent whose program uses the mouse, as
+  Claude Code does. An agent's pane is one whose title is
+  `<glyph> <address>`. Turn it on with
+  `sessionview-config set pane_menu true`. It replaces your own tmux
+  right-click menus, which is why it is off by default. Using tmux without session view? Add
   `source-file -q /path/to/sessionview/tmux/agent-menu.conf` to
   `~/.tmux.conf` and reload.
 

{sessionview-0.3.2 → sessionview-0.3.3}/README.md

@@ -268,7 +268,9 @@ beside it. Each line says what puts it there and what takes it away.
 - **Services (launchd agents):** none. sessionview runs no daemon and
   writes nothing in `~/Library/LaunchAgents/`. While a frame is open it
   runs a tmux server of its own, `sessionview-frame`, beside yours; the
-  server exits when the last frame closes.
+  server exits when the last frame closes. With `pane_menu` on, an
+  Option + right-click on that server's pane that holds your tmux goes
+  through to yours.
 - **Plugin and skills, optional:** `claude plugin marketplace add` and
   `claude plugin install` ([Install](#install)). Claude Code names the
   marketplace and the plugin in `~/.claude/settings.json`
@@ -293,9 +295,10 @@ beside it. Each line says what puts it there and what takes it away.
   mouse bindings on the status line (`MouseDown1Status`,
   `MouseDown1StatusRight`, `MouseDrag1Status`). It gives each session it
   opens the sessionview look, with options set on that session only.
-  With `pane_menu` on, it also binds a right-click in a pane
-  (`MouseDown3Pane`), in place of yours, and sets two global
-  `@sessionview_agent_menu_` options. Nothing is written to
+  With `pane_menu` on, it also binds both right-clicks in a pane
+  (`MouseDown3Pane`, and `M-MouseDown3Pane` for Option + right-click),
+  in place of yours, and sets two global `@sessionview_agent_menu_`
+  options. Nothing is written to
   `~/.tmux.conf`: these last until that tmux server exits.
 - **Outside these folders, only on a verb:** with `fullscreen` on, the
   Dock app on Terminal.app needs the Accessibility permission you grant
@@ -355,17 +358,20 @@ keep theirs beside it in `~/.sessionkit/`.
   picker (type to filter, ↑↓, enter); `+` at the bottom → start an
   agent; the store name → that store's session and store view, its `⋯`
   (or `s`) → Switch store, right-click → Kick; `all · grouped` on the agents
-  heading are toggles; drag the border to resize; `q` reloads, `Q`
+  heading are toggles (the first cycles all / store / project); drag the border to resize; `q` reloads, `Q`
   quits, esc backs out of any view
 - tab bar: `◧` at the far left hides/shows the sidebar; click selects,
   drag reorders, `+` new tab (the picker); a close `×`, on by default;
   `tmux set -g @sessionview_tab_close 0` turns it off
 - menu: ↑↓ / j k move, the letter or enter picks, esc or a click
   anywhere else closes
-- agent panes (opt-in): right-click an agent's pane for Speak, Continue,
-  Read Clipboard, Park or Succeed; each mails that agent. Turn it on
-  with `sessionview-config set pane_menu true`. It replaces your own tmux right-click menu, which is
-  why it is off by default. Using tmux without session view? Add
+- agent panes (opt-in): right-click or Option + right-click an agent's
+  pane for Speak, Continue, Read Clipboard, Park or Succeed; each mails
+  that agent. It opens even on an agent whose program uses the mouse, as
+  Claude Code does. An agent's pane is one whose title is
+  `<glyph> <address>`. Turn it on with
+  `sessionview-config set pane_menu true`. It replaces your own tmux
+  right-click menus, which is why it is off by default. Using tmux without session view? Add
   `source-file -q /path/to/sessionview/tmux/agent-menu.conf` to
   `~/.tmux.conf` and reload.
 

{sessionview-0.3.2 → sessionview-0.3.3}/bin/sessionview-frame

@@ -119,12 +119,16 @@ FRESH_WIN=""
 # global config is untouched (a normal tmux session keeps its bar at the
 # bottom).
 sh -c 'S="$1"; L="$3"; tmux() { command tmux -L "$L" "$@"; }; . "$2"' sh "$SESSION" "$SESSIONVIEW_ROOT/tmux/frame.conf" "$SOCK"
-# the agent pane menu (right-click an agent's pane: Speak / Continue / ...), IF
-# the user turned it on. Opt-in: one bind-key is global to the server and
-# replaces their own right-click menu. Sourced into the running server, so it
-# works whether or not tmux was already up. Fails open, like the rest of the
-# frame's setup. See tmux/agent-menu.conf.
-if [ "$("$SESSIONVIEW_ROOT/bin/sessionview-config" get pane_menu 2>/dev/null)" = true ]; then
+# the agent pane menu (right-click or Option + right-click an agent's pane:
+# Speak / Continue / ...), IF the user turned it on. Opt-in: its two bind-keys
+# are global to the server and replace both of the user's own right-click
+# bindings (MouseDown3Pane, M-MouseDown3Pane). Sourced into the running
+# server, so it works whether or not tmux was already up. Fails open, like the
+# rest of the frame's setup. See tmux/agent-menu.conf. Read once: the frame's
+# own server acts on the same answer below (the Option + right-click
+# pass-through).
+PANE_MENU="$("$SESSIONVIEW_ROOT/bin/sessionview-config" get pane_menu 2>/dev/null || true)"
+if [ "$PANE_MENU" = true ]; then
   "$TMUX_BIN" -L "$SOCK" source-file "$SESSIONVIEW_ROOT/tmux/agent-menu.conf" 2>/dev/null || true
 fi
 # the chosen agent, if the user has one - asked once, remembered, started in
@@ -194,6 +198,13 @@ o set -w -t "=$F:0" pane-active-border-style "fg=#3a3f4d,bg=#21252e"
 o set -w -t "=$F:0" pane-border-lines single
 o bind-key -T root MouseDown1Border "resize-pane -M"
 o bind-key -T root MouseDrag1Border "resize-pane -M"
+# with pane_menu on, an Option + right-click on the client pane goes through to
+# your tmux and its agent menu; the frame's other panes keep the binding this
+# server had. Here, after new-session: before it this server may not exist.
+# Off, nothing is touched. Fails open. See lib/pane-menu.sh.
+if [ "$PANE_MENU" = true ]; then
+  { . "$SESSIONVIEW_ROOT/lib/pane-menu.sh" && sv_frame_option_forward "$FRAME_SOCK"; } >/dev/null 2>&1 || true
+fi
 MAIN="$(o split-window -h -P -F '#{pane_id}' -t "$SIDE" -e "TMUX=" \
   "exec \"$TMUX_BIN\" -L \"$SOCK\" attach -t \"=$SESSION\"")"
 # the frame publishes its own panes, so the sidebar process (which cannot see

{sessionview-0.3.2 → sessionview-0.3.3}/bin/sessionview-install

@@ -168,13 +168,17 @@ else
   say WARN "neomutt not on PATH - the messages tab, which sessionview makes only when sessionmail is installed, cannot open (brew install neomutt)"
 fi
 # notmuch - the messages tab's sidebar queries Type: and Project:; unindexed, the Asks
-# rows are every mail to NAME+ask, with no error
+# rows are every mail to NAME+ask, with no error. Asked of sessionmail's notmuch profile
+# when `message path --notmuch-config` names one (sessionmail 0.3.3), as the tab does;
+# no message, an older one or no profile: notmuch's own default config.
 if command -v notmuch >/dev/null 2>&1; then
-  if [ "$(notmuch config get index.header.Type 2>/dev/null)" = Type ] &&
-     [ "$(notmuch config get index.header.Project 2>/dev/null)" = Project ]; then
-    say PASS "notmuch indexes Type and Project"
+  NMCFG="$(message path --notmuch-config 2>/dev/null)" || NMCFG=""
+  NM="notmuch${NMCFG:+ --config=$NMCFG}"
+  if [ "$(notmuch ${NMCFG:+"--config=$NMCFG"} config get index.header.Type 2>/dev/null)" = Type ] &&
+     [ "$(notmuch ${NMCFG:+"--config=$NMCFG"} config get index.header.Project 2>/dev/null)" = Project ]; then
+    say PASS "notmuch indexes Type and Project${NMCFG:+ ($NMCFG)}"
   else
-    say WARN "notmuch does not index Type and Project - the Asks rows show every mail to NAME+ask:  notmuch config set index.header.Type Type; notmuch config set index.header.Project Project; notmuch reindex '*'"
+    say WARN "notmuch${NMCFG:+ ($NMCFG)} does not index Type and Project - the Asks rows show every mail to NAME+ask:  $NM config set index.header.Type Type; $NM config set index.header.Project Project; $NM reindex '*'"
   fi
 else say WARN "notmuch not on PATH - the messages tab has no sidebar (brew install notmuch)"; fi
 # optional

{sessionview-0.3.2 → sessionview-0.3.3}/bin/sessionview-messages

@@ -8,7 +8,7 @@
 # named `messages` in both store and project sessions. Three facts, each
 # measured:
 #   the folder   `message path [SLUG/]PROJECT` (sessionmail 2454f6f) prints
-#                the project's maildir, e.g. ~/.mail/agents/acme/myproject;
+#                the project's maildir, wherever sessionmail keeps it;
 #                exit 2 when there is none.
 #   the viewer   `neomutt -R -F RC -f FOLDER`. -R (read-only) is not optional:
 #                without it, reading a message moves it new/ -> cur/ and the
@@ -41,6 +41,9 @@
 # the rows are every mail to PROJECT+ask, replies too, and the rc says so;
 # without notmuch, or a folder notmuch does not hold, the tab is the one
 # folder as before and the sidebar is hidden. --print names the reason.
+# notmuch here, and neomutt's (nm_config_file), read sessionmail's notmuch
+# profile when `message path --notmuch-config` names one (sessionmail 0.3.3);
+# an older sessionmail, or no profile (exit 1 or 2), is notmuch's own default.
 # Ctrl-o (sidebar-open) is the macOS tty's `discard` char and never reaches
 # neomutt; `stty discard undef` runs below, in the shell that owns the tty
 # (measured by the first user of this layout: a backtick inside
@@ -92,19 +95,26 @@ case "$FOLDER" in *[\"\`\\\$]*|*[[:cntrl:]]*)
 [ -d "$FOLDER" ] || { echo "sessionview-messages: $BOX: $FOLDER is not a directory" >&2; exit 2; }
 # The sidebar's rows: per project, so written here, not in config/neomuttrc.
 SIDEBAR=""; SIDEBAR_WHY=""
-if command -v notmuch >/dev/null 2>&1; then
-  DB="$(notmuch config get database.path 2>/dev/null)"
+NMCFG="$(message path --notmuch-config 2>/dev/null)" || NMCFG=""
+nm() { notmuch ${NMCFG:+"--config=$NMCFG"} "$@"; }
+NM="notmuch${NMCFG:+ --config=$NMCFG}"   # the words in a fix line
+case "$NMCFG" in *[\"\`\\\$]*|*[[:cntrl:]]*)
+  SIDEBAR_WHY="sessionmail's notmuch config refused: its path holds a \" \` \\ \$ or control character, which the rc would run or break on";; esac
+if [ -n "$SIDEBAR_WHY" ]; then :
+elif command -v notmuch >/dev/null 2>&1; then
+  DB="$(nm config get database.path 2>/dev/null)"
   if [ -z "$DB" ]; then SIDEBAR_WHY="notmuch has no database.path"
   else case "$FOLDER/" in
     "$DB"/*)
-      if [ "$(notmuch config get index.header.Type 2>/dev/null)" = Type ] &&
-         [ "$(notmuch config get index.header.Project 2>/dev/null)" = Project ]; then
+      if [ "$(nm config get index.header.Type 2>/dev/null)" = Type ] &&
+         [ "$(nm config get index.header.Project 2>/dev/null)" = Project ]; then
         Q="Type:ask and (to:\\\"$NAME+ask\\\" or Project:\\\"$NAME\\\")"
       else
         Q="to:\\\"$NAME+ask\\\""
-        SIDEBAR_WHY="notmuch does not index Type and Project, so Asks is every mail to $NAME+ask, replies too - notmuch config set index.header.Type Type; notmuch config set index.header.Project Project; notmuch reindex '*'"
+        SIDEBAR_WHY="notmuch does not index Type and Project, so Asks is every mail to $NAME+ask, replies too - $NM config set index.header.Type Type; $NM config set index.header.Project Project; $NM reindex '*'"
       fi
-      SIDEBAR="$(printf 'set nm_default_url="notmuch://%s"\nset nm_query_type=messages\nset virtual_spoolfile=no\nnamed-mailboxes "%s" "%s"\nvirtual-mailboxes "Asks" "notmuch://?query=%s"\nvirtual-mailboxes "Asks · threads" "notmuch://?type=threads&query=%s"\n' "$DB" "$NAME" "$FOLDER" "$Q" "$Q")";;
+      SIDEBAR="$(printf 'set nm_default_url="notmuch://%s"\nset nm_query_type=messages\nset virtual_spoolfile=no\nnamed-mailboxes "%s" "%s"\nvirtual-mailboxes "Asks" "notmuch://?query=%s"\nvirtual-mailboxes "Asks · threads" "notmuch://?type=threads&query=%s"\n' "$DB" "$NAME" "$FOLDER" "$Q" "$Q")"
+      [ -z "$NMCFG" ] || SIDEBAR="set nm_config_file=\"$NMCFG\""$'\n'"$SIDEBAR";;
     *) SIDEBAR_WHY="$FOLDER is not under notmuch database.path $DB";;
   esac; fi
 else SIDEBAR_WHY="no notmuch on PATH (brew install notmuch)"; fi

{sessionview-0.3.2 → sessionview-0.3.3}/bin/tmux-send-agent

@@ -51,9 +51,10 @@ to=""
 # the session box: the last +field, :field or .field that is 8 hex
 for cand in "${title##*+}" "${title##*:}" "${title##*.}"; do
   if printf '%s' "$cand" | grep -qE '^[0-9a-f]{8}$'; then
-    for d in "$HOME/.mail/agents/$cand"*/; do
-      [ -d "$d" ] && { to="$(basename "$d")"; break; }
-    done
+    # sessionmail names the box: the first `session ID` row of `message box
+    # list`. Where its mail root is, is sessionmail's to know, never ours to
+    # spell. A refusal or no row leaves `to` empty: the seat address below.
+    to="$("$message_bin" box list "$cand*" --all 2>/dev/null | awk '$1=="session"{print $2; exit}' || true)"
     break
   fi
 done

{sessionview-0.3.2 → sessionview-0.3.3}/bin/tmux-sidebar

@@ -477,16 +477,50 @@ def paint(text, selected):
 WIDTH = int(CFG["width"])
 REFRESH = float(CFG["refresh"])
 GLYPH = {"busy": fg("#f9e2af") + "◐" + NOFG, "idle": fg("#a6e3a1") + "●" + NOFG,
-         "shell": C_DIM + "○" + NOFG,        "blocked": fg("#f38ba8") + "■" + NOFG,
-         "waiting": fg("#f38ba8") + "■" + NOFG}
-RANK = {"blocked": 0, "waiting": 0, "busy": 1, "idle": 2, "shell": 3}
+         "blocked": fg("#f38ba8") + "■" + NOFG, "waiting": fg("#f38ba8") + "■" + NOFG}
+RANK = {"blocked": 0, "waiting": 0, "busy": 1, "idle": 2}
+# A seat's condition, in the sidebar's words: blocked, waiting, busy or idle.
+# Every glyph, sort and rollup asks seat_word(); nothing else reads `status`
+# for that. `state` is the session tools' word (busy | idle with children |
+# idle) and decides busy against idle, but it cannot say "a prompt blocks the
+# turn" (`waiting` reads idle there), so the attention words come from the
+# raw `status` first. A feed with no `state` (an older session tools) has its
+# `status` mapped instead. Claude Code writes `shell`, not `idle`, for a seat
+# at its prompt whenever a background shell lives (a listener left running is
+# one), so most idle seats say `shell`: that is idle.
+ATTENTION = ("blocked", "waiting")
+STATE_WORD = {"busy": "busy", "idle": "idle", "idle with children": "idle"}
+STATUS_WORD = {"busy": "busy", "idle": "idle", "shell": "idle"}
+
+def seat_word(a):
+    status = a.get("status")
+    if status in ATTENTION:
+        return status
+    state = a.get("state")
+    if state:
+        return STATE_WORD.get(state, state)
+    return STATUS_WORD.get(status, status)
+
 MOUSE_RE = re.compile(r"\x1b\[<(\d+);(\d+);(\d+)([mM])")
 ANSI_RE = re.compile(r"\x1b\[[0-9;]*m")
 
 POPUP = "--popup" in sys.argv   # inside `tmux display-popup -E`: a jump closes us
 PICKER = None            # the ONE type-and-filter box (new session / new tab / start an agent); see open_picker
 GROUPED = CFG.get("group_by", "none") != "none"
-FILTER = "all"           # all | current  (the agents of the selected project)
+# The agents list's scopes, in the order a click on the heading word cycles
+# them: widest to narrowest. scope_filter() is what each one keeps.
+SCOPES = ("all", "store", "project")
+# The scope the sidebar starts in: "all" | "store" | "project". An OPEN
+# choice, not a decision: "all" is today's behaviour, kept until the
+# owner chooses. A one-word edit; every option is already tested.
+FILTER_DEFAULT = "all"
+# What the `store` scope shows when the selected project is in no store
+# (no store owns the viewed server, or the selected session is not one of
+# its projects): "project" | "pinned" | "nostore" | "all". An OPEN choice
+# too, and PROVISIONAL: "all" is the one option that cannot hide a seat.
+# A one-word edit; scope_filter() implements and tests all four.
+STORE_SCOPE_NO_STORE = "all"
+FILTER = FILTER_DEFAULT  # all | store | project; see scope_filter
 MENU = None              # the project menu, drawn IN the sidebar (see project_menu)
 PROMPT = None            # an inline text/confirm line, drawn IN the sidebar
 # The row a menu opens beside, so a menu appears close to the row that
@@ -996,6 +1030,30 @@ def row_store():
     on = [s for s in stores() if (s.get("socket") or "default") == SOCK]
     return next((s for s in on if s.get("active")), None) or (on[0] if on else {})
 
+_STORE_PROJ = {}
+def store_projects(rec):
+    """The set of tm project names in store REC, by `tm project list
+    --store PATH`, cached 60s per store path (projects_recent's lifetime).
+    The empty set when REC has no path, tm is absent, or its answer is not
+    JSON. Only the `store` scope asks: `all` and `project` cost nothing.
+    Not projects_recent(): that mixes in checkouts on disk
+    (repo_projects), and a checkout is not a store project."""
+    root = (rec or {}).get("path") or ""
+    if not root:
+        return set()
+    root = os.path.realpath(root)
+    now = time.time()
+    hit = _STORE_PROJ.get(root)
+    if hit and now - hit[0] < 60:
+        return set(hit[1])
+    try:
+        rows = json.loads(sh(["tm", "project", "list", "-f", "json", "--store", root]) or "[]")
+        names = {p.get("name", "") for p in rows if isinstance(p, dict)} - {""}
+    except (json.JSONDecodeError, TypeError, AttributeError):
+        names = set()
+    _STORE_PROJ[root] = (now, frozenset(names))
+    return set(names)
+
 def open_store(name):
     """The store row's name, and a pick in the Switch store modal: open
     NAME's store session and look at it. A down server is booted by
@@ -1768,7 +1826,7 @@ def agent_fields(a, window="", dups=(), model_w=0):
     numbered seat (`alice-e9`): two rows with the same name fall back to
     showing the extra number."""
     f = _Safe(a)
-    f["glyph"] = GLYPH.get(a.get("status"), "?")
+    f["glyph"] = GLYPH.get(seat_word(a), "?")
     # Right-hand columns line up row to row: the model is right-justified to
     # the widest one on screen, the context to 4 (`100%` is real). The dash
     # is left padded too, so the right-hand side lines up row to row.
@@ -1810,9 +1868,9 @@ def agent_fields(a, window="", dups=(), model_w=0):
 # sweeps leftovers at start, so a glyph cannot outlive the sidebar by much.
 _TABS = {}
 WRITE_TABS = True
-TAB_CH = {"busy": "\u25d0", "idle": "\u25cf", "shell": "\u25cb",
+TAB_CH = {"busy": "\u25d0", "idle": "\u25cf",
           "blocked": "\u25a0", "waiting": "\u25a0"}
-TAB_FG = {"busy": "#f9e2af", "idle": "#a6e3a1", "shell": "#7f859b",
+TAB_FG = {"busy": "#f9e2af", "idle": "#a6e3a1",
           "blocked": "#f38ba8", "waiting": "#f38ba8"}
 
 def tab_glyphs(by_win, pl):
@@ -1828,7 +1886,7 @@ def tab_glyphs(by_win, pl):
     want = {}
     for w, states in by_win.items():
         st = rollup(states)
-        if st:
+        if st in TAB_CH:                            # a word with no glyph draws none
             want[w] = st
     wins = {f"{p[1]}:{p[6]}" for p in pl}
     for w in [k for k in set(_TABS) | set(want) if k != "_swept"]:
@@ -1854,12 +1912,13 @@ def tab_clear():
     _TABS.clear()
 
 def sort_key(a, keys=None):
-    """A row's place by the `sort` config (KEYS, default CFG["sort"]): status
-    rank, then idle, as configured. Pins are not in here; see order_agents."""
+    """A row's place by the `sort` config (KEYS, default CFG["sort"]): the
+    seat's rank (seat_word), then idle, as configured. Pins are not in
+    here; see order_agents."""
     key = []
     for k in (CFG["sort"] if keys is None else keys):
         if k == "rank":
-            key.append(RANK.get(a.get("status"), 9))
+            key.append(RANK.get(seat_word(a), 9))
         else:
             v = a.get(k)
             key.append(v if v is not None else (0 if k.endswith("_s") else ""))
@@ -1941,8 +2000,9 @@ def order_agents(ag, pinned=(), keys=None, grp_of=None, group_order=None, within
     are stable, so the order within a group (and within the pinned block)
     is the first sort's. WITHIN given too: a non-pinned row's key
     inside its group is WITHIN(row), ties keeping the first sort's order;
-    the pinned block keeps its pin order. Filtering (hide, current) is the
-    caller's, BEFORE this: a pin orders a row, it never unhides one."""
+    the pinned block keeps its pin order. Filtering is the caller's, BEFORE
+    this: `hide` drops rows, pinned or not; the scope filter (scope_filter)
+    keeps every pinned row. A pin orders a row; this function never adds one."""
     pins = pin_rank(pinned)
     def pin(a):
         return pins.get(a.get("agent"), len(pins))
@@ -1958,6 +2018,57 @@ def order_agents(ag, pinned=(), keys=None, grp_of=None, group_order=None, within
         out.sort(key=gkey)
     return out
 
+def scope_filter(ag, scope, p2s, cur_sess, pinned=(), store_sessions=None, no_store=None):
+    """The rows of AG that SCOPE shows, in AG's order, pure: AG and its
+    rows are not changed. It runs after `hide` and BEFORE order_agents.
+
+    A pinned row (its `agent` is in PINNED) is kept under every scope. A
+    pinned row whose status is in `hide` stays hidden: `hide` runs first and
+    is the user's own standing rule, not a scope.
+
+    P2S maps a pane to its session on the VIEWED server; CUR_SESS is the
+    selected session. STORE_SESSIONS is the current store's session set
+    (its tm projects plus its own session), or None when no store owns the
+    viewed server. A remote row (`_host`) is never local: its pane id is the
+    remote server's, and pane ids collide across servers.
+
+    - all: every row.
+    - project: the local rows whose session is CUR_SESS.
+    - store, CUR_SESS in STORE_SESSIONS: the local rows whose session is in
+      STORE_SESSIONS.
+    - store, anywhere else (no store, or the selected session is not one of
+      its projects): NO_STORE says, default STORE_SCOPE_NO_STORE -
+      "project" the project rule; "pinned" the pins only; "nostore" the
+      local rows on the viewed server whose session is not in the store
+      (with no store, every local row on the viewed server); "all" every row.
+      It keeps to the viewed server, like the other two scopes: a seat with
+      no pane here has no session here to compare.
+    An unknown SCOPE or NO_STORE shows every row: a typo never hides a seat."""
+    pins = pin_rank(pinned)
+    if no_store is None:
+        no_store = STORE_SCOPE_NO_STORE
+
+    def sess(a):                     # the row's session on the viewed server, or ""
+        return "" if a.get("_host") else (p2s.get(a.get("tmux_pane") or "") or "")
+
+    def in_project(a):
+        return bool(cur_sess) and sess(a) == cur_sess
+
+    store = (set(store_sessions) - {""}) if store_sessions is not None else None
+    if scope == "project":
+        keep = in_project
+    elif scope == "store" and store is not None and cur_sess in store:
+        keep = lambda a: sess(a) in store
+    elif scope == "store" and no_store == "project":
+        keep = in_project
+    elif scope == "store" and no_store == "pinned":
+        keep = lambda a: False
+    elif scope == "store" and no_store == "nostore":
+        keep = lambda a: bool(sess(a)) and (store is None or sess(a) not in store)
+    else:                            # all, the "all" no-store option, or an unknown word
+        keep = lambda a: True
+    return [a for a in ag if a.get("agent") in pins or keep(a)]
+
 def rollup(states):
     return min(states, key=lambda s: RANK.get(s, 9)) if states else None
 
@@ -1970,11 +2081,6 @@ IDLE_W = 4                       # `999m`: the cell is always this wide, so rows
 C_IDLE_ORANGE = fg("#fab387")    # the palette's peach, beside the busy yellow
 C_IDLE_RED = fg("#f38ba8")       # the blocked glyph's red
 IDLE_DEFAULTS = {"agent_idle_orange": 45, "agent_idle_red": 60, "agent_idle_blink": 0}
-# The statuses that mean "at its prompt, its turn over": Claude Code writes
-# `shell`, not `idle`, whenever a background shell lives (a listener left
-# running is one), so many idle seats say `shell`; the session tools read
-# both as the state `idle`. busy, waiting and blocked are not idle.
-IDLE_STATUSES = ("idle", "shell")
 
 def idle_minutes_setting(key):
     """A threshold in minutes from the config, or None for off: 0, a
@@ -1994,14 +2100,14 @@ def idle_minutes_setting(key):
 
 def fmt_idle_cell(a):
     """The {idle_m} cell, IDLE_W columns wide whatever it holds. Blank unless
-    the seat is IDLE (its status is in IDLE_STATUSES): idle_s is the time in
+    the seat is IDLE (seat_word says idle): idle_s is the time in
     the current state, so a seat busy for an hour has a large idle_s too,
     and must show nothing.
     An idle seat shows its whole minutes (`34m`; hours past 999m): dim grey,
     then orange and bold from agent_idle_orange, red and bold from
     agent_idle_red, blinking from agent_idle_blink when that is set (it is
     off by default)."""
-    if a.get("status") not in IDLE_STATUSES:
+    if seat_word(a) != "idle":
         return " " * IDLE_W
     try:
         secs = max(0, int(a.get("idle_s") or 0))
@@ -2112,8 +2218,8 @@ def render_base(height=None):
         pane = a.get("tmux_pane") or ""
         s = p2s.get(pane)
         if s:
-            by_sess.setdefault(s, []).append(a.get("status", ""))
-            by_win.setdefault(f"{s}:{p2i[pane]}", []).append(a.get("status", ""))
+            by_sess.setdefault(s, []).append(seat_word(a) or "")
+            by_win.setdefault(f"{s}:{p2i[pane]}", []).append(seat_word(a) or "")
     tab_glyphs(by_win, pl)                                            # the tab-bar glyphs
 
     lines, targets = [], {}
@@ -2247,7 +2353,7 @@ def render_base(height=None):
         for a in R["agents"]:
             sname = R["p2s"].get(a.get("tmux_pane") or "")
             if sname:
-                rby.setdefault(sname, []).append(a.get("status", ""))
+                rby.setdefault(sname, []).append(seat_word(a) or "")
         for name, nwin, att in R["sessions"]:
             st = rollup(rby.get(name, []))
             g = GLYPH.get(st, " ") if st else " "
@@ -2267,8 +2373,14 @@ def render_base(height=None):
             pane = a.get("tmux_pane") or ""
             ag.append(dict(a, _host=host, _window=R.get("p2w", {}).get(pane, ""),
                            _session=R.get("p2s", {}).get(pane, "")))
-    if FILTER == "current":
-        ag = [a for a in ag if p2s.get(a.get("tmux_pane") or "") == cur_sess]
+    # the scope, then the sort: a pinned row shows under every scope. The
+    # store's session set (its tm projects, its own session, a live legacy
+    # `store`) is asked for only under `store`: all and project cost nothing.
+    in_sess = None
+    if FILTER == "store" and srec:
+        in_sess = (store_projects(srec) | {ssess}
+                   | ({LEGACY_STORE_SESSION} & {n for n, _, _ in live_sessions}))
+    ag = scope_filter(ag, FILTER, p2s, cur_sess, CFG.get("pinned_agents"), in_sess)
     gb = CFG.get("group_by", "none") if not GROUPED else (
          CFG.get("group_by", "none") if CFG.get("group_by", "none") != "none" else "session")
     if not GROUPED:
@@ -2304,11 +2416,15 @@ def render_base(height=None):
     targets[len(lines)] = ("new-or-menu", (vislen(left), WIDTH - vislen(right) if right else WIDTH + 1))
     lines.append(row(C_DIM + lay(spec, WIDTH, chrome=True) + NOFG))
     put("")
-    # heading: "<left from config>      all · grouped" -- each word a toggle,
-    # lit when on: show all, or show current
+    # heading: "<left from config>      all · grouped" -- each word a toggle.
+    # The first names the scope, lit whenever a scope narrows the list; under
+    # the "pinned" no-store option, outside a store, it says so: `no store`.
     hl = (CFG["agents_heading"].split("\t", 1) + [""])[0]
-    filt = "current" if FILTER == "current" else "all"
-    r_filt = (C_SEL if FILTER == "current" else C_DIM) + filt + C_DIM
+    filt = FILTER
+    if FILTER == "store" and STORE_SCOPE_NO_STORE == "pinned" \
+            and not (cur_sess and in_sess is not None and cur_sess in in_sess):
+        filt = "no store"
+    r_filt = (C_SEL if FILTER != "all" else C_DIM) + filt + C_DIM
     r_grp = (C_SEL if GROUPED else C_DIM) + "grouped" + C_DIM
     rtxt = f"{filt} \u00b7 grouped "
     x_right = WIDTH - len(rtxt)
@@ -3686,7 +3802,8 @@ def main():
                     if x >= x_grp + 1:
                         GROUPED = not GROUPED
                     elif x >= x_filt:
-                        FILTER = "all" if FILTER == "current" else "current"
+                        FILTER = SCOPES[(SCOPES.index(FILTER) + 1) % len(SCOPES)
+                                        if FILTER in SCOPES else 0]
                 elif what == "plus-or-collapse":          # the bottom control strip
                     lw, rx = val
                     if x <= lw + 1:

{sessionview-0.3.2 → sessionview-0.3.3}/config/README.md

@@ -161,9 +161,10 @@ labels.
   `session start --list-agents` after. The live
   agents list sorts a running agent whose name is pinned first, in pin
   order, whatever its project, status or idle; the rest keep the `sort`
-  order. Grouped, the pinned rows sit above every group. `hide` and the
-  current filter still apply first. Empty by default; `["alice", "bob"]`
-  keeps alice and bob on top.
+  order. Grouped, the pinned rows sit above every group. `hide` applies
+  first, and a pinned agent shows under every agents scope (all, store,
+  project). Empty by default; `["alice", "bob"]` keeps alice and bob on
+  top.
 - `code_nvim` - sessionview-session starts nvim in the code window, listening on
   show-me's socket; off = a shell.
 - `agent_command` - what "Start an agent" runs: an argv list, `{project}`

{sessionview-0.3.2 → sessionview-0.3.3}/config/config.json

@@ -141,7 +141,7 @@
   ],
   "_window_pins": "Your pins, laid over the `windows` list's `auto`: {\"editor\": true} opens the editor with every session, {\"git\": false} stops git opening. Written by ^p / right-click in the new-tab picker; a delta, so the list itself (template, store or project) keeps flowing to you. EMPTY by default.",
   "window_pins": {},
-  "_pinned_agents": "Agent names held at the TOP, in this order - ONE list for two places: pinned means pinned everywhere. (1) The start-an-agent picker lists them first; the rest of `session start --list-agents` follows. (2) The live agents list sorts a running agent whose name is pinned first, in pin order, whatever its project, status or idle; the rest keep the `sort` order below them. Grouped, the pinned rows sit ABOVE every group, not inside their project's. `hide` and the current filter still apply first: a pin orders a row, it never unhides one. [\"alice\", \"bob\"] keeps alice and bob at the top. EMPTY by default: a fresh install pins nobody. A pinned name the launcher cannot start is not offered - a list that lies is worse than no list. ^p or a right-click on a row in the start-an-agent picker toggles it.",
+  "_pinned_agents": "Agent names held at the TOP, in this order - ONE list for two places: pinned means pinned everywhere. (1) The start-an-agent picker lists them first; the rest of `session start --list-agents` follows. (2) The live agents list sorts a running agent whose name is pinned first, in pin order, whatever its project, status or idle; the rest keep the `sort` order below them. Grouped, the pinned rows sit ABOVE every group, not inside their project's. `hide` still applies first, so a hidden status stays hidden; a pinned agent then shows under every agents scope (all, store, project). [\"alice\", \"bob\"] keeps alice and bob at the top. EMPTY by default: a fresh install pins nobody. A pinned name the launcher cannot start is not offered - a list that lies is worse than no list. ^p or a right-click on a row in the start-an-agent picker toggles it.",
   "pinned_agents": [],
   "_mid_format": "The row between projects and agents. Left word opens a new SESSION. A right word (after a TAB) opens the project menu - there is none by default: the selected project row carries its own menu as three dots at the right. The click target is the row, not the text.",
   "mid_format": " +",
@@ -175,7 +175,7 @@
   "terminal": "",
   "_fullscreen": "FALSE by default: whether the dock app opens sessionview FULL SCREEN (macOS native full screen, the green button - not zoomed). On Terminal.app this needs Accessibility permission for SessionView.app (System Settings > Privacy & Security > Accessibility); the app says so in a dialog rather than failing quietly. iTerm and Ghostty need no permission.",
   "fullscreen": false,
-  "_pane_menu": "FALSE by default: the agent pane menu - right-click an agent's pane for Speak / Continue / Read Clipboard / Park / Succeed, each a mail to that agent (tmux/agent-menu.conf, bin/tmux-send-agent). OPT-IN because a tmux key binding is global to the server: turning this on REPLACES your own right-click menu. When true, sessionview-frame loads it into the server at every launch, so it works whether or not tmux was already running. Without session view: `source-file -q <sessionview>/tmux/agent-menu.conf` in ~/.tmux.conf (a link or a conf.d glob works too). Turning it OFF takes effect when the tmux server restarts: nothing unbinds a running server's menu, since that would also drop the user's own.",
+  "_pane_menu": "FALSE by default: the agent pane menu - right-click or Option + right-click an agent's pane for Speak / Continue / Read Clipboard / Park / Succeed, each a mail to that agent (tmux/agent-menu.conf, bin/tmux-send-agent). An agent's pane is one whose title is `<glyph> <address>`. The plain right-click opens it even when the program there uses the mouse, as Claude Code does. OPT-IN because a tmux key binding is global to the server: turning this on REPLACES both your own right-click bindings (MouseDown3Pane and M-MouseDown3Pane). When true, sessionview-frame loads it into the server at every launch, so it works whether or not tmux was already running, and its own server passes an Option + right-click on your tmux through to it. Without session view: `source-file -q <sessionview>/tmux/agent-menu.conf` in ~/.tmux.conf (a link or a conf.d glob works too). Turning it OFF takes effect when the tmux server restarts: nothing unbinds a running server's menu, since that would also drop the user's own.",
   "pane_menu": false,
   "_pane_menu_from": "EMPTY by default: the OLDER name for mail_from, still honoured when mail_from is empty. Set mail_from instead.",
   "pane_menu_from": "",

{sessionview-0.3.2 → sessionview-0.3.3}/docs/configuration.md

@@ -81,7 +81,10 @@ The `messages` tab shows a project's mail in neomutt, read-only.
 - The tab's sidebar needs notmuch to index two headers:
   `notmuch config set index.header.Type Type` and
   `notmuch config set index.header.Project Project`, then
-  `notmuch reindex '*'`.
+  `notmuch reindex '*'`. When sessionmail names its own notmuch profile
+  (`message path --notmuch-config`, sessionmail 0.3.3), the tab and
+  `sessionview-install --check` use that file, and the fix line they
+  print carries its `--config=`.
 
 Your own mail client, the sidebar's mail row, is set by the
 `user_mail_*` keys on the [settings page][settings].
@@ -119,9 +122,12 @@ repository.
   frame to its own sessions only.
 - `<checkout>/tmux/tabs-top.conf`: the same look for every tmux session.
   Optional: `source-file` it from `~/.tmux.conf`.
-- `<checkout>/tmux/agent-menu.conf`: the agent pane menu. The frame loads
-  it when the `pane_menu` key is `true`; without the frame,
-  `source-file -q` it from `~/.tmux.conf`.
+- `<checkout>/tmux/agent-menu.conf`: the agent pane menu, on both
+  right-clicks (`MouseDown3Pane` and Option's `M-MouseDown3Pane`). The
+  frame loads it when the `pane_menu` key is `true`, and an Option +
+  right-click on your tmux in the frame reaches it. Without the frame,
+  `source-file -q` it from `~/.tmux.conf`. It needs tmux's `mouse`
+  option on, the default since tmux 3.8.
 - `tmux set -g @sessionview_tab_close 0`: no close `×` on the tabs.
 
 ## Paths

{sessionview-0.3.2 → sessionview-0.3.3}/docs/settings.md

@@ -124,7 +124,7 @@ tabs; [config/README.md][config-readme] describes each field.
 | --- | --- | --- | --- |
 | `terminal` | string | `""` | The terminal the dock app opens: `iterm`, `ghostty` or `terminal`. `""` works it out. |
 | `fullscreen` | boolean | `false` | The dock app opens sessionview full screen. |
-| `pane_menu` | boolean | `false` | Right-click on an agent's pane opens the agent pane menu. It replaces your own tmux right-click menu. |
+| `pane_menu` | boolean | `false` | Right-click or Option + right-click on an agent's pane opens the agent pane menu, even when the program there uses the mouse. It replaces both your tmux right-click bindings. |
 | `mail_from` | string | `""` | The name sessionview's mail is sent as. `""`: the next in line, on the [configuration page][mail-sender]. |
 | `pane_menu_from` | string | `""` | The older name for `mail_from`, read when `mail_from` is empty. |
 

sessionview-0.3.3/lib/pane-menu.sh

@@ -0,0 +1,56 @@
+# lib/pane-menu.sh - sourced by sessionview-frame, only when pane_menu is on.
+#
+# sv_frame_option_forward SOCK, on the frame's own tmux server SOCK: an Option
+# + right-click (M-MouseDown3Pane) on a pane running a tmux client goes through
+# to that client's server, where tmux/agent-menu.conf has the agent menu. Every
+# other pane (the sidebar) keeps the binding SOCK already had.
+#
+# Without it the frame's server takes the Option-click itself: it shows its own
+# stock menu for the pane that holds your tmux client, and your tmux never sees
+# the click. The plain right-click needs nothing here: the frame's stock binding
+# already forwards it, because a tmux client's pane has mouse mode on whenever
+# your tmux has `mouse on`.
+#
+# How. The key's current binding is read back with list-keys and becomes the
+# else-branch of one if-shell, so no copy of tmux's menu is kept here (a copy
+# names flags a given tmux may not know, and one unknown flag rejects the whole
+# bind). That binding is tmux's stock menu unless the user's ~/.tmux.conf
+# changed it, and then theirs is kept. A key with no binding sends the click to
+# the pane under the mouse, so its else-branch is `send-keys -M`, which does
+# the same. A second call finds its own wrapper and changes nothing (a second
+# frame on the same server).
+#
+# The separator step. list-keys prints a command SEQUENCE with ` \; ` between
+# its commands. Inside braces that is a literal `;` argument, and the bind
+# fails. So each ` \; ` becomes ` ; ` (and ` \;\; ` becomes ` ;; `). A `\;`
+# inside a quoted string is printed as `\\;` and is left alone.
+#
+# Known limit: an argument that is exactly `;` (`send-keys ';'`) is printed as
+# `\;` too, the same text as a separator. Nothing in the printed line tells the
+# two apart: tmux's own round trip of that line, sourced back as a config line,
+# loses the argument the same way. Then the bind fails (unknown command), the
+# key keeps the user's binding, and the pass-through is not installed. A lone
+# `;` as the binding's LAST word is fine.
+#
+# It runs "${TMUX_BIN:-tmux}" (the frame sets TMUX_BIN) and returns tmux's
+# status; the frame fails open on it.
+
+#: the pass-through, as bound: a pane running tmux gets the click
+SV_FRAME_FORWARD="if-shell -F -t = '#{==:#{pane_current_command},tmux}' { select-pane -t = ; send-keys -M }"
+#: how list-keys prints the start of the wrapper (double quotes)
+SV_FRAME_FORWARD_SHOWN='if-shell -F -t = "#{==:#{pane_current_command},tmux}" { select-pane -t = ; send-keys -M }'
+
+sv_frame_option_forward() {
+  _sv_pm_cur="$("${TMUX_BIN:-tmux}" -L "$1" list-keys -T root M-MouseDown3Pane 2>/dev/null)" || _sv_pm_cur=""
+  # bind-key [-r] -T root M-MouseDown3Pane COMMAND: keep -r, and COMMAND
+  _sv_pm_r="$(printf '%s\n' "$_sv_pm_cur" | sed -n 's/^bind-key  *\(-r\)  *-T root  *M-MouseDown3Pane .*/\1 /p')"
+  _sv_pm_body="$(printf '%s\n' "$_sv_pm_cur" \
+    | sed -n 's/^bind-key  *\(-r  *\)\{0,1\}-T root  *M-MouseDown3Pane  *//p' \
+    | sed 's/ [\\];[\\]; / ;; /g; s/ [\\]; / ; /g')"
+  case "$_sv_pm_body" in
+    "$SV_FRAME_FORWARD_SHOWN"*) return 0;;
+    '') _sv_pm_body="send-keys -M";;
+  esac
+  # $_sv_pm_r is "-r " or empty, unquoted on purpose
+  "${TMUX_BIN:-tmux}" -L "$1" bind-key $_sv_pm_r-T root M-MouseDown3Pane "$SV_FRAME_FORWARD { $_sv_pm_body }"
+}

{sessionview-0.3.2 → sessionview-0.3.3}/macos/SessionView.applescript

@@ -56,11 +56,19 @@ if term is "iterm" then
 	end tell
 end run"
 	try
+		-- Compiling that string LOOKS iTERM UP BY NAME, and on a Mac without
+		-- iTerm the lookup does not fail: it puts up the "Where is iTerm?"
+		-- chooser and waits on it with no time limit, so the alert below was
+		-- never reached and the app hung. So ask first, with a check that
+		-- cannot prompt (itermFound: shell only, no application reference),
+		-- and when iTerm is not there, go straight to the alert.
+		if not itermFound() then error "iTerm was not found on this Mac." number -10814
 		run script itermScript with parameters {cmd, wantFull}
 	on error errMsg number errNum
 		if errNum is -128 then error number -128
 		-- e.g. `terminal: iterm` in the config on a Mac where iTerm is not
-		-- installed: the string does not compile here. Say so; never fail mute.
+		-- installed (itermFound said no), or the string failing to compile or
+		-- run. Say so; never fail mute.
 		display alert "SessionView cannot open iTerm" message "iTerm is the terminal chosen for sessionview, but it could not be run:
 " & errMsg & " (" & errNum & ")
 
@@ -242,3 +250,21 @@ on isInstalled(appName)
 	end try
 end isInstalled
 
+-- Is iTerm on this Mac at all? Asked before the iTerm string is compiled,
+-- because compiling it without iTerm prompts instead of failing. Nothing here
+-- is an AppleScript reference to the app, so nothing here can put up a
+-- chooser: is it running, is it in either Applications folder, and does
+-- LaunchServices know its bundle id (a copy kept anywhere else). That last is
+-- asked through JavaScript for Automation in a child process, a plain lookup
+-- that returns nothing when the app is missing. Spotlight (mdfind) is not
+-- used: with indexing off it finds no app at all.
+on itermFound()
+	set js to "ObjC.import('AppKit'); $.NSWorkspace.sharedWorkspace.URLForApplicationWithBundleIdentifier('com.googlecode.iterm2').isNil() ? 'no' : 'yes'"
+	try
+		do shell script "/usr/bin/pgrep -x iTerm2 >/dev/null || test -d /Applications/iTerm.app || test -d \"$HOME/Applications/iTerm.app\" || test \"$(/usr/bin/osascript -l JavaScript -e " & quoted form of js & " 2>/dev/null)\" = yes"
+		return true
+	on error
+		return false
+	end try
+end itermFound
+

{sessionview-0.3.2 → sessionview-0.3.3}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "sessionview"
-version = "0.3.2"
+version = "0.3.3"
 description = "A sidebar for tmux: your projects (sessions) and your agents, here and on remote hosts."
 readme = "README.md"
 requires-python = ">=3.11,<3.15"

{sessionview-0.3.2 → sessionview-0.3.3}/src/sessionview/__init__.py

@@ -10,7 +10,7 @@ import os
 import sys
 from pathlib import Path
 
-__version__ = "0.3.2"
+__version__ = "0.3.3"
 
 DATA = Path(__file__).resolve().parent / "_data"
 PUBLIC = ("sessionview", "sessionview-config", "sessionview-session", "sessionview-messages")

sessionview-0.3.3/tmux/agent-menu.conf

@@ -0,0 +1,95 @@
+# agent-menu.conf - the agent pane menu. Right-click an agent's pane, or
+# Option + right-click it, for
+#   Speak / Continue / Read Clipboard / Park / Succeed -> <agent>
+# above tmux's own pane menu. Each item mails that agent (bin/tmux-send-agent,
+# sessionmail's `message send`). An agent pane is one whose title carries an
+# agent address: `<glyph> <address>`, as `role.scope` or `name:id`. The agent
+# items appear on agent panes only; other panes get the rest of the menu,
+# sessionview's copy of tmux's own pane menu.
+#
+# Both right-clicks open the same menu:
+#   - plain right-click (MouseDown3Pane): on an agent pane it opens the menu
+#     even when the program there has mouse mode on (Claude Code does). On any
+#     other pane a program with mouse mode on still gets the click, as in
+#     tmux's default. A mode other than copy/view (choose-tree, clock-mode)
+#     still gets the plain click too.
+#   - Option + right-click (M-MouseDown3Pane): always the menu, on every pane,
+#     as in tmux's default.
+# With session view, the frame passes an Option + right-click on the pane
+# that holds your tmux through to it, so this menu opens there too.
+#
+# The menu is written ONCE, as SESSIONVIEW_AGENT_MENU below, and both
+# bindings are built from it when this file is read: to change the menu,
+# edit SESSIONVIEW_AGENT_MENU. SESSIONVIEW_AGENT_TITLE is the agent-pane
+# test, shared by the plain right-click and every agent item. Both are
+# removed from the server's environment at the end of the file.
+#
+# OPT-IN, because a key binding is global to the tmux server: loading this
+# REPLACES BOTH your own right-click bindings (MouseDown3Pane and
+# M-MouseDown3Pane). It needs tmux's `mouse` option on, or no right-click
+# reaches tmux at all (on by default since tmux 3.8; older tmux needs
+# `set -g mouse on` in ~/.tmux.conf).
+#   - with session view:    sessionview-config set pane_menu true
+#                           (sessionview-frame sources this at every launch)
+#   - tmux alone:           add to ~/.tmux.conf, then reload (source-file):
+#                             source-file -q /path/to/sessionview/tmux/agent-menu.conf
+# The sender is you: config mail_from, else $USER (see bin/sessionview-from).
+#
+# Moved here from a personal ~/.tmux.conf, so that it ships with sessionview.
+# The default items are still tmux 3.7b's `list-keys -T root MouseDown3Pane`;
+# re-copy them if tmux's default changes.
+
+# The helper sits beside this file's directory, wherever it is installed.
+# First the path as sourced; then, since a conf.d LINK to this file would
+# point that at confd/../bin (found in review), the
+# link is resolved in the shell and the option overwritten with the real one.
+set -gF @sessionview_agent_menu_conf "#{current_file}"
+set -gF @sessionview_agent_menu_bin "#{d:current_file}/../bin/tmux-send-agent"
+run-shell 'f="$(realpath "#{@sessionview_agent_menu_conf}" 2>/dev/null)" && [ -n "$f" ] && tmux set -g @sessionview_agent_menu_bin "$(dirname "$f")/../bin/tmux-send-agent"; true'
+
+# An agent pane: its title carries an agent address. One definition, used by
+# the plain right-click's test below and by every agent item in the menu.
+%hidden SESSIONVIEW_AGENT_TITLE='^[^ ]+ ([a-z_][a-z0-9_+-]*[.][^ ]+|[a-z][a-z0-9_-]*:[^ ]+)$'
+
+# The menu, once. Both right-click bindings below are built from it.
+%hidden SESSIONVIEW_AGENT_MENU="display-menu -T '#[align=centre]#{pane_index} (#{pane_id})' -t = -x M -y M \
+  '#{?#{m/r:$SESSIONVIEW_AGENT_TITLE,#{pane_title}},Speak → #{s/[^A-Za-z0-9_.+-].*//:#{s/^[^ ]+ //:pane_title}},}' S { run-shell -b \"'#{@sessionview_agent_menu_bin}' #{pane_id}\" } \
+  '#{?#{m/r:$SESSIONVIEW_AGENT_TITLE,#{pane_title}},Continue → #{s/[^A-Za-z0-9_.+-].*//:#{s/^[^ ]+ //:pane_title}},}' C { run-shell -b \"'#{@sessionview_agent_menu_bin}' #{pane_id} continue\" } \
+  '#{?#{m/r:$SESSIONVIEW_AGENT_TITLE,#{pane_title}},Read Clipboard → #{s/[^A-Za-z0-9_.+-].*//:#{s/^[^ ]+ //:pane_title}},}' B { run-shell -b \"'#{@sessionview_agent_menu_bin}' #{pane_id} -- 'please read the clipboard (pbpaste) and act on it'\" } \
+  '#{?#{m/r:$SESSIONVIEW_AGENT_TITLE,#{pane_title}},Park → #{s/[^A-Za-z0-9_.+-].*//:#{s/^[^ ]+ //:pane_title}},}' P { run-shell -b \"'#{@sessionview_agent_menu_bin}' #{pane_id} 'please settle your context, then park'\" } \
+  '#{?#{m/r:$SESSIONVIEW_AGENT_TITLE,#{pane_title}},Succeed → #{s/[^A-Za-z0-9_.+-].*//:#{s/^[^ ]+ //:pane_title}},}' U { run-shell -b \"'#{@sessionview_agent_menu_bin}' #{pane_id} -- 'please settle your context, then succeed: start your successor'\" } \
+  '#{?#{m/r:(copy|view)-mode,#{pane_mode}},Go To Top,}' < { send-keys -X history-top } \
+  '#{?#{m/r:(copy|view)-mode,#{pane_mode}},Go To Bottom,}' > { send-keys -X history-bottom } \
+  '' \
+  '#{?#{&&:#{buffer_size},#{!:#{pane_in_mode}}},Paste #[underscore]#{=/9/...:buffer_sample},}' p { paste-buffer } \
+  '' \
+  '#{?mouse_word,Search For #[underscore]#{=/9/...:mouse_word},}' C-r { if-shell -F '#{?#{m/r:(copy|view)-mode,#{pane_mode}},0,1}' 'copy-mode -t=' ; send-keys -X -t = search-backward -- '#{q:mouse_word}' } \
+  '#{?mouse_word,Type #[underscore]#{=/9/...:mouse_word},}' C-y { copy-mode -q ; send-keys -l '#{q:mouse_word}' } \
+  '#{?mouse_word,Copy #[underscore]#{=/9/...:mouse_word},}' c { copy-mode -q ; set-buffer '#{q:mouse_word}' } \
+  '#{?mouse_line,Copy Line,}' l { copy-mode -q ; set-buffer '#{q:mouse_line}' } \
+  '' \
+  '#{?mouse_hyperlink,Type #[underscore]#{=/9/...:mouse_hyperlink},}' C-h { copy-mode -q ; send-keys -l '#{q:mouse_hyperlink}' } \
+  '#{?mouse_hyperlink,Copy #[underscore]#{=/9/...:mouse_hyperlink},}' h { copy-mode -q ; set-buffer '#{q:mouse_hyperlink}' } \
+  '' \
+  '#{?#{!:#{pane_floating_flag}},Horizontal Split,}' h { split-window -h } \
+  '#{?#{!:#{pane_floating_flag}},Vertical Split,}' v { split-window -v } \
+  '' \
+  '#{?#{&&:#{!:#{pane_floating_flag}},#{>:#{window_panes},1}},Swap Up,}' u { swap-pane -U } \
+  '#{?#{&&:#{!:#{pane_floating_flag}},#{>:#{window_panes},1}},Swap Down,}' d { swap-pane -D } \
+  '#{?pane_marked_set,,-}Swap Marked' s { swap-pane } \
+  '' \
+  Kill X { kill-pane } \
+  Respawn R { respawn-pane -k } \
+  '#{?pane_marked,Unmark,Mark}' m { select-pane -m } \
+  '#{?#{>:#{window_panes},1},,-}#{?window_zoomed_flag,Unzoom,Zoom}' z { resize-pane -Z }"
+
+# Plain right-click: the program gets it when it has mouse mode on and the
+# pane is NOT an agent's, or when a mode other than copy/view owns the pane;
+# otherwise the menu. Each binding is ONE string, so tmux parses it when it
+# binds: a broken menu fails this file loudly and leaves both keys as they were.
+# Option + right-click: always the menu, as in tmux's default.
+bind-key -T root MouseDown3Pane "if-shell -F -t = '#{||:#{&&:#{!:#{m/r:$SESSIONVIEW_AGENT_TITLE,#{pane_title}}},#{mouse_any_flag}},#{&&:#{pane_in_mode},#{?#{m/r:(copy|view)-mode,#{pane_mode}},0,1}}}' { select-pane -t = ; send-keys -M } { $SESSIONVIEW_AGENT_MENU }"
+bind-key -T root M-MouseDown3Pane "$SESSIONVIEW_AGENT_MENU"
+# Leave nothing behind in the server's environment.
+set-environment -gu SESSIONVIEW_AGENT_TITLE
+set-environment -gu SESSIONVIEW_AGENT_MENU

sessionview-0.3.2/tmux/agent-menu.conf

@@ -1,33 +0,0 @@
-# agent-menu.conf - the agent pane menu. Right-click an agent's pane for
-#   Speak / Continue / Read Clipboard / Park / Succeed -> <agent>
-# above tmux's own pane menu. Each item mails that agent (bin/tmux-send-agent,
-# sessionmail's `message send`). Items appear only when the pane title
-# carries an agent address; other panes get tmux's plain menu.
-#
-# OPT-IN, because a key binding is global to the tmux server: loading this
-# REPLACES your own right-click (MouseDown3Pane) menu.
-#   - with session view:    sessionview-config set pane_menu true
-#                           (sessionview-frame sources this at every launch)
-#   - tmux alone:           add to ~/.tmux.conf, then reload (source-file):
-#                             source-file -q /path/to/sessionview/tmux/agent-menu.conf
-# The sender is you: config mail_from, else $USER (see bin/sessionview-from).
-#
-# Moved here from a personal ~/.tmux.conf, so that it ships with sessionview.
-# The default items are tmux 3.7b's `list-keys -T root MouseDown3Pane`; re-copy
-# them if tmux's default changes.
-
-# The helper sits beside this file's directory, wherever it is installed.
-# First the path as sourced; then, since a conf.d LINK to this file would
-# point that at confd/../bin (found in review), the
-# link is resolved in the shell and the option overwritten with the real one.
-set -gF @sessionview_agent_menu_conf "#{current_file}"
-set -gF @sessionview_agent_menu_bin "#{d:current_file}/../bin/tmux-send-agent"
-run-shell 'f="$(realpath "#{@sessionview_agent_menu_conf}" 2>/dev/null)" && [ -n "$f" ] && tmux set -g @sessionview_agent_menu_bin "$(dirname "$f")/../bin/tmux-send-agent"; true'
-
-bind-key -T root MouseDown3Pane if-shell -F -t = "#{||:#{mouse_any_flag},#{&&:#{pane_in_mode},#{?#{m/r:(copy|view)-mode,#{pane_mode}},0,1}}}" { select-pane -t = ; send-keys -M } { display-menu -T "#[align=centre]#{pane_index} (#{pane_id})" -t = -x M -y M \
-  "#{?#{m/r:^[^ ]+ ([a-z_][a-z0-9_+-]*[.][^ ]+|[a-z][a-z0-9_-]*:[^ ]+)$,#{pane_title}},Speak → #{s/[^A-Za-z0-9_.+-].*//:#{s/^[^ ]+ //:pane_title}},}" S { run-shell -b "'#{@sessionview_agent_menu_bin}' #{pane_id}" } \
-  "#{?#{m/r:^[^ ]+ ([a-z_][a-z0-9_+-]*[.][^ ]+|[a-z][a-z0-9_-]*:[^ ]+)$,#{pane_title}},Continue → #{s/[^A-Za-z0-9_.+-].*//:#{s/^[^ ]+ //:pane_title}},}" C { run-shell -b "'#{@sessionview_agent_menu_bin}' #{pane_id} continue" } \
-  "#{?#{m/r:^[^ ]+ ([a-z_][a-z0-9_+-]*[.][^ ]+|[a-z][a-z0-9_-]*:[^ ]+)$,#{pane_title}},Read Clipboard → #{s/[^A-Za-z0-9_.+-].*//:#{s/^[^ ]+ //:pane_title}},}" B { run-shell -b "'#{@sessionview_agent_menu_bin}' #{pane_id} -- 'please read the clipboard (pbpaste) and act on it'" } \
-  "#{?#{m/r:^[^ ]+ ([a-z_][a-z0-9_+-]*[.][^ ]+|[a-z][a-z0-9_-]*:[^ ]+)$,#{pane_title}},Park → #{s/[^A-Za-z0-9_.+-].*//:#{s/^[^ ]+ //:pane_title}},}" P { run-shell -b "'#{@sessionview_agent_menu_bin}' #{pane_id} 'please settle your context, then park'" } \
-  "#{?#{m/r:^[^ ]+ ([a-z_][a-z0-9_+-]*[.][^ ]+|[a-z][a-z0-9_-]*:[^ ]+)$,#{pane_title}},Succeed → #{s/[^A-Za-z0-9_.+-].*//:#{s/^[^ ]+ //:pane_title}},}" U { run-shell -b "'#{@sessionview_agent_menu_bin}' #{pane_id} -- 'please settle your context, then succeed: start your successor'" } \
-  "#{?#{m/r:(copy|view)-mode,#{pane_mode}},Go To Top,}" < { send-keys -X history-top } "#{?#{m/r:(copy|view)-mode,#{pane_mode}},Go To Bottom,}" > { send-keys -X history-bottom } '' "#{?#{&&:#{buffer_size},#{!:#{pane_in_mode}}},Paste #[underscore]#{=/9/...:buffer_sample},}" p { paste-buffer } '' "#{?mouse_word,Search For #[underscore]#{=/9/...:mouse_word},}" C-r { if-shell -F "#{?#{m/r:(copy|view)-mode,#{pane_mode}},0,1}" "copy-mode -t=" ; send-keys -X -t = search-backward -- "#{q:mouse_word}" } "#{?mouse_word,Type #[underscore]#{=/9/...:mouse_word},}" C-y { copy-mode -q ; send-keys -l "#{q:mouse_word}" } "#{?mouse_word,Copy #[underscore]#{=/9/...:mouse_word},}" c { copy-mode -q ; set-buffer "#{q:mouse_word}" } "#{?mouse_line,Copy Line,}" l { copy-mode -q ; set-buffer "#{q:mouse_line}" } '' "#{?mouse_hyperlink,Type #[underscore]#{=/9/...:mouse_hyperlink},}" C-h { copy-mode -q ; send-keys -l "#{q:mouse_hyperlink}" } "#{?mouse_hyperlink,Copy #[underscore]#{=/9/...:mouse_hyperlink},}" h { copy-mode -q ; set-buffer "#{q:mouse_hyperlink}" } '' "#{?#{!:#{pane_floating_flag}},Horizontal Split,}" h { split-window -h } "#{?#{!:#{pane_floating_flag}},Vertical Split,}" v { split-window -v } '' "#{?#{&&:#{!:#{pane_floating_flag}},#{>:#{window_panes},1}},Swap Up,}" u { swap-pane -U } "#{?#{&&:#{!:#{pane_floating_flag}},#{>:#{window_panes},1}},Swap Down,}" d { swap-pane -D } "#{?pane_marked_set,,-}Swap Marked" s { swap-pane } '' Kill X { kill-pane } Respawn R { respawn-pane -k } "#{?pane_marked,Unmark,Mark}" m { select-pane -m } "#{?#{>:#{window_panes},1},,-}#{?window_zoomed_flag,Unzoom,Zoom}" z { resize-pane -Z } }