@vibelord/lanes 1.0.0 → 1.0.2

package/payload/lanes/client/ghostty/common.conf

@@ -20,3 +20,6 @@ copy-on-select = clipboard
 mouse-shift-capture = never
 scrollback-limit = 10000000
 link-url = true
+
+# OSC 9 from the lanes sidebar (a lane that needs you) becomes a macOS notification when this window is not focused.
+desktop-notifications = true

package/payload/lanes/client/ghostty/lanes-palette-light.conf

@@ -0,0 +1,25 @@
+# BEGIN lanes tokens (generated by libexec/tokens.py --ghostty-light; do not edit by hand)
+# Optional: the cockpit palette regardless of your everyday Ghostty theme (install.sh --client --palette).
+# Slots 1-4 are the four tones, so 16-colour mode here equals truecolor mode. No font, padding or cursor keys.
+background = #f3f5f2
+foreground = #17241b
+cursor-color = #2f6b45
+selection-background = #d5ded6
+selection-foreground = #17241b
+palette = 0=#3b4a42
+palette = 1=#b7322a
+palette = 2=#1b7142
+palette = 3=#8a5a00
+palette = 4=#2456a8
+palette = 5=#7a3fb8
+palette = 6=#0f7b7b
+palette = 7=#56616d
+palette = 8=#5f6d66
+palette = 9=#c2332a
+palette = 10=#1b7a38
+palette = 11=#8f5a00
+palette = 12=#2860c4
+palette = 13=#8a4dc8
+palette = 14=#0f7272
+palette = 15=#17241b
+# END lanes tokens

package/payload/lanes/client/ghostty/lanes-palette.conf

@@ -0,0 +1,25 @@
+# BEGIN lanes tokens (generated by libexec/tokens.py --ghostty-dark; do not edit by hand)
+# Optional: the cockpit palette regardless of your everyday Ghostty theme (install.sh --client --palette).
+# Slots 1-4 are the four tones, so 16-colour mode here equals truecolor mode. No font, padding or cursor keys.
+background = #101318
+foreground = #edf1f5
+cursor-color = #b4e3bf
+selection-background = #2c333d
+selection-foreground = #edf1f5
+palette = 0=#7d8896
+palette = 1=#f28b7d
+palette = 2=#6fd39a
+palette = 3=#e5b84a
+palette = 4=#7fb3f2
+palette = 5=#c9a6ff
+palette = 6=#6fd6d0
+palette = 7=#9ca7b5
+palette = 8=#8a95a3
+palette = 9=#ff9d96
+palette = 10=#8fe0a3
+palette = 11=#f7cf7f
+palette = 12=#a5cbff
+palette = 13=#dcc6ff
+palette = 14=#9ae6e0
+palette = 15=#edf1f5
+# END lanes tokens

package/payload/lanes/client/ghostty/omarchy.conf

@@ -1,6 +1,7 @@
 # Omarchy / Hyprland specifics for the lanes window (Ghostty GTK, dedicated instance).
-# Look & feel is inherited from ~/.config/ghostty/config (Omarchy's default: theme include, JetBrainsMono Nerd
-# Font, shift+enter as CSI-u, control+insert / shift+insert copy & paste), so Omarchy theme switches follow.
+# Look & feel is inherited from ~/.config/ghostty/config (Omarchy's default: theme include, the Omarchy default font —
+# a Nerd Font is not required by lanes, every glyph is plain Unicode; shift+enter as CSI-u, control+insert /
+# shift+insert copy & paste), so Omarchy theme switches follow.
 # Do NOT include the theme file here as well: Ghostty reports a second include of the same file as
 # "config-file …: cycle detected" and opens its configuration-errors window.
 

package/payload/lanes/client/lanes-launch

@@ -3,6 +3,7 @@
 #   lanes-launch [device]        attach this terminal to the device's view session (default: see below)
 #   lanes-launch <workspace>     same, and bring that workspace's tab to the front (e.g. `coder-launch worlds`)
 #   lanes-launch <device> --viewports N   a wide view session: N (2-3) viewports side by side per workspace
+#   lanes-launch <device> [--ascii] [--theme dark|light|auto] [--glyphs M] [--color C]   the device's look (lanes attach)
 #   lanes-launch lane <lane-id>  attach straight to ONE lane, no multiplexer in between
 #   lanes-launch ls              list lanes with live status
 #   lanes-launch --helper <device> [--service | --while-pid PID]   run only the upload helper
@@ -41,11 +42,25 @@ case "${1:-}" in
     lane)
         [ -n "${2:-}" ] || { echo 'usage: lanes-launch lane <lane-id>' >&2; exit 64; }
         mode=open target=$2 ;;
-    -h|--help) sed -n '2,11p' "$0"; exit 0 ;;
+    -h|--help) sed -n '2,12p' "$0"; exit 0 ;;
     *) mode=attach target=${1:-$(default_device)} ;;
 esac
-if [ "$mode" = attach ] && [ "${2:-}" = --viewports ]; then
-    case "${3:-}" in 1|2|3) extra="--viewports $3" ;; *) echo '--viewports takes 1, 2 or 3' >&2; exit 64 ;; esac
+if [ "$mode" = attach ] && [ $# -gt 1 ]; then
+    # Options after the device go to `lanes attach`. They are spliced into the remote command line, so only this closed
+    # vocabulary passes: a bad value refuses before any connection, an unknown option is said out loud and dropped.
+    shift
+    while [ $# -gt 0 ]; do
+        case "$1" in
+            --viewports) case "${2:-}" in 1|2|3) extra="$extra --viewports $2"; shift ;; *) echo '--viewports takes 1, 2 or 3' >&2; exit 64 ;; esac ;;
+            --ascii) extra="$extra --ascii" ;;
+            --theme) case "${2:-}" in dark|light|auto) extra="$extra --theme $2"; shift ;; *) echo '--theme takes dark, light or auto' >&2; exit 64 ;; esac ;;
+            --glyphs) case "${2:-}" in unicode|ascii|emoji) extra="$extra --glyphs $2"; shift ;; *) echo '--glyphs takes unicode, ascii or emoji' >&2; exit 64 ;; esac ;;
+            --color) case "${2:-}" in truecolor|16|none) extra="$extra --color $2"; shift ;; *) echo '--color takes truecolor, 16 or none' >&2; exit 64 ;; esac ;;
+            *) echo "lanes-launch: ignoring unknown option $1" >&2 ;;
+        esac
+        shift
+    done
+    extra=${extra# }
 fi
 case "$target" in ''|-*|*[!A-Za-z0-9_.-]*) echo "invalid name: $target" >&2; exit 64 ;; esac
 client="$(hostname -s 2>/dev/null || echo client)-$$"
@@ -67,6 +82,8 @@ log() {
 # Run ssh as an async child so HUP/TERM (window closed, logout) end it immediately; a foreground child
 # would defer the trap until ssh returned. Keep the terminal on fd 9: dash gives async jobs /dev/null.
 child=
+dog=
+dog_ready=
 reader=
 holding=
 now=
@@ -76,6 +93,7 @@ stop() {
     trap - HUP TERM INT
     exec 2>/dev/null        # bash reports every child it sees die of a signal: noise in a terminal that stays open
     if [ -n "$child" ]; then kill -TERM "$child" 2>/dev/null || :; fi
+    cancel_watchdog
     if [ -n "$reader" ]; then kill -TERM "$reader" 2>/dev/null || :; fi
     end_helper
     log 'stopped: window closed, or a signal'
@@ -89,17 +107,56 @@ end_helper() {
 # INT too: in a plain terminal Ctrl-C is the way out, now that nothing else ends the client.
 trap stop HUP TERM INT
 # With $limit set, a watchdog ends a child that the server leaves hanging (macOS has no timeout(1)).
+cancel_watchdog() {
+    if [ -n "$dog" ]; then
+        # A very fast probe may finish before the forked shell has installed
+        # its trap. Wait for that handshake before sending cancellation.
+        while [ ! -s "$dog_ready" ] && kill -0 "$dog" 2>/dev/null; do sleep .01; done
+        kill -TERM "$dog" 2>/dev/null || :
+        wait "$dog" 2>/dev/null || :
+        dog=
+    fi
+    if [ -n "$dog_ready" ]; then rm -f "$dog_ready"; dog_ready=; fi
+}
 run() {
     exec 9<&0
     "$@" <&9 9<&- &
     child=$!
     exec 9<&-
     dog=
-    if [ -n "$limit" ]; then ( sleep "$limit"; kill -TERM "$child" ) >/dev/null 2>&1 & dog=$!; fi
+    dog_ready=
+    if [ -n "$limit" ]; then
+        if ! dog_ready=$(mktemp "${TMPDIR:-/tmp}/lanes-watchdog.XXXXXXXX"); then
+            kill -TERM "$child" 2>/dev/null || :
+            wait "$child" 2>/dev/null || :
+            child=; rc=1; return "$rc"
+        fi
+        (
+            # A foreground sleep can defer the shell's TERM handler, and
+            # killing only that shell leaves its sleep behind. An async
+            # timer lets wait handle cancellation and reap the owned child.
+            timer=; cancelled=
+            # The timer has no cleanup. KILL also covers its fork-to-exec
+            # window, before sleep has acquired its default signal handlers.
+            trap 'cancelled=1; [ -z "$timer" ] || kill -KILL "$timer" 2>/dev/null || :' HUP TERM INT
+            sleep "$limit" &
+            timer=$!
+            printf 'ready\n' > "$dog_ready"
+            # TERM can arrive between spawning the timer and assigning $!.
+            if [ -n "$cancelled" ]; then kill -KILL "$timer" 2>/dev/null || :; fi
+            wait "$timer" 2>/dev/null || :
+            if [ -n "$cancelled" ]; then
+                wait "$timer" 2>/dev/null || :
+            else
+                kill -TERM "$child" 2>/dev/null || :
+            fi
+        ) >/dev/null 2>&1 &
+        dog=$!
+    fi
     rc=0
     wait "$child" || rc=$?
     child=
-    if [ -n "$dog" ]; then kill -TERM "$dog" 2>/dev/null || :; wait "$dog" 2>/dev/null || :; fi
+    cancel_watchdog
     return "$rc"
 }
 # hold <seconds> [jitter]: wait, but Enter continues at once. No raw mode, so there is no terminal state to restore

package/payload/lanes/client/lanes-window

@@ -1,7 +1,9 @@
 #!/bin/sh
-# Open the lanes window in its own terminal instance. usage: lanes-window [suffix]
+# Open the lanes window in its own terminal instance. usage: lanes-window [--ascii] [--light|--dark] [suffix]
 #   suffix: an independent view session "<device>-<suffix>" (second monitor / other half of an ultrawide).
 #   w2 / w3: a WIDE view session with 2 / 3 viewports side by side per workspace (for a full-width window).
+#   --ascii / --light / --dark: the cockpit's look for this device (`lanes attach … --ascii|--theme`), remembered on
+#   the server in devices/<device>.json and picked up by a running sidebar and its status screens.
 # macOS: Ghostty. Linux: Ghostty when installed, otherwise Foot with the same window class.
 set -u
 config=${XDG_CONFIG_HOME:-$HOME/.config}/lanes
@@ -9,11 +11,25 @@ launch=$HOME/.local/bin/lanes-launch
 class=org.omarchy.lanes
 device=
 file=$config/ghostty.conf
+look=
+while [ $# -gt 0 ]; do
+    case "$1" in
+        --ascii) look="$look --ascii"; shift ;;
+        --light|--dark) look="$look --theme ${1#--}"; shift ;;
+        *) break ;;
+    esac
+done
 if [ -n "${1:-}" ]; then
     case "$1" in *[!A-Za-z0-9_.-]*) echo 'invalid suffix' >&2; exit 64 ;; esac
     device="$(head -n 1 "$config/device")-$1"
     case "$1" in w2) device="$device --viewports 2" ;; w3) device="$device --viewports 3" ;; esac
     file=$config/ghostty.$1.conf
+elif [ -n "$look" ]; then
+    device=$(head -n 1 "$config/device")
+    file=$config/ghostty.look.conf
+fi
+if [ -n "$device" ]; then
+    device="$device$look"
     sed "s|^command = .*|command = $launch $device|" "$config/ghostty.conf" > "$file"
 fi
 case "$(uname -s)" in

package/payload/lanes/container/env.sh

@@ -8,6 +8,14 @@
 #   * tmux is NOT affected: it honours TMUX_TMPDIR only, so lane sockets stay in /tmp/tmux-<uid>.
 #   * Nothing is created here: no directory (or a read-only one) = no change. Opt out per shell or for good with
 #     LANES_TMP_OPTOUT=1 (any value, even empty, counts). LANES_TMP_DIR names another directory.
+#
+# Lane identity is NOT set here (this file is shared by every shell in the container). A tmux lane's shell gets it
+# ONLY from the `-e` flags of its create recipe (`lanes_lib.canonical_recipe`, `tmux new -e …`): LANE_ID
+# (<ws>--<slug>), LANE_WS (<ws>), THROTTLE_TRACE and ANTHROPIC_CUSTOM_HEADERS ('x-throttle-trace: lanes/<ws>/<id>';
+# trace charset [A-Za-z0-9._-/], at most 256). Never export them from a profile or a client: the client that starts
+# a shared board socket's tmux server copies its env into the server's GLOBAL env, which every later session there
+# without its own -e inherits (DEF-1478) — so `lane open` strips them. A running lane gains its identity only when it
+# is next created by a recipe carrying -e; a legacy recipe without -e gives none (`lanes cursor-sync --identity`).
 if [ -z "${LANES_TMP_OPTOUT+set}" ] && [ -d "${LANES_TMP_DIR:-/home/coder/.tmp}" ] \
         && [ -w "${LANES_TMP_DIR:-/home/coder/.tmp}" ] && [ -x "${LANES_TMP_DIR:-/home/coder/.tmp}" ]; then
     TMPDIR=${LANES_TMP_DIR:-/home/coder/.tmp}

package/payload/lanes/container/hooks/claude-settings.json

@@ -0,0 +1,10 @@
+{"hooks": {
+  "UserPromptSubmit": [{"hooks": [{"type": "command", "command": "~/.lz/bin/lane-signal working --event UserPromptSubmit --harness claude", "timeout": 2}]}],
+  "PostToolUse": [{"hooks": [{"type": "command", "command": "~/.lz/bin/lane-signal working --event PostToolUse --harness claude", "timeout": 2}]}],
+  "Stop": [{"hooks": [{"type": "command", "command": "~/.lz/bin/lane-signal needs_input --event Stop --harness claude", "timeout": 2}]}],
+  "Notification": [{"matcher": "permission_prompt", "hooks": [{"type": "command", "command": "~/.lz/bin/lane-signal needs_approval --event Notification --harness claude", "timeout": 2}]},
+                   {"matcher": "idle_prompt", "hooks": [{"type": "command", "command": "~/.lz/bin/lane-signal needs_input --event Notification --harness claude", "timeout": 2}]}],
+  "PermissionRequest": [{"hooks": [{"type": "command", "command": "~/.lz/bin/lane-signal needs_approval --event PermissionRequest --harness claude", "timeout": 2}]}],
+  "SessionEnd": [{"hooks": [{"type": "command", "command": "~/.lz/bin/lane-signal shell --event SessionEnd --harness claude", "timeout": 2}]}],
+  "StopFailure": [{"hooks": [{"type": "command", "command": "~/.lz/bin/lane-signal errored --event StopFailure --harness claude", "timeout": 2}]}]
+}}

package/payload/lanes/container/hooks/codex-hooks.json

@@ -0,0 +1,22 @@
+{
+  "hooks": {
+    "SessionStart": [
+      {"matcher": null, "hooks": [{"type": "command", "command": "~/.lz/bin/lane-signal idle --event SessionStart --harness codex", "timeout": 2}]}
+    ],
+    "UserPromptSubmit": [
+      {"matcher": null, "hooks": [{"type": "command", "command": "~/.lz/bin/lane-signal working --event UserPromptSubmit --harness codex", "timeout": 2}]}
+    ],
+    "PostToolUse": [
+      {"matcher": null, "hooks": [{"type": "command", "command": "~/.lz/bin/lane-signal working --event PostToolUse --harness codex", "timeout": 2}]}
+    ],
+    "PermissionRequest": [
+      {"matcher": null, "hooks": [{"type": "command", "command": "~/.lz/bin/lane-signal needs_approval --event PermissionRequest --harness codex", "timeout": 2}]}
+    ],
+    "Stop": [
+      {"matcher": null, "hooks": [{"type": "command", "command": "~/.lz/bin/lane-signal done --event Stop --harness codex", "timeout": 2}]}
+    ],
+    "SessionEnd": [
+      {"matcher": null, "hooks": [{"type": "command", "command": "~/.lz/bin/lane-signal shell --event SessionEnd --harness codex", "timeout": 2}]}
+    ]
+  }
+}