Install just via Homebrew in CI and update agent instructions

Co-authored-by: hanthor <5840441+hanthor@users.noreply.github.com>

Author: Copilot

.github/copilot-instructions.md

@@ -39,7 +39,18 @@ sudo just iso yellowfin base local
 ## Working Effectively
 
 ### Dependencies and Setup
-- Install Just command runner to a temp dir not the root of the repo: `mkdir -p /tmp/just && cd /tmp/just && wget https://github.com/casey/just/releases/download/1.32.0/just-1.32.0-x86_64-unknown-linux-musl.tar.gz -O just.tar.gz && tar xzf just.tar.gz && sudo mv just /usr/local/bin/ && cd - && rm -rf /tmp/just`
+- **Install Just via Homebrew** (recommended for consistency with CI):
+  ```bash
+  # Install Homebrew if not already installed
+  /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
+  
+  # Install just
+  brew install just
+  ```
+- **Alternative**: Install Just from GitHub releases to a temp dir (not recommended):
+  ```bash
+  mkdir -p /tmp/just && cd /tmp/just && wget https://github.com/casey/just/releases/download/1.32.0/just-1.32.0-x86_64-unknown-linux-musl.tar.gz -O just.tar.gz && tar xzf just.tar.gz && sudo mv just /usr/local/bin/ && cd - && rm -rf /tmp/just
+  ```
 - **CRITICAL**: NEVER extract just or any other tools directly into the repository root as this will overwrite project files like LICENSE and README.md
 - Podman is required for container builds (usually pre-installed in CI environments)
 - Shellcheck is required for linting: `sudo apt-get update && sudo apt-get install -y shellcheck`

.github/workflows/build-iso.yml

@@ -194,8 +194,11 @@ jobs:
       - name: Checkout
         uses: actions/checkout@1af3b93b6815bc44a9784bd300feb67ff0d1eeb3 # v5
 
-      - name: Setup Just
-        uses: extractions/setup-just@e33e0265a09d6d736e2ee1e0eb685ef1de4669ff # v3
+      - name: Setup Homebrew
+        uses: Homebrew/actions/setup-homebrew@master
+
+      - name: Install Just via Homebrew
+        run: brew install just
 
       - name: Check Just Syntax
         shell: bash

.github/workflows/reusable-build-image.yml

@@ -138,8 +138,11 @@ jobs:
         if: ${{ matrix.platform != 'linux/arm64' && inputs.cleanup_runner }}
         uses: ublue-os/container-storage-action@main
 
-      - name: Setup Just
-        uses: extractions/setup-just@e33e0265a09d6d736e2ee1e0eb685ef1de4669ff # v3
+      - name: Setup Homebrew
+        uses: Homebrew/actions/setup-homebrew@master
+
+      - name: Install Just via Homebrew
+        run: brew install just
 
       - name: Check Just Syntax
         shell: bash

AGENTS.md

@@ -2,6 +2,22 @@
 
 This document contains guidelines for AI agents (like GitHub Copilot) working on the TunaOS repository.
 
+## Setup Requirements
+
+### Install Just via Homebrew
+
+Before working on this repository, ensure you have `just` installed via Homebrew for consistency with CI:
+
+```bash
+# Install Homebrew if not already installed (Linux/macOS)
+/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
+
+# Install just
+brew install just
+```
+
+**Why Homebrew?** The CI environment uses Homebrew to install just, ensuring version consistency between local development and CI builds. This prevents formatting mismatches that can cause CI failures.
+
 ## Pre-Commit Requirements
 
 ### Always Run `just fix` Before Committing