@opencode-cockpit/shell 0.2.1 → 0.3.0

package/README.md

@@ -1,5 +1,12 @@
 # @opencode-cockpit/shell
 
+**Bay 01 of [Cockpit](https://github.com/Codestz/opencode-cockpit).**
+[Docs →](https://codestz.github.io/opencode-cockpit/shell/overview/) ·
+[Agent tools](https://codestz.github.io/opencode-cockpit/shell/tools/) ·
+[Watching health](https://codestz.github.io/opencode-cockpit/shell/watching/) ·
+[Panel and keys](https://codestz.github.io/opencode-cockpit/shell/interface/) ·
+[Configuration](https://codestz.github.io/opencode-cockpit/configuration/)
+
 [![npm](https://img.shields.io/npm/v/@opencode-cockpit/shell)](https://www.npmjs.com/package/@opencode-cockpit/shell)
 
 Background terminals for [OpenCode](https://opencode.ai) that the agent starts, waits on and
@@ -15,6 +22,10 @@ drives, and that you watch and control without leaving the chat. Part of
 - **Shells outlive OpenCode.** They run in a small daemon, `cockpitd`, shared by every OpenCode
   window and upgraded automatically when the plugin updates.
 
+![A dev server running in the shells panel](https://raw.githubusercontent.com/Codestz/opencode-cockpit/main/media/dock.gif)
+
+*Recorded from a real session, re-recorded on every release.*
+
 ## Install
 
 ```sh
@@ -96,9 +107,12 @@ Things to ask:
 | Key / command | Does |
 |---|---|
 | `ctrl+x o` · `/shells` | Toggle the shells panel under the chat |
+| `s` (in the console) | This conversation only, or the whole project |
 | `ctrl+x i` · `/shell` | Open the shell console |
 | `/shell-new` | Start a shell yourself |
 | `/shells-clear` | Remove finished shells |
+| `/shells-stop` | Stop the shells in view — this conversation, or the project |
+| `/shells-stop-all` | Stop every shell in the project, asking first about the ones you cannot see |
 | `/cockpit-update` | Update the plugin when a newer release exists |
 | `/shells-restart-daemon` | Restart `cockpitd` (asks first when shells are running) |
 
@@ -112,6 +126,10 @@ the program, `ctrl+]` to stop typing), `c` ctrl+c, `r` restart, `x` stop. Finish
 again, `d` remove. Always: `tab` screen or log, `/` search the log (`backspace` clears the filter),
 `?` details, `[` `]` switch shells, `D` clear finished, `esc` close.
 
+**One conversation at a time.** The panel lists the shells of the session you are in, because a
+project's shells mixed together is how it stops making sense. `s` in the console widens it to the
+whole project and back, and `shell_list` takes `session: "this" | "others" | "any"`.
+
 **Searching a long log.** In the console, `/` filters the scrollback to matching lines — keeping
 their original line numbers and highlighting the match — so a 40k-line dev server is one query away
 from the five lines you want. Filtering happens in the daemon, not the terminal.
@@ -152,11 +170,12 @@ working. (`XDG_CONFIG_HOME` is honoured for the global path.)
 | `kinds` | Extra shell categories, or overrides, as name → regex matched against the command. Drives the badges in the sidebar, panel and `shell_list`, so you can group your own stack (`e2e`, `infra`, `worker`) instead of the built-ins. |
 | `watch.presets` | Your own watch rules, or replacements for built-ins, keyed by name. A rule is `{ done?, fail?, ok?, idleSeconds?, ignoreCase? }` — patterns are regular expressions matched against each output line. The agent can then ask for `watch: "e2e"`. |
 | `watch.auto` | Attach a matching preset to every new shell without being asked. **Off by default**: watching is useful, but silently attaching rules to commands you didn't opt in surprises people. Turn it on once you trust your presets. |
+| `lifecycle` | When shells end by themselves. `onExit` (`stopMine` by default) stops this window's shells when it closes; `keep` leaves them for the next window. `orphanAfterMinutes` (60) stops a shell that no window has claimed for that long — the answer to shells running for a week. |
 | `defaults` | Applied to every shell the agent starts unless the call says otherwise: `watch` (`true` for a matching preset, or a preset name), `logFile`, `idleTimeoutSeconds`, `timeoutSeconds`, `notifyOnExit`. |
 | `notify` | What may interrupt the agent — `exit`, `watch`, and `tailLines` (output lines included in an exit message). |
 | `guidance` | The system-prompt paragraph that teaches the agent when to use shells. `false` saves ~120 tokens per request, at the cost of a model that uses shells less well. |
 | `listRunningShells` | How many running shells are listed in the system prompt each turn (~20 tokens each). `0` disables it; the agent can still call `shell_list`. |
-| `ui` | Interface only: `dockHeight`, `dockOpen`, `sidebarRows`, `historyMinutes`, `colors`, `defaultView` (`"screen"` or `"log"`), `keybinds`, `updateCheck`. |
+| `ui` | Interface only: `dockHeight`, `dockOpen` (set it and the panel always starts that way; leave it out and it starts as you last left it), `sidebarRows`, `historyMinutes`, `colors`, `defaultView` (`"screen"` or `"log"`), `keybinds`, `updateCheck`. |
 
 The same settings can go on the plugin entry instead, which is handy for one-offs and for machines
 where you'd rather keep everything in `tui.json`/`opencode.json`:

package/dist/agent/plugin.js

@@ -44,8 +44,9 @@ async function shellHooks({
   directory
 }, options) {
   const config = loadConfig(directory, options);
-  const cockpit = createClient("opencode-cockpit/server");
+  // Identifies this OpenCode window to the daemon, so shells can end with it.
   const instance = crypto.randomUUID();
+  const cockpit = createClient("opencode-cockpit/server", instance);
   const quiet = new Set();
   const userShell = process.env.SHELL && /(bash|zsh|fish|sh)$/.test(process.env.SHELL) ? process.env.SHELL : "/bin/bash";
   const env = () => {

package/dist/agent/tools/start.js

@@ -66,6 +66,9 @@ export function shellStart(kit) {
       const logFile = args.logFile ?? defaults.logFile ?? false;
       const notifyOnExit = args.notifyOnExit ?? defaults.notifyOnExit ?? true;
       const watch = args.watch ?? defaults.watch ?? (config.watch?.auto ? "auto" : undefined);
+      // Nothing should outlive the window that asked for it by more than the user allows.
+      const lifecycle = config.lifecycle ?? {};
+      const orphanMinutes = lifecycle.orphanAfterMinutes ?? 60;
       const shell = deps.shellCommand(args.command);
       const info = await client.call("shell.start", {
         command: shell.command,
@@ -84,6 +87,8 @@ export function shellStart(kit) {
         timeoutMs: seconds(args.timeoutSeconds ?? defaults.timeoutSeconds),
         idleTimeoutMs: seconds(args.idleTimeoutSeconds ?? defaults.idleTimeoutSeconds),
         logFile: logFile === true,
+        stopOnExit: (lifecycle.onExit ?? "stopMine") === "stopMine",
+        orphanAfterMs: orphanMinutes > 0 ? orphanMinutes * 60_000 : undefined,
         reuse: true
       });
       if (notifyOnExit === false) deps.quiet.add(info.id);else deps.quiet.delete(info.id);

package/dist/connect.js

@@ -14,13 +14,14 @@ export function daemonEntry() {
  * BUN_BE_BUN=1 so it runs on OpenCode's embedded Bun (ADR 0001). The expected build lets the
  * client replace a daemon left running from older plugin code.
  */
-export function createClient(name) {
+export function createClient(name, instance) {
   const entry = daemonEntry();
   return new CockpitClient({
     client: {
       name,
       version: pkg.version,
-      pid: process.pid
+      pid: process.pid,
+      instance
     },
     spawn: {
       entry,

package/dist/core/config.js

@@ -53,6 +53,10 @@ export function mergeConfig(base, over) {
       ...base.defaults,
       ...over.defaults
     },
+    lifecycle: {
+      ...base.lifecycle,
+      ...over.lifecycle
+    },
     notify: {
       ...base.notify,
       ...over.notify
@@ -76,7 +80,7 @@ function asConfig(input) {
   if (!input || typeof input !== "object") return {};
   const raw = input;
   const config = {};
-  for (const key of ["watch", "kinds", "defaults", "notify", "ui"]) {
+  for (const key of ["watch", "kinds", "defaults", "lifecycle", "notify", "ui"]) {
     const value = raw[key];
     if (value && typeof value === "object") Object.assign(config, {
       [key]: value

package/dist/tui/components/badge.js

@@ -5,25 +5,45 @@ import { setProp as _$setProp } from "@opentui/solid";
 import { createElement as _$createElement } from "@opentui/solid";
 /** @jsxImportSource @opentui/solid */
 
-import { badgeText, kindColor, kindOf } from "../lib/view.js";
+import { BADGE_RULE, badgeText, kindColor, kindOf } from "../lib/view.js";
 
-/** Status pill: label on a coloured background, readable in any font and colour scheme. */
+/**
+ * Status mark: a coloured rule and its label.
+ *
+ * Not a filled pill. A block of colour has to be as wide as the word inside it, and a list of
+ * them reads as a wall of colour rather than as a list of shells; the rule carries the same
+ * meaning in one column.
+ */
 export function Badge(props) {
   const theme = () => props.api.theme.current;
   const kind = () => kindOf(props.shell);
+  const colour = () => kindColor(theme(), kind());
   return (() => {
     var _el$ = _$createElement("text"),
       _el$2 = _$createElement("span"),
-      _el$3 = _$createElement("b");
+      _el$3 = _$createElement("span"),
+      _el$4 = _$createElement("b");
     _$insertNode(_el$, _el$2);
+    _$insertNode(_el$, _el$3);
     _$setProp(_el$, "flexShrink", 0);
     _$setProp(_el$, "wrapMode", "none");
-    _$insertNode(_el$2, _el$3);
-    _$insert(_el$3, () => badgeText(kind(), props.frame));
-    _$effect(_$p => _$setProp(_el$2, "style", {
-      fg: theme().background,
-      bg: kindColor(theme(), kind())
-    }, _$p));
+    _$insert(_el$2, BADGE_RULE);
+    _$insertNode(_el$3, _el$4);
+    _$insert(_el$4, () => badgeText(kind(), props.frame).slice(BADGE_RULE.length));
+    _$effect(_p$ => {
+      var _v$ = {
+          fg: colour()
+        },
+        _v$2 = {
+          fg: colour()
+        };
+      _v$ !== _p$.e && (_p$.e = _$setProp(_el$2, "style", _v$, _p$.e));
+      _v$2 !== _p$.t && (_p$.t = _$setProp(_el$3, "style", _v$2, _p$.t));
+      return _p$;
+    }, {
+      e: undefined,
+      t: undefined
+    });
     return _el$;
   })();
 }

package/dist/tui/components/console.js

@@ -271,6 +271,10 @@ export function Console(props) {
       name: "cockpit.console.top",
       title: "Scroll to top",
       run: () => scroll?.scrollTo(0)
+    }, {
+      name: "cockpit.console.scope",
+      title: "This session / whole project",
+      run: () => props.store.toggleScope()
     }, {
       name: "cockpit.console.close",
       title: "Close console",
@@ -328,6 +332,10 @@ export function Console(props) {
       key: "n",
       cmd: "cockpit.console.new",
       desc: "New"
+    }, {
+      key: "s",
+      cmd: "cockpit.console.scope",
+      desc: "Scope"
     }, {
       key: "j,down",
       cmd: "cockpit.console.down",
@@ -380,6 +388,7 @@ export function Console(props) {
     if (view() !== "details") keys.push(label("/ search log", "/"));
     keys.push(label("? details", "?"));
     if (props.store.shells().length > 1) keys.push(label("[ ] switch", "[ ]"));
+    keys.push(props.store.scope() === "session" ? label("s whole project", "s project") : label("s this session", "s session"));
     if (finished() > 0) keys.push(label("D clear done", "D"));
     keys.push(label("n new", "n"), "esc");
     return keys.join(" · ");

package/dist/tui/components/dock.js

@@ -1,7 +1,7 @@
 import { effect as _$effect } from "@opentui/solid";
+import { createComponent as _$createComponent } from "@opentui/solid";
 import { insert as _$insert } from "@opentui/solid";
 import { memo as _$memo } from "@opentui/solid";
-import { createComponent as _$createComponent } from "@opentui/solid";
 import { createTextNode as _$createTextNode } from "@opentui/solid";
 import { insertNode as _$insertNode } from "@opentui/solid";
 import { setProp as _$setProp } from "@opentui/solid";
@@ -33,15 +33,17 @@ export function Dock(props) {
       _el$2 = _$createElement("box"),
       _el$3 = _$createElement("text"),
       _el$4 = _$createElement("b"),
-      _el$7 = _$createElement("box"),
-      _el$8 = _$createElement("text");
+      _el$6 = _$createElement("text"),
+      _el$8 = _$createElement("box"),
+      _el$9 = _$createElement("text");
     _$insertNode(_el$, _el$2);
     _$setProp(_el$, "flexShrink", 0);
     _$setProp(_el$, "flexDirection", "column");
     _$setProp(_el$, "border", ["top"]);
     _$insertNode(_el$2, _el$3);
-    _$insertNode(_el$2, _el$7);
+    _$insertNode(_el$2, _el$6);
     _$insertNode(_el$2, _el$8);
+    _$insertNode(_el$2, _el$9);
     _$setProp(_el$2, "flexDirection", "row");
     _$setProp(_el$2, "gap", 1);
     _$setProp(_el$2, "paddingLeft", 1);
@@ -52,17 +54,19 @@ export function Dock(props) {
     _$insertNode(_el$3, _el$4);
     _$setProp(_el$3, "flexShrink", 0);
     _$insertNode(_el$4, _$createTextNode(`Shells`));
+    _$setProp(_el$6, "flexShrink", 0);
+    _$insert(_el$6, () => props.store.scope() === "session" ? "this session" : "project");
     _$insert(_el$2, _$createComponent(Show, {
       get when() {
         return props.store.shells().length > 0;
       },
       get fallback() {
         return (() => {
-          var _el$9 = _$createElement("text");
-          _$insertNode(_el$9, _$createTextNode(`none yet · the agent starts them, or /shell-new`));
-          _$setProp(_el$9, "wrapMode", "none");
-          _$effect(_$p => _$setProp(_el$9, "fg", theme().textMuted, _$p));
-          return _el$9;
+          var _el$0 = _$createElement("text");
+          _$insertNode(_el$0, _$createTextNode(`none yet · the agent starts them, or /shell-new`));
+          _$setProp(_el$0, "wrapMode", "none");
+          _$effect(_$p => _$setProp(_el$0, "fg", theme().textMuted, _$p));
+          return _el$0;
         })();
       },
       get children() {
@@ -73,15 +77,15 @@ export function Dock(props) {
           children: shell => {
             const active = () => props.store.selected()?.id === shell.id;
             return (() => {
-              var _el$1 = _$createElement("box"),
-                _el$10 = _$createElement("text"),
-                _el$11 = _$createTextNode(` `);
-              _$insertNode(_el$1, _el$10);
-              _$setProp(_el$1, "flexDirection", "row");
-              _$setProp(_el$1, "flexShrink", 0);
-              _$setProp(_el$1, "paddingRight", 1);
-              _$setProp(_el$1, "onMouseUp", () => active() ? props.onOpenConsole(shell.id) : props.store.select(shell.id));
-              _$insert(_el$1, _$createComponent(Badge, {
+              var _el$10 = _$createElement("box"),
+                _el$11 = _$createElement("text"),
+                _el$12 = _$createTextNode(` `);
+              _$insertNode(_el$10, _el$11);
+              _$setProp(_el$10, "flexDirection", "row");
+              _$setProp(_el$10, "flexShrink", 0);
+              _$setProp(_el$10, "paddingRight", 1);
+              _$setProp(_el$10, "onMouseUp", () => active() ? props.onOpenConsole(shell.id) : props.store.select(shell.id));
+              _$insert(_el$10, _$createComponent(Badge, {
                 get api() {
                   return props.api;
                 },
@@ -89,28 +93,28 @@ export function Dock(props) {
                 get frame() {
                   return props.store.frame();
                 }
-              }), _el$10);
-              _$insertNode(_el$10, _el$11);
-              _$setProp(_el$10, "wrapMode", "none");
-              _$insert(_el$10, (() => {
+              }), _el$11);
+              _$insertNode(_el$11, _el$12);
+              _$setProp(_el$11, "wrapMode", "none");
+              _$insert(_el$11, (() => {
                 var _c$2 = _$memo(() => !!active());
                 return () => _c$2() ? (() => {
-                  var _el$12 = _$createElement("b");
-                  _$insert(_el$12, () => truncate(shell.title, 22));
-                  return _el$12;
+                  var _el$13 = _$createElement("b");
+                  _$insert(_el$13, () => truncate(shell.title, 22));
+                  return _el$13;
                 })() : truncate(shell.title, 22);
               })(), null);
               _$effect(_p$ => {
-                var _v$6 = active() ? theme().backgroundElement : theme().backgroundPanel,
-                  _v$7 = active() ? theme().text : theme().textMuted;
-                _v$6 !== _p$.e && (_p$.e = _$setProp(_el$1, "backgroundColor", _v$6, _p$.e));
-                _v$7 !== _p$.t && (_p$.t = _$setProp(_el$10, "fg", _v$7, _p$.t));
+                var _v$7 = active() ? theme().backgroundElement : theme().backgroundPanel,
+                  _v$8 = active() ? theme().text : theme().textMuted;
+                _v$7 !== _p$.e && (_p$.e = _$setProp(_el$10, "backgroundColor", _v$7, _p$.e));
+                _v$8 !== _p$.t && (_p$.t = _$setProp(_el$11, "fg", _v$8, _p$.t));
                 return _p$;
               }, {
                 e: undefined,
                 t: undefined
               });
-              return _el$1;
+              return _el$10;
             })();
           }
         }), _$createComponent(Show, {
@@ -118,132 +122,132 @@ export function Dock(props) {
             return overflow() > 0 || props.store.showAll();
           },
           get children() {
-            var _el$6 = _$createElement("text");
-            _$setProp(_el$6, "wrapMode", "none");
-            _$setProp(_el$6, "flexShrink", 0);
-            _$setProp(_el$6, "onMouseUp", () => props.store.toggleAll());
-            _$insert(_el$6, (() => {
+            var _el$7 = _$createElement("text");
+            _$setProp(_el$7, "wrapMode", "none");
+            _$setProp(_el$7, "flexShrink", 0);
+            _$setProp(_el$7, "onMouseUp", () => props.store.toggleAll());
+            _$insert(_el$7, (() => {
               var _c$ = _$memo(() => !!props.store.showAll());
               return () => _c$() ? "▾ fewer" : `▸ ${overflow()} more`;
             })());
-            _$effect(_$p => _$setProp(_el$6, "fg", theme().textMuted, _$p));
-            return _el$6;
+            _$effect(_$p => _$setProp(_el$7, "fg", theme().textMuted, _$p));
+            return _el$7;
           }
         })];
       }
-    }), _el$7);
-    _$setProp(_el$7, "flexGrow", 1);
-    _$setProp(_el$8, "wrapMode", "none");
-    _$setProp(_el$8, "flexShrink", 0);
-    _$insert(_el$8, () => props.hint());
+    }), _el$8);
+    _$setProp(_el$8, "flexGrow", 1);
+    _$setProp(_el$9, "wrapMode", "none");
+    _$setProp(_el$9, "flexShrink", 0);
+    _$insert(_el$9, () => props.hint());
     _$insert(_el$, _$createComponent(Show, {
       get when() {
         return props.store.selected();
       },
       children: shell => [(() => {
-        var _el$13 = _$createElement("box");
-        _$setProp(_el$13, "flexGrow", 1);
-        _$setProp(_el$13, "paddingLeft", 2);
-        _$setProp(_el$13, "paddingRight", 1);
-        _$setProp(_el$13, "minHeight", 0);
-        _$setProp(_el$13, "overflow", "hidden");
-        _$setProp(_el$13, "onMouseUp", () => props.onOpenConsole(shell().id));
-        _$insert(_el$13, _$createComponent(Show, {
+        var _el$14 = _$createElement("box");
+        _$setProp(_el$14, "flexGrow", 1);
+        _$setProp(_el$14, "paddingLeft", 2);
+        _$setProp(_el$14, "paddingRight", 1);
+        _$setProp(_el$14, "minHeight", 0);
+        _$setProp(_el$14, "overflow", "hidden");
+        _$setProp(_el$14, "onMouseUp", () => props.onOpenConsole(shell().id));
+        _$insert(_el$14, _$createComponent(Show, {
           get when() {
             return bodyRuns().length > 0;
           },
           get fallback() {
             return (() => {
-              var _el$19 = _$createElement("text");
-              _$setProp(_el$19, "wrapMode", "none");
-              _$insert(_el$19, () => body() || " ");
-              _$effect(_$p => _$setProp(_el$19, "fg", theme().text, _$p));
-              return _el$19;
+              var _el$20 = _$createElement("text");
+              _$setProp(_el$20, "wrapMode", "none");
+              _$insert(_el$20, () => body() || " ");
+              _$effect(_$p => _$setProp(_el$20, "fg", theme().text, _$p));
+              return _el$20;
             })();
           },
           get children() {
-            var _el$14 = _$createElement("box");
-            _$setProp(_el$14, "flexDirection", "column");
-            _$insert(_el$14, _$createComponent(For, {
+            var _el$15 = _$createElement("box");
+            _$setProp(_el$15, "flexDirection", "column");
+            _$insert(_el$15, _$createComponent(For, {
               get each() {
                 return bodyRuns();
               },
               children: row => (() => {
-                var _el$20 = _$createElement("text"),
-                  _el$21 = _$createTextNode(` `);
-                _$insertNode(_el$20, _el$21);
-                _$setProp(_el$20, "wrapMode", "none");
-                _$insert(_el$20, _$createComponent(For, {
+                var _el$21 = _$createElement("text"),
+                  _el$22 = _$createTextNode(` `);
+                _$insertNode(_el$21, _el$22);
+                _$setProp(_el$21, "wrapMode", "none");
+                _$insert(_el$21, _$createComponent(For, {
                   each: row,
                   children: run => (() => {
-                    var _el$22 = _$createElement("span");
-                    _$insert(_el$22, () => run.text);
-                    _$effect(_$p => _$setProp(_el$22, "style", {
+                    var _el$23 = _$createElement("span");
+                    _$insert(_el$23, () => run.text);
+                    _$effect(_$p => _$setProp(_el$23, "style", {
                       fg: run.fg,
                       bg: run.bg,
                       bold: run.bold,
                       italic: run.italic
                     }, _$p));
-                    return _el$22;
+                    return _el$23;
                   })()
-                }), _el$21);
-                _$effect(_$p => _$setProp(_el$20, "fg", theme().text, _$p));
-                return _el$20;
+                }), _el$22);
+                _$effect(_$p => _$setProp(_el$21, "fg", theme().text, _$p));
+                return _el$21;
               })()
             }));
-            return _el$14;
+            return _el$15;
           }
         }));
-        return _el$13;
+        return _el$14;
       })(), (() => {
-        var _el$15 = _$createElement("box"),
-          _el$16 = _$createElement("text");
-        _$insertNode(_el$15, _el$16);
-        _$setProp(_el$15, "flexDirection", "row");
-        _$setProp(_el$15, "gap", 1);
-        _$setProp(_el$15, "paddingLeft", 2);
-        _$setProp(_el$15, "flexShrink", 0);
-        _$setProp(_el$15, "height", 1);
-        _$setProp(_el$15, "overflow", "hidden");
-        _$setProp(_el$16, "wrapMode", "none");
+        var _el$16 = _$createElement("box"),
+          _el$17 = _$createElement("text");
+        _$insertNode(_el$16, _el$17);
+        _$setProp(_el$16, "flexDirection", "row");
+        _$setProp(_el$16, "gap", 1);
+        _$setProp(_el$16, "paddingLeft", 2);
         _$setProp(_el$16, "flexShrink", 0);
-        _$insert(_el$16, () => statusDetail(shell(), props.store.now()));
-        _$insert(_el$15, _$createComponent(Show, {
+        _$setProp(_el$16, "height", 1);
+        _$setProp(_el$16, "overflow", "hidden");
+        _$setProp(_el$17, "wrapMode", "none");
+        _$setProp(_el$17, "flexShrink", 0);
+        _$insert(_el$17, () => statusDetail(shell(), props.store.now()));
+        _$insert(_el$16, _$createComponent(Show, {
           get when() {
             return watchLabel(shell());
           },
           get children() {
-            var _el$17 = _$createElement("text");
-            _$setProp(_el$17, "wrapMode", "none");
-            _$setProp(_el$17, "flexShrink", 0);
-            _$insert(_el$17, () => watchLabel(shell()));
-            _$effect(_$p => _$setProp(_el$17, "fg", watchColor(theme(), shell()), _$p));
-            return _el$17;
+            var _el$18 = _$createElement("text");
+            _$setProp(_el$18, "wrapMode", "none");
+            _$setProp(_el$18, "flexShrink", 0);
+            _$insert(_el$18, () => watchLabel(shell()));
+            _$effect(_$p => _$setProp(_el$18, "fg", watchColor(theme(), shell()), _$p));
+            return _el$18;
           }
         }), null);
-        _$insert(_el$15, _$createComponent(Show, {
+        _$insert(_el$16, _$createComponent(Show, {
           get when() {
             return _$memo(() => kindOf(shell()) === "fail")() && shell().summary;
           },
           get fallback() {
             return (() => {
-              var _el$23 = _$createElement("text");
-              _$setProp(_el$23, "wrapMode", "none");
-              _$insert(_el$23, () => truncate(`$ ${displayCommand(shell())}`, Math.max(20, dims().width - 40)));
-              _$effect(_$p => _$setProp(_el$23, "fg", theme().textMuted, _$p));
-              return _el$23;
+              var _el$24 = _$createElement("text");
+              _$setProp(_el$24, "wrapMode", "none");
+              _$insert(_el$24, () => truncate(`$ ${displayCommand(shell())}`, Math.max(20, dims().width - 40)));
+              _$effect(_$p => _$setProp(_el$24, "fg", theme().textMuted, _$p));
+              return _el$24;
             })();
           },
           get children() {
-            var _el$18 = _$createElement("text");
-            _$setProp(_el$18, "wrapMode", "none");
-            _$insert(_el$18, () => truncate(`${shell().summary}`, Math.max(20, dims().width - 40)));
-            _$effect(_$p => _$setProp(_el$18, "fg", theme().error, _$p));
-            return _el$18;
+            var _el$19 = _$createElement("text");
+            _$setProp(_el$19, "wrapMode", "none");
+            _$insert(_el$19, () => truncate(`${shell().summary}`, Math.max(20, dims().width - 40)));
+            _$effect(_$p => _$setProp(_el$19, "fg", theme().error, _$p));
+            return _el$19;
           }
         }), null);
-        _$effect(_$p => _$setProp(_el$16, "fg", kindColor(theme(), kindOf(shell())), _$p));
-        return _el$15;
+        _$effect(_$p => _$setProp(_el$17, "fg", kindColor(theme(), kindOf(shell())), _$p));
+        return _el$16;
       })()]
     }), null);
     _$effect(_p$ => {
@@ -251,19 +255,22 @@ export function Dock(props) {
         _v$2 = theme().border,
         _v$3 = theme().backgroundPanel,
         _v$4 = theme().text,
-        _v$5 = theme().textMuted;
+        _v$5 = theme().textMuted,
+        _v$6 = theme().textMuted;
       _v$ !== _p$.e && (_p$.e = _$setProp(_el$, "height", _v$, _p$.e));
       _v$2 !== _p$.t && (_p$.t = _$setProp(_el$, "borderColor", _v$2, _p$.t));
       _v$3 !== _p$.a && (_p$.a = _$setProp(_el$, "backgroundColor", _v$3, _p$.a));
       _v$4 !== _p$.o && (_p$.o = _$setProp(_el$3, "fg", _v$4, _p$.o));
-      _v$5 !== _p$.i && (_p$.i = _$setProp(_el$8, "fg", _v$5, _p$.i));
+      _v$5 !== _p$.i && (_p$.i = _$setProp(_el$6, "fg", _v$5, _p$.i));
+      _v$6 !== _p$.n && (_p$.n = _$setProp(_el$9, "fg", _v$6, _p$.n));
       return _p$;
     }, {
       e: undefined,
       t: undefined,
       a: undefined,
       o: undefined,
-      i: undefined
+      i: undefined,
+      n: undefined
     });
     return _el$;
   })();

package/dist/tui/components/sidebar.js

@@ -39,6 +39,7 @@ export function SidebarShells(props) {
       _$insertNode(_el$2, _el$3);
       _$insertNode(_el$2, _el$5);
       _$setProp(_el$2, "wrapMode", "none");
+      _$setProp(_el$2, "marginBottom", 1);
       _$insertNode(_el$3, _$createTextNode(`Shells`));
       _$insertNode(_el$5, _el$6);
       _$insert(_el$5, counts, null);

package/dist/tui/dialogs.js

@@ -89,7 +89,8 @@ export function newShell(api, store, open) {
         cwd: store.project(),
         title: command.slice(0, 60),
         owner: {
-          project: store.project()
+          project: store.project(),
+          session: store.session()
         },
         reuse: true
       }).then(info => {
@@ -135,6 +136,52 @@ export function restartDaemon(api, store) {
     onCancel: () => api.ui.dialog.clear()
   }));
 }
+
+/**
+ * Stopping shells in bulk. Two commands rather than one, because "everything I can see" and
+ * "everything, including what I cannot" are different intentions — and the second one asks first.
+ */
+export function stopShells(api, store, reach) {
+  const list = (reach === "view" ? store.shells() : store.all()).filter(s => s.status === "running");
+  if (list.length === 0) {
+    api.ui.toast({
+      title: "Shells",
+      message: "Nothing is running.",
+      duration: 3000
+    });
+    return;
+  }
+  const stop = () => {
+    api.ui.dialog.clear();
+    void Promise.all(list.map(shell => store.client.call("shell.stop", {
+      id: shell.id,
+      graceMs: 2000
+    }).catch(() => {}))).then(() => {
+      void store.refresh();
+      api.ui.toast({
+        title: "Shells",
+        message: `Stopped ${list.length} shell${list.length === 1 ? "" : "s"}.`,
+        duration: 4000
+      });
+    });
+  };
+
+  // Shells from other conversations are the ones you are not looking at; say so before killing them.
+  const elsewhere = reach === "project" ? list.length - store.shells().filter(s => s.status === "running").length : 0;
+  if (elsewhere <= 0) {
+    stop();
+    return;
+  }
+  const DialogConfirm = api.ui.DialogConfirm;
+  api.ui.dialog.replace(() => _$createComponent(DialogConfirm, {
+    title: "Stop every shell in this project?",
+    get message() {
+      return `${list.length} running · ${elsewhere} from other conversations.`;
+    },
+    onConfirm: stop,
+    onCancel: () => api.ui.dialog.clear()
+  }));
+}
 export function pickShell(api, store, open) {
   const DialogSelect = api.ui.DialogSelect;
   const shells = order(store.shells());

package/dist/tui/index.js

@@ -11,7 +11,7 @@ import { loadConfig } from "../core/config.js";
 import { Console } from "./components/console.js";
 import { Dock } from "./components/dock.js";
 import { SidebarShells } from "./components/sidebar.js";
-import { announceUpdate, newShell, offerUpdate, pickShell, restartDaemon } from "./dialogs.js";
+import { announceUpdate, newShell, offerUpdate, pickShell, restartDaemon, stopShells } from "./dialogs.js";
 import { createShellStore } from "./state/store.js";
 const DEFAULT_KEYS = {
   "cockpit.shells.dock": "<leader>o",
@@ -55,7 +55,10 @@ const shellTui = async (api, rawOptions, meta) => {
     ...DEFAULT_KEYS,
     ...options.keybinds
   });
-  const [dockOpen, setDockOpen] = createSignal(api.kv.get("cockpit.dock.open", options.dockOpen ?? false));
+
+  // An explicit `ui.dockOpen` says how the panel should start; without one, whatever you last left
+  // it as. Remembered state that overrides a written setting is a setting that appears to do nothing.
+  const [dockOpen, setDockOpen] = createSignal(options.dockOpen ?? api.kv.get("cockpit.dock.open", false));
   const toggleDock = () => {
     const next = !dockOpen();
     setDockOpen(next);
@@ -107,6 +110,20 @@ const shellTui = async (api, rawOptions, meta) => {
       namespace: "palette",
       slashName: "shell-new",
       run: () => newShell(api, store, openConsole)
+    }, {
+      name: "cockpit.shells.stop",
+      title: "Stop the shells in view",
+      category: "Shells",
+      namespace: "palette",
+      slashName: "shells-stop",
+      run: () => stopShells(api, store, "view")
+    }, {
+      name: "cockpit.shells.stopAll",
+      title: "Stop every shell in this project",
+      category: "Shells",
+      namespace: "palette",
+      slashName: "shells-stop-all",
+      run: () => stopShells(api, store, "project")
     }, {
       name: "cockpit.shells.clear",
       title: "Clear finished shells",

package/dist/tui/lib/view.js

@@ -30,11 +30,20 @@ export function kindColor(theme, kind) {
   }
 }
 
-/** Fixed 7-column pill so lists line up: " ⠹ RUN ", " FAIL  ". */
+/**
+ * The status mark: a coloured rule and its label, in a fixed 7 columns so lists line up.
+ *
+ * It used to be a filled pill. Filled blocks have to be as wide as their text, so a column of
+ * them stacks into a wall of colour that competes with the shell names beside it; a rule carries
+ * the same colour in one column and lets the list breathe.
+ */
 export function badgeText(kind, frame = 0) {
-  if (kind === "run") return ` ${SPINNER[frame % SPINNER.length]} RUN `;
-  return ` ${BADGE_LABEL[kind].padEnd(4)}  `;
+  if (kind === "run") return `▌ ${SPINNER[frame % SPINNER.length]} RUN`;
+  return `▌ ${BADGE_LABEL[kind].padEnd(5)}`;
 }
+
+/** The rule itself, so it can be coloured apart from the label it marks. */
+export const BADGE_RULE = "▌";
 const RANK = {
   run: 0,
   fail: 1,

package/dist/tui/state/store.js

@@ -2,6 +2,9 @@ import { existsSync } from "node:fs";
 import { createEffect, createMemo, createRoot, createSignal, on, onCleanup } from "solid-js";
 import { createStore, reconcile } from "solid-js/store";
 import { order, partition } from "../lib/view.js";
+
+/** A project's shells outnumber a conversation's, and mixing them is how the panel gets confusing. */
+
 export function createShellStore(api, client, options = {}) {
   return createRoot(dispose => {
     const [state, setState] = createStore({
@@ -12,7 +15,12 @@ export function createShellStore(api, client, options = {}) {
     const [frame, setFrame] = createSignal(0);
     const [selectedId, setSelectedId] = createSignal();
     const [showAll, setShowAll] = createSignal(api.kv.get("cockpit.shells.showAll", false));
+    const [scope, setScope] = createSignal(api.kv.get("cockpit.shells.scope", options.scope ?? "session"));
     const project = () => api.state.path.directory;
+    const session = () => {
+      const route = api.route.current;
+      return route.name === "session" ? route.params.sessionID : undefined;
+    };
     const historyMs = (options.historyMinutes ?? 30) * 60_000;
     const refresh = async () => {
       try {
@@ -53,7 +61,13 @@ export function createShellStore(api, client, options = {}) {
       const ordered = order(state.list);
       return ordered.find(s => s.id === selectedId()) ?? ordered[0];
     });
-    const folded = createMemo(() => partition(state.list, {
+    /** Everything the daemon knows about this project, narrowed to what the panel is about. */
+    const inScope = createMemo(() => {
+      const current = session();
+      if (scope() === "project" || !current) return state.list;
+      return state.list.filter(shell => shell.owner.session === current);
+    });
+    const folded = createMemo(() => partition(inScope(), {
       showAll: showAll(),
       historyMs,
       now: now(),
@@ -62,7 +76,15 @@ export function createShellStore(api, client, options = {}) {
     return {
       client,
       project,
-      shells: () => state.list,
+      session,
+      scope,
+      toggleScope() {
+        const next = scope() === "session" ? "project" : "session";
+        setScope(next);
+        api.kv.set("cockpit.shells.scope", next);
+      },
+      shells: () => inScope(),
+      all: () => state.list,
       visible: () => folded().visible,
       hidden: () => folded().hidden,
       showAll,
@@ -79,7 +101,7 @@ export function createShellStore(api, client, options = {}) {
       // Cycles every shell in the project: folding only exists to keep the sidebar short, and a
       // shell you cannot reach from the console would be a trap.
       step(delta) {
-        const list = order(state.list);
+        const list = order(inScope());
         if (list.length === 0) return;
         const index = Math.max(0, list.findIndex(s => s.id === pick()?.id));
         const next = list[(index + delta + list.length) % list.length];
@@ -135,7 +157,9 @@ export function useScreen(store, id) {
     current = next;
     setScreen(undefined);
     if (!next) return;
-    const info = store.shells().find(s => s.id === next);
+    // Not store.shells(): that is narrowed to the current conversation, and the selected shell may
+    // sit outside it. A missing offset here is what used to ask the daemon for bytes past the end.
+    const info = store.all().find(s => s.id === next);
     void store.client.call("shell.attach", {
       id: next,
       fromOffset: info?.bytes ?? Number.MAX_SAFE_INTEGER

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@opencode-cockpit/shell",
-  "version": "0.2.1",
+  "version": "0.3.0",
   "description": "Background shells for OpenCode: the agent starts, waits on and drives PTYs; you watch them in a docked TUI panel",
   "type": "module",
   "license": "MIT",
@@ -51,9 +51,9 @@
     "access": "public"
   },
   "dependencies": {
-    "@opencode-cockpit/client": "0.2.1",
-    "@opencode-cockpit/daemon": "0.2.1",
-    "@opencode-cockpit/protocol": "0.2.1",
+    "@opencode-cockpit/client": "0.3.0",
+    "@opencode-cockpit/daemon": "0.3.0",
+    "@opencode-cockpit/protocol": "0.3.0",
     "@opencode-ai/plugin": "1.18.31"
   },
   "devDependencies": {

package/types/connect.d.ts

@@ -6,4 +6,4 @@ export declare function daemonEntry(): string;
  * BUN_BE_BUN=1 so it runs on OpenCode's embedded Bun (ADR 0001). The expected build lets the
  * client replace a daemon left running from older plugin code.
  */
-export declare function createClient(name: string): CockpitClient;
+export declare function createClient(name: string, instance?: string): CockpitClient;

package/types/core/config.d.ts

@@ -27,6 +27,16 @@ export interface CockpitConfig {
         timeoutSeconds?: number;
         notifyOnExit?: boolean;
     };
+    /** When shells end by themselves. */
+    lifecycle?: {
+        /**
+         * What happens to this window's shells when it closes. `stopMine` stops them, `keep` leaves
+         * them running for the next window — which is how shells survive an OpenCode restart.
+         */
+        onExit?: "stopMine" | "keep";
+        /** Stop a shell after this long with no window of its own connected. `0` never does. */
+        orphanAfterMinutes?: number;
+    };
     /** What is allowed to interrupt the agent. */
     notify?: {
         exit?: boolean;

package/types/tui/components/badge.d.ts

@@ -1,7 +1,13 @@
 /** @jsxImportSource @opentui/solid */
 import type { TuiPluginApi } from "@opencode-ai/plugin/tui";
 import type { ShellInfo } from "@opencode-cockpit/protocol/shell";
-/** Status pill: label on a coloured background, readable in any font and colour scheme. */
+/**
+ * Status mark: a coloured rule and its label.
+ *
+ * Not a filled pill. A block of colour has to be as wide as the word inside it, and a list of
+ * them reads as a wall of colour rather than as a list of shells; the rule carries the same
+ * meaning in one column.
+ */
 export declare function Badge(props: {
     api: TuiPluginApi;
     shell: ShellInfo;

package/types/tui/dialogs.d.ts

@@ -7,4 +7,9 @@ export declare function announceUpdate(api: TuiPluginApi, meta: TuiPluginMeta, c
 export declare function offerUpdate(api: TuiPluginApi, meta: TuiPluginMeta, current: string): void;
 export declare function newShell(api: TuiPluginApi, store: ShellStore, open: (id?: string) => void): void;
 export declare function restartDaemon(api: TuiPluginApi, store: ShellStore): void;
+/**
+ * Stopping shells in bulk. Two commands rather than one, because "everything I can see" and
+ * "everything, including what I cannot" are different intentions — and the second one asks first.
+ */
+export declare function stopShells(api: TuiPluginApi, store: ShellStore, reach: "view" | "project"): void;
 export declare function pickShell(api: TuiPluginApi, store: ShellStore, open: (id?: string) => void): void;

package/types/tui/lib/view.d.ts

@@ -7,8 +7,16 @@ export declare const BADGE_LABEL: Record<Kind, string>;
 /** Braille spinner: single-width in every terminal font. */
 export declare const SPINNER: string[];
 export declare function kindColor(theme: TuiThemeCurrent, kind: Kind): import("@opentui/core").RGBA;
-/** Fixed 7-column pill so lists line up: " ⠹ RUN ", " FAIL  ". */
+/**
+ * The status mark: a coloured rule and its label, in a fixed 7 columns so lists line up.
+ *
+ * It used to be a filled pill. Filled blocks have to be as wide as their text, so a column of
+ * them stacks into a wall of colour that competes with the shell names beside it; a rule carries
+ * the same colour in one column and lets the list breathe.
+ */
 export declare function badgeText(kind: Kind, frame?: number): string;
+/** The rule itself, so it can be coloured apart from the label it marks. */
+export declare const BADGE_RULE = "\u258C";
 /** Running first (oldest first, stable tabs), then failures, stopped, done (most recent first). */
 export declare function order(list: readonly ShellInfo[]): ShellInfo[];
 export interface PartitionOptions {

package/types/tui/state/store.d.ts

@@ -5,13 +5,20 @@ import { type Accessor } from "solid-js";
 export interface ShellStore {
     client: CockpitClient;
     project: () => string;
-    /** Every shell in the project, unordered. */
+    /** Shells the panel is about: the current conversation, or the project. */
     shells: Accessor<ShellInfo[]>;
+    /** Every shell in the project, whatever the panel is showing. */
+    all: Accessor<ShellInfo[]>;
     /** Ordered and folded for display: running, recent failures, plus the selection. */
     visible: Accessor<ShellInfo[]>;
     hidden: Accessor<ShellInfo[]>;
     showAll: Accessor<boolean>;
     toggleAll(): void;
+    /** Which shells the panel is about: the conversation you are in, or the whole project. */
+    scope: Accessor<Scope>;
+    toggleScope(): void;
+    /** The session the interface is currently showing, when it is showing one. */
+    session: Accessor<string | undefined>;
     connected: Accessor<boolean>;
     now: Accessor<number>;
     /** Spinner frame index; advances only while something is running. */
@@ -23,9 +30,13 @@ export interface ShellStore {
     clearFinished(): Promise<number>;
     dispose(): void;
 }
+/** A project's shells outnumber a conversation's, and mixing them is how the panel gets confusing. */
+export type Scope = "session" | "project";
 export interface StoreOptions {
     /** Failures stay in the default view this long after they end. */
     historyMinutes?: number;
+    /** What the panel lists by default. */
+    scope?: Scope;
 }
 export declare function createShellStore(api: TuiPluginApi, client: CockpitClient, options?: StoreOptions): ShellStore;
 /**