playbook: add 60-second-darwin playbook

Add a variant of 60-second-linux for macOS (darwin). This toolbox
doesn't use Nix, since PRoot (or equivalent) is not available for macOS.

Author: avelanarius

.github/workflows/build-toolbox.yml

@@ -22,12 +22,12 @@ jobs:
           - runner: ubuntu-24.04-arm
             os: linux
             arch: arm64
-          # - runner: macos-13
-          #   os: darwin
-          #   arch: amd64
-          # - runner: macos-15
-          #   os: darwin
-          #   arch: arm64
+          - runner: macos-13
+            os: darwin
+            arch: amd64
+          - runner: macos-15
+            os: darwin
+            arch: arm64
     steps:
       - name: Checkout
         uses: actions/checkout@v5
@@ -49,13 +49,22 @@ jobs:
           cd toolbox
           go build -o toolbox-builder
 
-      - name: Build toolbox archive
+      - name: Build toolbox archive (Linux)
+        if: matrix.os == 'linux'
         shell: bash
         run: |
           set -euo pipefail
           cd toolbox
           ./toolbox-builder --playbook ../playbook/60-second-linux.yaml --out .
 
+      - name: Build toolbox archive (Darwin)
+        if: matrix.os == 'darwin'
+        shell: bash
+        run: |
+          set -euo pipefail
+          cd toolbox
+          ./toolbox-builder --playbook ../playbook/60-second-darwin.yaml --out .
+
       - name: Upload artifact
         uses: actions/upload-artifact@v4
         with:

app/toolbox.go

@@ -14,9 +14,10 @@ import (
 	"strings"
 	"time"
 
+	"gradient-engineer/playbook"
+
 	"github.com/ulikunitz/xz"
 	"gopkg.in/yaml.v3"
-	"gradient-engineer/playbook"
 )
 
 // DiagnosticCommand represents a diagnostic command with its actual command and display name
@@ -217,7 +218,11 @@ func (t *Toolbox) GetDiagnosticCommands() ([]DiagnosticCommand, error) {
 				cmdStr = prootPrefix + " " + resolved
 			}
 		} else {
-			return nil, fmt.Errorf("binary for command '%s' not found in toolbox nix store", binName)
+			if runtime.GOOS == "darwin" {
+				cmdStr = c.Command // Nix + PRoot not available on macOS
+			} else {
+				return nil, fmt.Errorf("binary for command '%s' not found in toolbox nix store", binName)
+			}
 		}
 
 		timeout := 5 * time.Second

app/ui.go

@@ -154,7 +154,13 @@ func (m *model) Update(msg tea.Msg) (tea.Model, tea.Cmd) {
 		}
 		m.downloaded = true
 		// Populate commands now that toolbox is available
-		m.commands, _ = m.toolbox.GetDiagnosticCommands()
+		commands, err := m.toolbox.GetDiagnosticCommands()
+		if err != nil {
+			fmt.Println(err)
+			m.done = true
+			return m, tea.Quit
+		}
+		m.commands = commands
 		n := len(m.commands)
 		m.statuses = make([]commandStatus, n)
 		m.outputs = make([]string, n)

playbook/60-second-darwin.yaml

@@ -0,0 +1,35 @@
+id: 60-second-darwin
+system_prompt: |
+  ### 60-second macOS analysis
+
+  Please analyze the following macOS system diagnostic output. Focus on identifying any performance issues, errors, or notable system characteristics.
+
+  - Be concise but comprehensive
+  - Start with a 1-sentence overview and the key finding
+  - Prefer bullet points where helpful
+  - Keep the total length to 2-3 short paragraphs (including bullets)
+
+  When recommending actions, prioritize practical steps.
+commands:
+  - command: uptime
+    description: System uptime and load averages
+  - command: log show --style syslog --last 1m
+    description: Recent system log entries (last 1 minute)
+  - command: vm_stat 1
+    description: Virtual memory paging, 1s updates
+  - command: ps -M -o pid,%cpu,comm -r
+    description: Threads sorted by CPU to spot hot single-thread bottlenecks
+  - command: top -l 999 -s 1 -o cpu
+    description: Per-process CPU usage, 1s rolling view
+  - command: iostat -d -w 1
+    description: Disk I/O per device, 1s updates (KB/t, tps, MB/s)
+  - command: memory_pressure -Q
+    description: Memory pressure summary (free, purgeable, compressed)
+  - command: netstat -w 1 -i
+    description: Network device statistics for all interfaces, 1s updates
+  - command: netstat -s -p tcp
+    description: TCP health snapshot (retransmits, connection stats)
+  - command: top -l 1
+    description: One-shot system snapshot (CPU breakdown, processes, PhysMem)
+
+

scripts/60-second-linux.sh

@@ -23,7 +23,7 @@ BIN="$TMPDIR/gradient-engineer"
 
 curl -fsSL -o "$BIN" "https://gradient.engineer/binary/gradient-engineer.${OS}.${ARCH}"
 chmod +x "$BIN"
-"$BIN" 60-second-linux
+"$BIN" "60-second-$OS"
 
 rm -f "$BIN"
 rmdir "$TMPDIR"

toolbox/generate.go

@@ -11,9 +11,10 @@ import (
 	"runtime"
 	"time"
 
+	"gradient-engineer/playbook"
+
 	"github.com/spf13/cobra"
 	"gopkg.in/yaml.v3"
-	"gradient-engineer/playbook"
 )
 
 var (
@@ -33,9 +34,6 @@ target systems.`,
 			if playbookPath == "" {
 				return fmt.Errorf("playbook path is required")
 			}
-			if runtime.GOOS != "linux" {
-				return fmt.Errorf("this utility must run on Linux")
-			}
 			return nil
 		},
 		RunE: func(cmd *cobra.Command, args []string) error {
@@ -46,7 +44,7 @@ target systems.`,
 	// Define flags
 	rootCmd.Flags().StringVarP(&playbookPath, "playbook", "p", "", "Path to playbook file (required)")
 	rootCmd.Flags().StringVarP(&outDir, "out", "o", ".", "Output directory for generated archive")
-	
+
 	// Mark required flags
 	rootCmd.MarkFlagRequired("playbook")
 
@@ -61,8 +59,10 @@ func generateToolbox() error {
 	if err != nil {
 		return fmt.Errorf("failed to read playbook: %w", err)
 	}
-	if len(cfg.Nixpkgs.Packages) == 0 {
-		return fmt.Errorf("no nixpkgs.packages listed in %s", playbookPath)
+	if runtime.GOOS == "linux" {
+		if len(cfg.Nixpkgs.Packages) == 0 {
+			return fmt.Errorf("no nixpkgs.packages listed in %s", playbookPath)
+		}
 	}
 
 	workDir, err := os.MkdirTemp("", "toolbox_work_*")
@@ -75,12 +75,15 @@ func generateToolbox() error {
 	}()
 
 	toolboxDir, _ := filepath.Abs(filepath.Join(workDir, "toolbox"))
-	if err := nixCopy(toolboxDir, cfg.Nixpkgs.Version, cfg.Nixpkgs.Packages); err != nil {
-		return fmt.Errorf("nix copy failed: %w", err)
-	}
 
-	if err := fetchAndInstallProot(toolboxDir); err != nil {
-		return fmt.Errorf("failed to install proot: %w", err)
+	if runtime.GOOS == "linux" {
+		if err := nixCopy(toolboxDir, cfg.Nixpkgs.Version, cfg.Nixpkgs.Packages); err != nil {
+			return fmt.Errorf("nix copy failed: %w", err)
+		}
+
+		if err := fetchAndInstallProot(toolboxDir); err != nil {
+			return fmt.Errorf("failed to install proot: %w", err)
+		}
 	}
 
 	// Include the playbook file inside the toolbox directory
@@ -261,9 +264,17 @@ func createTarXz(outPath string, dir string) error {
 	parent := filepath.Dir(dir)
 	base := filepath.Base(dir)
 
-	cmd := exec.Command("tar", "-I", "xz -e -9 -T0", "-cf", outPath, base)
+	if runtime.GOOS == "linux" {
+		cmd := exec.Command("tar", "-I", "xz -e -9 -T0", "-cf", outPath, base)
+		cmd.Dir = parent
+		cmd.Stdout = os.Stdout
+		cmd.Stderr = os.Stderr
+		return cmd.Run()
+	}
+
+	cmd := exec.Command("tar", "-cJf", outPath, "--options", "xz:compression-level=9", base)
 	cmd.Dir = parent
 	cmd.Stdout = os.Stdout
 	cmd.Stderr = os.Stderr
 	return cmd.Run()
-}
+}