feat(tmux): add --binary flag for testing compiled CLI binaries

- Add -b/--binary flag to tmux-start.sh (defaults to ./cli/bin/codebuff)
- Add CODEBUFF_BINARY env var support for specifying binary path
- Record cli_mode (binary/dynamic) and cli_command in session-info.yaml
- Update README.md and tmux-cli.sh help with binary testing docs

This enables @cli-ui-tester to test compiled binaries vs dynamic dev mode.

Author: brandonkachen

scripts/tmux/README.md

@@ -29,7 +29,7 @@ tmux send-keys -t session "hello world"
 ## Quick Start
 
 ```bash
-# Start a test session
+# Start a test session (dynamic CLI via bun)
 SESSION=$(./scripts/tmux/tmux-cli.sh start)
 echo "Started session: $SESSION"
 
@@ -43,6 +43,26 @@ echo "Started session: $SESSION"
 ./scripts/tmux/tmux-cli.sh stop "$SESSION"
 ```
 
+## Testing Compiled Binaries
+
+To test a compiled CLI binary instead of the dynamic development server:
+
+```bash
+# Build the binary first
+cd cli && bun run build:binary
+
+# Test with binary at default location (./cli/bin/codebuff)
+SESSION=$(./scripts/tmux/tmux-cli.sh start --binary)
+
+# Or specify a custom binary path
+SESSION=$(./scripts/tmux/tmux-cli.sh start --binary /path/to/codebuff)
+
+# Or use environment variable
+CODEBUFF_BINARY=./cli/bin/codebuff ./scripts/tmux/tmux-cli.sh start
+```
+
+The session-info.yaml will record which mode was used (`cli_mode: binary` or `cli_mode: dynamic`).
+
 ## Scripts
 
 ### `tmux-cli.sh` (Unified Interface)
@@ -63,7 +83,7 @@ The main entry point with subcommands:
 Start a new tmux session with the CLI.
 
 ```bash
-# Default settings
+# Default settings (dynamic CLI)
 ./scripts/tmux/tmux-start.sh
 # Output: cli-test-1234567890
 
@@ -75,6 +95,15 @@ Start a new tmux session with the CLI.
 
 # Custom wait time for CLI initialization
 ./scripts/tmux/tmux-start.sh --wait 6
+
+# Test a compiled binary (default location: ./cli/bin/codebuff)
+./scripts/tmux/tmux-start.sh --binary
+
+# Test a compiled binary at custom path
+./scripts/tmux/tmux-start.sh --binary /path/to/binary
+
+# Via environment variable
+CODEBUFF_BINARY=./my-binary ./scripts/tmux/tmux-start.sh
 ```
 
 ### `tmux-send.sh`
@@ -183,6 +212,8 @@ started_local: Wed Jan  1 12:00:00 PST 2025
 dimensions:
   width: 120
   height: 30
+cli_mode: dynamic  # or "binary"
+cli_command: bun --cwd=cli run dev  # or path to binary
 status: active
 ```
 

scripts/tmux/tmux-cli.sh

@@ -45,6 +45,11 @@
 #   ./scripts/tmux/tmux-cli.sh capture "$SESSION" --wait 3
 #   ./scripts/tmux/tmux-cli.sh stop "$SESSION"
 #
+#   # Test a compiled binary (instead of dynamic CLI)
+#   SESSION=$(./scripts/tmux/tmux-cli.sh start --binary)
+#   # Or with custom path:
+#   SESSION=$(./scripts/tmux/tmux-cli.sh start --binary ./path/to/codebuff)
+#
 #   # Stop all test sessions
 #   ./scripts/tmux/tmux-cli.sh stop --all
 #

scripts/tmux/tmux-start.sh

@@ -17,6 +17,9 @@
 #   -w, --width WIDTH   Terminal width (default: 120)
 #   -h, --height HEIGHT Terminal height (default: 80)
 #   --wait SECONDS      Seconds to wait for CLI to initialize (default: 4)
+#   -b, --binary [PATH] Use compiled binary instead of dynamic CLI
+#                       If PATH omitted, uses ./cli/bin/codebuff
+#                       Can also set CODEBUFF_BINARY env var
 #   --help              Show this help message
 #
 # SESSION LOGS:
@@ -36,6 +39,15 @@
 #   # Start with custom dimensions
 #   ./scripts/tmux/tmux-start.sh -w 160 -h 40
 #
+#   # Test a compiled binary (default location)
+#   ./scripts/tmux/tmux-start.sh --binary
+#
+#   # Test a compiled binary at custom path
+#   ./scripts/tmux/tmux-start.sh --binary ./path/to/codebuff
+#
+#   # Via environment variable
+#   CODEBUFF_BINARY=./cli/bin/codebuff ./scripts/tmux/tmux-start.sh
+#
 # EXIT CODES:
 #   0 - Success (session name printed to stdout)
 #   1 - Error (tmux not found or session creation failed)
@@ -44,11 +56,17 @@
 
 set -e
 
+# Get project root early (needed for defaults)
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_ROOT="$(cd "$SCRIPT_DIR/../.." && pwd)"
+
 # Defaults
 SESSION_NAME=""
 WIDTH=120
 HEIGHT=30  # Reasonable default that matches typical terminal heights
 WAIT_SECONDS=4
+DEFAULT_BINARY="$PROJECT_ROOT/cli/bin/codebuff"
+BINARY_PATH="${CODEBUFF_BINARY:-}"  # Environment variable takes precedence
 
 # Parse arguments
 while [[ $# -gt 0 ]]; do
@@ -69,8 +87,19 @@ while [[ $# -gt 0 ]]; do
             WAIT_SECONDS="$2"
             shift 2
             ;;
+        -b|--binary)
+            # Check if next arg is a path (not another flag or missing)
+            if [[ -n "${2:-}" && "${2:-}" != -* ]]; then
+                BINARY_PATH="$2"
+                shift 2
+            else
+                # --binary alone uses default location
+                BINARY_PATH="$DEFAULT_BINARY"
+                shift
+            fi
+            ;;
         --help)
-            head -n 40 "$0" | tail -n +2 | sed 's/^# //' | sed 's/^#//'
+            head -n 50 "$0" | tail -n +2 | sed 's/^# //' | sed 's/^#//'
             exit 0
             ;;
         *)
@@ -96,13 +125,36 @@ if ! command -v tmux &> /dev/null; then
     exit 1
 fi
 
-# Get project root (assuming script is in scripts/tmux/)
-PROJECT_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/../.." && pwd)"
+# Determine CLI command (binary vs dynamic)
+if [[ -n "$BINARY_PATH" ]]; then
+    # Binary mode - validate the binary exists and is executable
+    if [[ ! -f "$BINARY_PATH" ]]; then
+        echo "❌ Binary not found: $BINARY_PATH" >&2
+        echo "" >&2
+        echo "💡 Build the binary first:" >&2
+        echo "   cd cli && bun run build:binary" >&2
+        exit 1
+    fi
+    if [[ ! -x "$BINARY_PATH" ]]; then
+        echo "❌ Binary not executable: $BINARY_PATH" >&2
+        echo "" >&2
+        echo "💡 Fix with: chmod +x '$BINARY_PATH'" >&2
+        exit 1
+    fi
+    CLI_CMD="cd '$PROJECT_ROOT' && '$BINARY_PATH' 2>&1"
+    CLI_MODE="binary"
+    CLI_DISPLAY="$BINARY_PATH"
+else
+    # Dynamic mode (default) - run via bun
+    CLI_CMD="cd '$PROJECT_ROOT' && bun --cwd=cli run dev 2>&1"
+    CLI_MODE="dynamic"
+    CLI_DISPLAY="bun --cwd=cli run dev"
+fi
 
 # Create tmux session running CLI
 if ! tmux new-session -d -s "$SESSION_NAME" \
     -x "$WIDTH" -y "$HEIGHT" \
-    "cd '$PROJECT_ROOT' && bun --cwd=cli run dev 2>&1" 2>/dev/null; then
+    "$CLI_CMD" 2>/dev/null; then
     echo "❌ Failed to create tmux session" >&2
     exit 1
 fi
@@ -119,6 +171,8 @@ started_local: $(date)
 dimensions:
   width: $WIDTH
   height: $HEIGHT
+cli_mode: $CLI_MODE
+cli_command: $CLI_DISPLAY
 status: active
 EOF