batipanel 0.4.1 → 0.4.2

package/README.md

@@ -132,6 +132,69 @@ That's it. The wizard asks 2 questions (screen size + workflow) and sets up your
 
 ## Installation
 
+### Complete beginner? Start here
+
+**터미널 사용이 처음이거나, npm/Homebrew가 없는 경우** 아래 순서를 따르세요:
+
+<details>
+<summary><b>macOS — 처음부터 설치하기</b></summary>
+
+1. **Terminal 열기**: `Cmd + Space` → "Terminal" 검색 → 실행
+
+2. **설치 명령어 실행** (복사 후 붙여넣기):
+   ```bash
+   git clone https://github.com/batiai/batipanel.git
+   cd batipanel
+   bash install.sh
+   ```
+   - Homebrew가 없으면 자동으로 설치 안내가 나옵니다
+   - 비밀번호를 물어보면 Mac 로그인 비밀번호 입력
+
+3. **새 터미널 열기** 후 실행:
+   ```bash
+   b
+   ```
+
+> **npm/npx로 설치하고 싶다면**: 먼저 [nvm](https://github.com/nvm-sh/nvm)을 설치하세요:
+> ```bash
+> curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash
+> source ~/.zshrc
+> nvm install --lts
+> npx batipanel
+> ```
+
+</details>
+
+<details>
+<summary><b>Linux / WSL — 처음부터 설치하기</b></summary>
+
+1. **터미널 열기**
+
+2. **설치 명령어 실행**:
+   ```bash
+   git clone https://github.com/batiai/batipanel.git
+   cd batipanel
+   bash install.sh
+   ```
+   - 모든 도구(tmux, btop 등)가 자동 설치됩니다
+
+3. **새 터미널 열기** 후 실행:
+   ```bash
+   b
+   ```
+
+> **npm/npx로 설치하고 싶다면**: 먼저 [nvm](https://github.com/nvm-sh/nvm)을 설치하세요:
+> ```bash
+> curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash
+> source ~/.bashrc
+> nvm install --lts
+> npx batipanel
+> ```
+
+</details>
+
+---
+
 ### npm / npx
 
 ```bash
@@ -166,6 +229,7 @@ bash install.sh
 ```
 
 The installer auto-detects your package manager (apt, dnf, pacman, brew) and installs everything.
+On macOS without Homebrew, the installer will offer to install it automatically.
 
 ### Windows (WSL)
 

package/VERSION

@@ -1 +1 @@
-0.4.1
+0.4.2

package/install.sh

@@ -25,6 +25,44 @@ has_cmd() { command -v "$1" &>/dev/null; }
 echo ""
 echo "Checking tools..."
 
+# macOS: auto-install Homebrew if missing (required for tmux and other tools)
+if [ "$OS" = "Darwin" ] && ! has_cmd brew; then
+  echo ""
+  echo "Homebrew is not installed (required for macOS package management)."
+  if [ -t 0 ]; then
+    printf "Install Homebrew automatically? [Y/n]: "
+    read -r yn
+    yn="${yn:-Y}"
+    if [[ "$yn" =~ ^[Yy] ]]; then
+      echo "Installing Homebrew..."
+      /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
+      # add to PATH for this session (Apple Silicon vs Intel)
+      if [ -f /opt/homebrew/bin/brew ]; then
+        eval "$(/opt/homebrew/bin/brew shellenv)"
+      elif [ -f /usr/local/bin/brew ]; then
+        eval "$(/usr/local/bin/brew shellenv)"
+      fi
+      if has_cmd brew; then
+        echo "Homebrew installed successfully."
+      else
+        echo "Homebrew install completed but 'brew' not found in PATH."
+        echo "  Close and reopen Terminal, then re-run this installer."
+        exit 1
+      fi
+    else
+      echo ""
+      echo "Homebrew is required on macOS. Install manually:"
+      echo "  /bin/bash -c \"\$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)\""
+      echo ""
+      echo "Then re-run: bash install.sh"
+      exit 1
+    fi
+  else
+    echo "  Install Homebrew first: https://brew.sh"
+    exit 1
+  fi
+fi
+
 install_packages() {
   local packages=("$@")
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "batipanel",
-  "version": "0.4.1",
+  "version": "0.4.2",
   "description": "AI-powered terminal workspace manager — multi-panel tmux layouts with Claude Code, git, monitoring, and more",
   "bin": {
     "batipanel": "./bin/cli.sh"