batipanel 0.4.0 → 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.0
+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/lib/layout.sh

@@ -74,15 +74,21 @@ run_remote() {
 }
 
 # Launch system monitor: btop → htop → top
-# btop needs ~80x24 minimum; auto-fallback to htop/top for small panes
+# btop needs ~80x24 minimum; if pane is too small, let user choose
 run_monitor() {
   local pane="$1"
   label_pane "$pane" "Monitor"
-  local pw ph
-  pw=$(tmux display-message -t "$pane" -p '#{pane_width}' 2>/dev/null || echo 0)
-  ph=$(tmux display-message -t "$pane" -p '#{pane_height}' 2>/dev/null || echo 0)
-  if has_cmd btop && (( pw >= 80 && ph >= 24 )); then
-    tmux send-keys -t "$pane" "btop" Enter
+  if has_cmd btop; then
+    local pw ph
+    pw=$(tmux display-message -t "$pane" -p '#{pane_width}' 2>/dev/null || echo 0)
+    ph=$(tmux display-message -t "$pane" -p '#{pane_height}' 2>/dev/null || echo 0)
+    if (( pw >= 80 && ph >= 24 )); then
+      tmux send-keys -t "$pane" "btop" Enter
+    else
+      # pane too small for btop — let user choose
+      tmux send-keys -t "$pane" \
+        "echo 'Pane is ${pw}x${ph} (btop needs 80x24)' && echo '' && echo '  1) btop  (force — or zoom with Alt+f first)' && echo '  2) htop' && echo '  3) top' && echo '' && printf 'Choose [1]: ' && read -r _c && case \${_c:-1} in 2) htop;; 3) top;; *) btop;; esac" Enter
+    fi
   elif has_cmd htop; then
     tmux send-keys -t "$pane" "htop" Enter
   elif has_cmd top; then

package/lib/themes.sh

@@ -31,9 +31,9 @@ _apply_theme() {
     echo "BATIPANEL_THEME=\"$theme\"" > "$TMUX_CONFIG"
   fi
 
-  # live reload tmux if running
+  # live reload: apply theme overlay to all running tmux servers
   if command -v tmux &>/dev/null && tmux list-sessions &>/dev/null 2>&1; then
-    tmux source-file "$BATIPANEL_HOME/config/tmux.conf" 2>/dev/null || true
+    # source theme.conf directly (not tmux.conf which reloads defaults first)
     tmux source-file "$BATIPANEL_HOME/config/theme.conf" 2>/dev/null || true
   fi
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "batipanel",
-  "version": "0.4.0",
+  "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"