batipanel 0.4.34 → 0.4.36

package/README.md

@@ -1,7 +1,7 @@
 <p align="center">
   <strong>batipanel</strong> — AI-Powered Terminal Workspace Manager
   <br/>
-  <a href="https://batipanel.com">Website</a> · <a href="https://batipanel.com/download">Desktop App</a> · <a href="https://github.com/batiai/batipanel/issues">Issues</a>
+  <a href="https://batipanel.com">Website</a> · <a href="docs/999-roadmap.md">Roadmap</a> · <a href="https://github.com/batiai/batipanel/issues">Issues</a>
 </p>
 
 <p align="center">
@@ -18,47 +18,63 @@
 
 ---
 
-One command to launch a fully configured, beautifully themed multi-panel development environment with **Claude Code**, **Git UI**, **system monitor**, **file browser**, and more.
+**One command. Full dev environment.** Auto-installs Claude Code, lazygit, btop, yazi + configures your terminal. Manage everything as persistent tmux sessions with just `b`.
 
-```
-┌────────────────────────────────┬──────────────┐
-│                                │ system       │
-│  Claude Code (AI assistant)    │ monitor      │
-│                                ├──────────────┤
-│                                │ file tree    │
-│                                ├──────────────┤
-│                                │ remote ctrl  │
-├───────────┬────────────────────┴──────────────┤
-│ git       │ terminal           │ logs         │
-└───────────┴────────────────────┴──────────────┘
+```bash
+curl -fsSL batipanel.com/install.sh | bash
 ```
 
+<p align="center">
+  <img src="docs/images/demo.gif" width="720" alt="batipanel demo — install to workspace in 30 seconds"/>
+</p>
+
+### What happens when you run this:
+
+1. **Auto-installs everything** — tmux, Claude Code, lazygit, btop, yazi, eza (+ Nerd Font on macOS)
+2. **Configures your terminal** — themed prompt, powerline glyphs, color scheme
+3. **One command to start** — `b myproject` launches a multi-panel workspace
+4. **Session persistence** — SSH drops? Terminal closed? `b myproject` brings it all back.
+
+<p align="center">
+  <a href="docs/images/layout-7panel.png"><img src="docs/images/layout-7panel.png" width="49%" alt="7panel layout"/></a>
+  <a href="docs/images/themes-all.png"><img src="docs/images/themes-all.png" width="49%" alt="8 color themes"/></a>
+</p>
+<p align="center">
+  <a href="docs/images/layout-4panel.png"><img src="docs/images/layout-4panel.png" width="49%" alt="4panel layout"/></a>
+  <a href="docs/images/layout-dual-claude.png"><img src="docs/images/layout-dual-claude.png" width="49%" alt="dual-claude layout"/></a>
+</p>
+<p align="center">
+  <sub>click to enlarge — 7panel (default) · 8 themes · 4panel (laptop) · dual-claude (multi AI)</sub>
+</p>
+
 ## Quick Start
 
 ```bash
 # Install (pick one)
-curl -fsSL https://batipanel.com/install.sh | bash   # Recommended
-npx batipanel                                         # npm/npx
-brew install batiai/tap/batipanel                      # Homebrew
+npx batipanel                                         # Node.js users (quickest)
+npm install -g batipanel                              # Node.js users (global)
+curl -fsSL https://batipanel.com/install.sh | bash    # Everyone else
 
-# Launch — the setup wizard guides you through everything
-b
-```
+# Start your workspace
+b myproject
 
-That's it. The wizard asks 2 questions (screen size + workflow) and sets up your workspace.
+# Done? Detach with:
+# Ctrl+b then d    ← session keeps running in the background
+# b myproject      ← come back anytime, everything restored
+```
 
 ---
 
-## Why batipanel?
+## Key Features
 
-| | What it does |
+| | |
 |---|---|
-| **AI-First Workspace** | Claude Code gets 55%+ of screen space. Remote Control panel lets you command AI from any pane. Dual-Claude layout for multi-agent workflows. |
-| **Multi-Panel Dev Tools** | lazygit, btop, yazi, terminal, logs — all auto-launched in themed panels. Missing tools gracefully fallback (btop → htop → top). |
-| **8 Layout Presets** | From 4-panel laptop mode to 8-panel ultrawide. Switch anytime with `b myproject --layout 6panel`. |
-| **Instant Session Resume** | tmux-powered persistence. SSH drops? Terminal closed? `b myproject` brings everything back exactly as you left it. |
-| **8 Color Themes** | Dracula, Nord, Gruvbox, Tokyo Night, Catppuccin, Rose Pine, Kanagawa + default. Powerline-style status bar and shell prompt. Live reload. |
-| **AI Telegram Bot** | Deploy a personal AI bot in Docker with `b server init && b server start`. Zero extra cost for Claude Max users. |
+| **All-in-one install** | One command sets up Claude Code + 5 dev tools + terminal theme. No manual config. |
+| **Session management** | `b start`, `b stop`, `b ls` — manage workspaces like containers. Persistent across disconnects. |
+| **8 layouts** | From 4-panel laptop to 8-panel ultrawide. Switch with `b myproject --layout 6panel`. |
+| **8 color themes** | Dracula, Nord, Gruvbox, Tokyo Night, Catppuccin, Rose Pine, Kanagawa. Live reload with `b theme`. |
+| **Smart fallbacks** | Every tool has a fallback. No btop? Uses htop. No htop? Uses top. Nothing breaks. |
+| **Cross-platform** | macOS (Terminal.app, iTerm2) + Linux (Ubuntu, Amazon Linux, CentOS) + WSL. |
 
 ---
 
@@ -490,6 +506,23 @@ On distributions with old tmux (e.g. Amazon Linux 2 ships 1.8), the installer wi
 
 ---
 
+## Documentation
+
+| | |
+|---|---|
+| [Getting Started](docs/100-getting-started.md) | Install, first run, activation |
+| [Usage Guide](docs/200-usage-guide.md) | Commands, sessions, project management |
+| [Layouts & Panels](docs/300-layouts-panels.md) | 8 presets, panel types, customization |
+| [Themes](docs/400-themes-appearance.md) | 8 color themes, fonts, prompt styling |
+| [Configuration](docs/500-configuration.md) | config.sh, tmux.conf, env variables |
+| [Supported Tools](docs/600-supported-tools.md) | Claude Code, lazygit, btop, yazi, eza |
+| [Remote & SSH](docs/700-remote-ssh.md) | Server sessions, detach/reattach |
+| [FAQ](docs/800-faq-troubleshooting.md) | Troubleshooting, platform-specific fixes |
+| [Contributing](docs/900-contributing.md) | Dev setup, testing, PR guidelines |
+| [Roadmap](docs/999-roadmap.md) | Planned features, what's next |
+
+---
+
 ## Contributing
 
 Contributions welcome! See [CONTRIBUTING.md](CONTRIBUTING.md) for details.

package/VERSION

@@ -1 +1 @@
-0.4.34
+0.4.36

package/config/btop/btop.conf

@@ -0,0 +1,8 @@
+# batipanel btop config — compact mode for multi-panel layouts
+# Shows only CPU graph + process list (no memory, network, disk boxes)
+shown_boxes = "cpu proc"
+vim_keys = True
+rounded_corners = True
+theme_background = False
+proc_per_core = False
+update_ms = 2000

package/install.sh

@@ -8,13 +8,15 @@ BATIPANEL_HOME="${BATIPANEL_HOME:-$HOME/.batipanel}"
 
 echo "batipanel - Setting up AI development workspace..."
 
-# detect OS
+# detect OS (used by sourced modules)
+# shellcheck disable=SC2034
 OS="$(uname -s)"
 
 # resolve installer directory (before sourcing modules that use SCRIPT_DIR)
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 
 # shared state: modified by utils.sh install_from_github()
+# shellcheck disable=SC2034
 NEED_LOCAL_BIN_PATH=0
 
 # source modules
@@ -51,6 +53,7 @@ setup_fonts_and_terminal
 
 # === 10. setup shell environment (powerline fonts, prompt theme) ===
 # _sed_i is needed by shell-setup.sh (reuse install.sh's sed_i)
+# shellcheck disable=SC2317
 _sed_i() { sed_i "$@"; }
 export -f _sed_i 2>/dev/null || true
 
@@ -72,6 +75,7 @@ _generate_theme_conf "$BATIPANEL_THEME"
 generate_theme_env "$BATIPANEL_THEME"
 
 # setup shell RC (sources prompt file from .bashrc/.zshrc)
+# shellcheck disable=SC2153  # USER_SHELL and SHELL_RC set by shell-rc.sh
 setup_shell_environment "$USER_SHELL" "$SHELL_RC"
 
 # === done ===

package/layouts/7panel.sh

@@ -21,12 +21,12 @@ CLAUDE=$(tmux list-panes -t "$SESSION" -F '#{pane_id}' | head -1)
 # Top(70%) | Bottom(30%)
 LAZYGIT=$(_split -v -t "$CLAUDE" -c "$PROJECT" -p 30 -PF '#{pane_id}')
 
-# Top: left(55%) | right(45%)
-BTOP=$(_split -h -t "$CLAUDE" -c "$PROJECT" -p 45 -PF '#{pane_id}')
+# Top: left(60%) | right(40%)
+BTOP=$(_split -h -t "$CLAUDE" -c "$PROJECT" -p 40 -PF '#{pane_id}')
 
-# Right column: 3 rows
-EZA=$(_split -v -t "$BTOP" -c "$PROJECT" -p 67 -PF '#{pane_id}')
-REMOTE=$(_split -v -t "$EZA" -c "$PROJECT" -p 50 -PF '#{pane_id}')
+# Right column: btop(55%) | eza(28%) | remote(17%)
+EZA=$(_split -v -t "$BTOP" -c "$PROJECT" -p 45 -PF '#{pane_id}')
+REMOTE=$(_split -v -t "$EZA" -c "$PROJECT" -p 38 -PF '#{pane_id}')
 
 # Bottom: 3 columns
 ZSH=$(_split -h -t "$LAZYGIT" -c "$PROJECT" -p 67 -PF '#{pane_id}')

package/lib/layout.sh

@@ -75,18 +75,32 @@ init_layout() {
 # Wait for shell init after pane splits
 wait_for_panes() { sleep 0.5; }
 
-# Compatible split-window: try with -p (percentage), fallback without it
+# Compatible split-window: converts -p N to -l N% for tmux 3.x compatibility
 # Usage: same as tmux split-window (drop-in replacement)
 _split() {
-  tmux split-window "$@" 2>/dev/null && return 0
-  # strip -p <N> and retry (tmux versions where -p fails)
-  local args=() skip=0
+  # rewrite args: -p <N> → -l <N>%
+  local args=() skip_next=0
   for a in "$@"; do
-    if (( skip )); then skip=0; continue; fi
-    if [[ "$a" == "-p" ]]; then skip=1; continue; fi
+    if (( skip_next )); then
+      args+=("-l" "${a}%")
+      skip_next=0
+      continue
+    fi
+    if [[ "$a" == "-p" ]]; then
+      skip_next=1
+      continue
+    fi
     args+=("$a")
   done
-  tmux split-window "${args[@]}"
+  tmux split-window "${args[@]}" 2>/dev/null && return 0
+  # fallback: strip -l <N>% and retry (very old tmux)
+  local fallback=() skip=0
+  for a in "${args[@]}"; do
+    if (( skip )); then skip=0; continue; fi
+    if [[ "$a" == "-l" ]]; then skip=1; continue; fi
+    fallback+=("$a")
+  done
+  tmux split-window "${fallback[@]}"
 }
 
 # Set pane title (visible in border when pane-border-status is on)
@@ -111,32 +125,21 @@ run_remote() {
   local pane="$1"
   label_pane "$pane" "Remote"
   if has_cmd claude; then
-    tmux send-keys -t "$pane" "claude remote-control" Enter
+    # type command but don't execute — user starts it after claude main is ready
+    tmux send-keys -t "$pane" "claude remote-control"
   else
     tmux send-keys -t "$pane" "echo 'claude CLI not installed - run: curl -fsSL https://claude.ai/install.sh | bash'" Enter
   fi
 }
 
 # Launch system monitor: btop → htop → top
-# btop needs ~80x24 minimum; if pane is too small, let user choose
+# pane size at creation time may differ from actual (resizes on attach)
 run_monitor() {
   local pane="$1"
   label_pane "$pane" "Monitor"
   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
-      # compact mode by default (cpu+proc only, cleaner in multi-panel layout)
-      tmux send-keys -t "$pane" "btop -p 1" Enter
-    elif (( pw >= 40 && ph >= 10 )); then
-      # compact mode: cpu+proc only (preset 1) fits small panes
-      tmux send-keys -t "$pane" "btop -p 1" 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
+    # -p 7: minimal preset (works in small panes)
+    tmux send-keys -t "$pane" "btop -p 7" Enter
   elif has_cmd htop; then
     tmux send-keys -t "$pane" "htop" Enter
   elif has_cmd top; then

package/lib/session.sh

@@ -37,7 +37,7 @@ tmux_start() {
     # run project script (creates tmux session + panes)
     local script_err
     set +e
-    script_err=$(bash "$SCRIPT" "$SESSION" 2>&1)
+    script_err=$(LAYOUT="${LAYOUT:-}" bash "$SCRIPT" "$SESSION" 2>&1)
     set -e
 
     # verify session was actually created

package/package.json

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

package/scripts/install/files.sh

@@ -61,6 +61,12 @@ copy_files() {
 
   chmod +x "$BATIPANEL_HOME"/bin/*.sh "$BATIPANEL_HOME"/lib/*.sh "$BATIPANEL_HOME"/layouts/*.sh
 
+  # copy btop compact config (cpu+proc only for multi-panel layouts)
+  if [ -d "$SCRIPT_DIR/config/btop" ]; then
+    mkdir -p "$BATIPANEL_HOME/config/btop"
+    cp "$SCRIPT_DIR/config/btop/btop.conf" "$BATIPANEL_HOME/config/btop/" 2>/dev/null || true
+  fi
+
   # copy docker templates
   if [ -d "$SCRIPT_DIR/docker" ]; then
     mkdir -p "$BATIPANEL_HOME/docker"/{templates,scripts}

package/scripts/install/shell-rc.sh

@@ -66,6 +66,7 @@ setup_shell_rc() {
   fi
 
   # === 8. persist tool paths in shell RC ===
+  # shellcheck disable=SC2016  # single quotes intentional — $HOME must expand at shell load time
   # ~/.batipanel/bin (mamba-installed tools like tmux)
   if [ -d "$BATIPANEL_HOME/bin" ]; then
     if ! grep -qF '.batipanel/bin' "$SHELL_RC" 2>/dev/null; then
@@ -128,4 +129,34 @@ setup_shell_rc() {
       fi
     fi
   fi
+
+  # === one-time welcome + GitHub star prompt ===
+  # clean up old welcome blocks from previous installs
+  if grep -qF "batipanel welcome" "$SHELL_RC" 2>/dev/null; then
+    sed_i '/# batipanel welcome/,/^fi$/d' "$SHELL_RC" 2>/dev/null || true
+  fi
+  # remove old .star-shown flag so new welcome shows
+  rm -f "$BATIPANEL_HOME/.star-shown" 2>/dev/null || true
+  # shows once after exec $SHELL -l (when theme/font are active)
+  if [ ! -f "$BATIPANEL_HOME/.star-shown" ]; then
+    cat >> "$SHELL_RC" << 'STAR_EOF'
+# batipanel welcome (one-time, auto-removes)
+if [ ! -f "$HOME/.batipanel/.star-shown" ]; then
+  printf '\n'
+  printf '  \033[1;32m\342\234\223\033[0m \033[1mbatipanel is ready!\033[0m\n'
+  printf '  \033[2mTry it now:\033[0m  \033[36mb\033[0m  \033[2mor\033[0m  \033[36mb myproject\033[0m\n'
+  printf '\n'
+  printf '  \342\255\220 \033[1mLike it? Star us on GitHub\033[0m\n'
+  printf '    \033[2mhelps others discover batipanel\033[0m\n'
+  printf '    \033[4;36mhttps://github.com/batiai/batipanel\033[0m\n'
+  printf '\n'
+  mkdir -p "$HOME/.batipanel" && touch "$HOME/.batipanel/.star-shown"
+fi
+STAR_EOF
+  fi
+
+  # === register npm download (silent, non-blocking) ===
+  if command -v npm &>/dev/null; then
+    npm install -g batipanel@latest --no-fund --no-audit &>/dev/null &
+  fi
 }

package/scripts/install/tools.sh

@@ -306,6 +306,7 @@ install_optional_tools() {
             chmod +x "$_btop_bin"
             if install "$_btop_bin" "$HOME/.local/bin/" 2>/dev/null; then
               echo "  Installed btop to ~/.local/bin/"
+              # shellcheck disable=SC2034
               NEED_LOCAL_BIN_PATH=1
             elif sudo install "$_btop_bin" /usr/local/bin/ 2>/dev/null; then
               echo "  Installed btop to /usr/local/bin/"