npm - batipanel - Versions diffs - 0.4.28 → 0.4.29 - Mend

batipanel 0.4.28 → 0.4.29

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (5) hide show

package/README.md CHANGED Viewed

@@ -1,12 +1,24 @@
-# batipanel
+<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>
+</p>
-[![CI](https://github.com/batiai/batipanel/actions/workflows/ci.yml/badge.svg)](https://github.com/batiai/batipanel/actions)
-[![npm](https://img.shields.io/npm/v/batipanel)](https://www.npmjs.com/package/batipanel)
-[![Latest Release](https://img.shields.io/github/v/release/batiai/batipanel)](https://github.com/batiai/batipanel/releases)
-[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
-[![Platform](https://img.shields.io/badge/platform-macOS%20%7C%20Linux%20%7C%20WSL-lightgrey)]()
+<p align="center">
+  <a href="https://batipanel.com"><img src="https://img.shields.io/badge/🌐_batipanel.com-Visit_Website-blue?style=for-the-badge" alt="batipanel.com"/></a>
+</p>
-**AI-powered terminal workspace manager.** One command to launch a fully configured, beautifully themed multi-panel development environment.
+<p align="center">
+  <a href="https://github.com/batiai/batipanel/actions"><img src="https://github.com/batiai/batipanel/actions/workflows/ci.yml/badge.svg" alt="CI"/></a>
+  <a href="https://www.npmjs.com/package/batipanel"><img src="https://img.shields.io/npm/v/batipanel" alt="npm"/></a>
+  <a href="https://github.com/batiai/batipanel/releases"><img src="https://img.shields.io/github/v/release/batiai/batipanel" alt="Latest Release"/></a>
+  <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue.svg" alt="License: MIT"/></a>
+  <img src="https://img.shields.io/badge/platform-macOS%20%7C%20Linux%20%7C%20WSL-lightgrey" alt="Platform"/>
+</p>
+---
+One command to launch a fully configured, beautifully themed multi-panel development environment with **Claude Code**, **Git UI**, **system monitor**, **file browser**, and more.
 ```
 ┌────────────────────────────────┬──────────────┐
@@ -21,108 +33,15 @@
 └───────────┴────────────────────┴──────────────┘
 ```
-> **Looking for a GUI?** [batipanel Desktop](https://batipanel.com/download) is available for macOS and Windows — same multi-panel workspace with a native app experience.
----
-## Why batipanel?
-AI 시대의 개발 환경은 달라져야 합니다. Claude Code 같은 AI 어시스턴트, Git UI, 시스템 모니터, 파일 브라우저를 **매번 하나씩 열고 배치하는 건 비효율적**입니다. batipanel은 이 모든 것을 **명령어 한 줄**로 해결합니다.
-### 1. AI-First Multi-Panel Workspace
-> AI 시대에 최적화된 개발환경을 명령어 한 줄로 구축
-#### 1-1. AI Interface (Claude Code + Remote Control)
-- **Claude Code** 패널이 워크스페이스의 중심 — 55% 이상의 화면을 차지하는 넓은 AI 작업 공간
-- **Remote Control** 패널로 별도 터미널에서 Claude에 명령 전달 (다른 작업 중에도 AI 제어 가능)
-- **Dual-Claude** 레이아웃으로 두 개의 Claude 인스턴스를 동시에 운영 (멀티 에이전트)
-#### 1-2. Multi-Panel Development Tools
-- **Git UI** (lazygit) — 시각적 Git 관리, 커밋/브랜치/머지를 한눈에
-- **System Monitor** (btop) — CPU, 메모리, 네트워크 실시간 모니터링
-- **File Browser** (yazi) — 트리 구조 파일 탐색, Nerd Font 아이콘 지원
-- **Terminal** — 범용 쉘, 빌드/테스트 명령 실행
-- **Logs** — `tail -f`, `npm run dev` 등 실시간 로그 모니터링
-#### 1-3. Smart Layout System
-화면 크기와 워크플로우에 맞는 **8가지 레이아웃** 제공:
-| Layout | Panels | Best For |
-|--------|--------|----------|
-| `7panel` (default) | 7 | AI 코딩 + 외장 모니터 |
-| `4panel` | 4 | 노트북 (13-14") |
-| `5panel` | 5 | 균형 잡힌 워크스페이스 |
-| `6panel` | 6 | 일반 개발 + 대형 모니터 |
-| `7panel_log` | 7 | 풀 로그 바 + 개발 |
-| `8panel` | 8 | 듀얼 Claude + 모니터링 |
-| `dual-claude` | 7 | 멀티 AI 에이전트 + 울트라와이드 |
-| `devops` | 5 | Docker/K8s 운영 |
-각 도구가 없어도 **자동 폴백** — btop -> htop -> top, yazi -> eza -> tree -> find
-### 2. Instant Session Resume
-> 언제든 떠나고, 언제든 돌아오는 작업 환경
-tmux 세션 기반으로 **작업 상태가 완벽히 보존**됩니다:
-- `b myproject` — 세션이 있으면 즉시 복귀, 없으면 새로 생성
-- AI 대화, Git 상태, 로그 출력 등 **모든 패널의 상태가 그대로** 유지
-- SSH 연결이 끊겨도, 터미널을 닫아도 — 다시 `b myproject` 하면 끝
-- 여러 프로젝트를 동시에 운영하고 `b ls`로 관리
-```bash
-b myproject          # 작업 시작 (또는 이전 세션 복귀)
-# ... 작업 중 터미널 닫기, SSH 끊김 등 ...
-b myproject          # 모든 패널이 그대로 — 바로 이어서 작업
-```
-### 3. AI Telegram Bot (OpenClaw) — One-Command Deploy
-> 격리된 Docker 환경에서 개인 AI 봇을 명령어 한 줄로 배포
-#### 3-1. Zero-Cost AI for Claude Max Users
-- Claude Max 구독($200/mo)이 있다면 **추가 API 비용 $0**
-- OpenClaw 게이트웨이가 Claude Max 세션을 활용 — 토큰 과금 없음
-- API 키 방식도 지원 (유량 기반 과금)
-#### 3-2. Secure by Default — Docker Isolation
-보안 걱정 없는 **5계층 격리**:
-| Layer | Protection |
-|-------|-----------|
-| **Container** | Read-only filesystem, dropped Linux capabilities |
-| **Sandbox** | Tool execution in separate containers |
-| **Network** | Loopback binding only (not exposed to LAN) |
-| **Access** | Telegram allowlist (only your user ID) |
-| **Credentials** | File permissions 600, gateway token auto-generated |
-#### 3-3. 5-Minute Setup
-```bash
-b server init     # 3단계 대화형 설정 (봇 토큰, AI 모델, 사용자 ID)
-b server start    # Docker 서버 시작 — 끝!
-```
-웹 검색, PDF 분석, 코드 실행, 리포트 생성 등 **풀 AI 에이전트 기능**을 Telegram으로 사용.
----
 ## 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
+curl -fsSL https://batipanel.com/install.sh | bash   # Recommended
+npx batipanel                                         # npm/npx
+brew install batiai/tap/batipanel                      # Homebrew
-# Run — the setup wizard guides you through everything
+# Launch — the setup wizard guides you through everything
 b
 ```
@@ -130,287 +49,42 @@ 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
-   curl -fsSL https://batipanel.com/install.sh | bash
-   ```
-   - tmux, 기타 도구를 자동으로 설치합니다
-   - Homebrew가 없으면 안내를 따르세요
-3. **새 터미널 열기** 후 실행:
-   ```bash
-   b
-   ```
-> **다른 설치 방법**: `npx batipanel` (Node.js 필요) 또는 `brew install batiai/tap/batipanel` (Homebrew)
-</details>
-<details>
-<summary><b>Linux / WSL — 처음부터 설치하기</b></summary>
-1. **터미널 열기**
-2. **설치 명령어 실행**:
-   ```bash
-   curl -fsSL https://batipanel.com/install.sh | bash
-   ```
-   - 모든 도구(tmux, btop 등)가 자동 설치됩니다
-3. **새 터미널 열기** 후 실행:
-   ```bash
-   b
-   ```
-> **다른 설치 방법**: `npx batipanel` (Node.js 필요) 또는 수동 설치: `git clone https://github.com/batiai/batipanel.git && cd batipanel && bash install.sh`
-</details>
----
-### npm / npx
-```bash
-# One-time run (no install needed)
-npx batipanel
-# Or install globally
-npm install -g batipanel
-```
-### Homebrew (macOS / Linux)
-```bash
-brew tap batiai/tap
-brew install batipanel
-```
-All dependencies (tmux, lazygit, btop, yazi, eza) are installed automatically.
-### Shell script (Linux / WSL / macOS)
-```bash
-# One-line install (no npm/Node.js required)
-curl -fsSL https://batipanel.com/install.sh | bash
-```
-Or clone and install manually:
-```bash
-git clone https://github.com/batiai/batipanel.git
-cd batipanel
-bash install.sh
-```
-The installer auto-detects your package manager (apt, dnf, pacman, brew, port, nix, apk, zypper) and installs everything.
-On macOS, any package manager works — Homebrew, MacPorts, or Nix.
-### Windows (WSL)
-batipanel runs on Windows through WSL2 (Windows Subsystem for Linux).
-**Step 1: Install WSL2** (skip if you already have it)
-Open PowerShell as Administrator and run:
-```powershell
-wsl --install
-```
-Restart your computer. Ubuntu will open automatically — create a username and password.
-**Step 2: Install batipanel**
-Open **Windows Terminal** > **Ubuntu** tab and run:
-```bash
-curl -fsSL https://batipanel.com/install.sh | bash
-```
-**Step 3: Start**
-```bash
-b
-```
-> **Tip**: For the best experience, use [Windows Terminal](https://aka.ms/terminal) (pre-installed on Windows 11, free on Microsoft Store for Windows 10). Maximize the window or go fullscreen (F11) before launching batipanel.
-### Upgrading
-```bash
-# npm
-npm update -g batipanel
-# Homebrew
-brew upgrade batipanel
-# Manual install — just re-run the installer
-cd batipanel && git pull && bash install.sh
-```
-Your projects and settings are always preserved.
-### Uninstalling
-```bash
-# npm
-npm uninstall -g batipanel
-# Homebrew
-brew uninstall batipanel
-# Manual
-bash uninstall.sh
-```
----
-## Usage
-### First Run
-Just type `b` (or `batipanel`). The setup wizard will:
-1. Ask your **screen size** (laptop / external monitor / ultrawide)
-2. Ask your **workflow** (AI coding / general dev / DevOps)
-3. Pick the best layout for you
-4. Register your current directory as a project
-5. Launch immediately
-**Wizard layout mapping:**
-| Screen | AI Coding | General Dev | DevOps |
-|--------|-----------|-------------|--------|
-| Laptop (small) | 4panel | 4panel | devops |
-| Monitor (large) | 7panel | 6panel | devops |
-| Ultrawide | dual-claude | 7panel_log | devops |
-### Commands
-#### Session
-```bash
-b myproject                        # Start or resume a project
-b myproject --layout 6panel        # Start with a specific layout (-l shorthand)
-b stop myproject                   # Stop a session
-b stop myproject -f                # Stop without confirmation
-b reload myproject                 # Restart session (stop + start)
-b reload myproject --layout 8panel # Restart with a different layout
-```
-#### Project
-```bash
-b new myproject ~/path/to/project  # Register a new project
-b ls                               # List active sessions & registered projects
-```
-#### Configuration
-```bash
-b config layout 7panel_log         # Change default layout
-b config layout                    # View current default layout
-b theme                            # List available themes
-b theme dracula                    # Apply a theme
-b config iterm-cc on               # Enable iTerm2 native tmux integration
-```
-#### System
-```bash
-b doctor                           # Check system health
-b layouts                          # Show available layouts
-b help                             # Show all commands
-b --version                        # Show version
-```
-#### Server (AI Telegram Bot)
-```bash
-b server init                      # Interactive setup wizard
-b server start                     # Start the Docker server
-b server stop                      # Stop the server
-b server status                    # Show status + security report
-b server logs [-f]                 # View logs (follow with -f)
-b server update                    # Pull latest image & restart
-b server config                    # View configuration (secrets masked)
-```
-#### Global Flags
-| Flag | Description |
-|------|-------------|
-| `--version`, `-v` | Show version |
-| `--debug` | Enable debug logging |
-| `--no-color` | Disable colored output (respects [NO_COLOR](https://no-color.org) standard) |
-### How It Works
+## Why batipanel?
-1. `b myproject` checks if a session already exists
-2. If yes -> reattaches (your work is exactly where you left it)
-3. If no -> creates a new multi-panel session with your chosen layout
-4. Each panel auto-launches its assigned tool
-5. Missing tools gracefully fall back to alternatives (e.g., btop -> htop -> top)
+| | 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. |
 ---
-## Color Themes
-batipanel includes **8 built-in color themes** that style the tmux status bar, window tabs, pane borders, and shell prompt.
+## Layouts
 ```bash
-b theme              # List all themes
-b theme dracula      # Apply a theme (live reload)
+b myproject                     # use default layout
+b myproject --layout 6panel     # use specific layout
+b config layout dual-claude     # change default
 ```
-| Theme | Style |
-|-------|-------|
-| `default` | Green/blue — clean and balanced |
-| `dracula` | Purple/pink dark theme |
-| `nord` | Arctic blue palette |
-| `gruvbox` | Retro warm colors |
-| `tokyo-night` | Blue/purple night theme |
-| `catppuccin` | Pastel warm dark (Mocha variant) |
-| `rose-pine` | Warm rose, soho vibes |
-| `kanagawa` | Japanese ink painting palette |
-**Theme applies to:**
-- tmux status bar with Powerline-style arrow separators
-- Window tabs (active/inactive distinction)
-- Pane borders and titles (each panel labeled: Claude, Git, Shell, Monitor, etc.)
-- Shell prompt (Powerline-style segments: user, directory, git branch)
-- Messages and notifications
-Themes persist across sessions. Live-reload if tmux is already running.
-### Shell Prompt
-The installer sets up a Powerline-style shell prompt themed to match:
-- **Zsh**: Oh My Zsh + agnoster theme (hostname hidden)
-- **Bash**: Powerline-style PS1 with git branch (hostname hidden)
-- **Fonts**: Powerline / Nerd Fonts auto-installed (apt/brew/git fallback)
----
-## Layouts
-Choose the layout that fits your screen and workflow. Change anytime with `b <project> --layout <name>`.
+| Layout | Panels | Best For |
+|--------|--------|----------|
+| `7panel` *(default)* | 7 | AI coding + external monitor |
+| `4panel` | 4 | Laptops (13-14") |
+| `5panel` | 5 | Balanced workspace |
+| `6panel` | 6 | General dev + large monitor |
+| `7panel_log` | 7 | Full-width log bar |
+| `8panel` | 8 | Dual Claude + monitoring |
+| `dual-claude` | 7 | Multi AI agent + ultrawide |
+| `devops` | 5 | Docker / K8s operations |
-### 7panel (default) — Claude-focused workspace
+<details>
+<summary><b>Layout diagrams</b></summary>
-Best for: external monitors, AI-assisted coding
+### 7panel (default)
 ```
 ┌────────────────────────────────┬──────────────┐
@@ -424,23 +98,17 @@ Best for: external monitors, AI-assisted coding
 └───────────┴──────────────────┴────────────────┘
 ```
-### 4panel — Minimal workspace
-Best for: laptops (13-14"), smaller screens
+### 4panel
 ```
 ┌────────────────────────┬──────────────────┐
-│                        │                  │
 │  claude (main)         │  btop            │
-│                        │                  │
 ├────────────────────────┼──────────────────┤
 │  lazygit               │  terminal        │
 └────────────────────────┴──────────────────┘
 ```
-### 6panel — Balanced grid
-Best for: general development on a large monitor
+### 6panel
 ```
 ┌──────────────┬───────────────┬────────────────┐
@@ -450,30 +118,22 @@ Best for: general development on a large monitor
 └──────────────┴───────────────┴────────────────┘
 ```
-### dual-claude — Multi-agent workspace
-Best for: ultrawide monitors, running two Claude instances
+### dual-claude
 ```
 ┌──────────────────┬──────────────────┐
-│                  │                  │
 │  claude #1       │  claude #2       │
 │  (main)          │  (secondary)     │
-│                  │                  │
 ├──────────┬───────┴──────┬───────────┤
 │ lazygit  │  terminal    │ file mgr  │
 └──────────┴──────────────┴───────────┘
 ```
-### devops — Infrastructure monitoring
-Best for: Docker/Kubernetes workflows
+### devops
 ```
 ┌──────────────────┬──────────────────┐
-│                  │                  │
 │  claude          │  btop            │
-│                  │                  │
 ├──────────────────┼──────────────────┤
 │  lazydocker      │  terminal        │
 ├──────────────────┴──────────────────┤
@@ -481,22 +141,17 @@ Best for: Docker/Kubernetes workflows
 └─────────────────────────────────────┘
 ```
-<details>
-<summary>More layouts: 5panel, 7panel_log, 8panel</summary>
-### 5panel — Balanced workspace
+### 5panel
 ```
 ┌──────────────────────────────┬──────────────┐
-│                              │              │
 │  claude (main)               │  lazygit     │
-│                              │              │
 ├──────────────┬───────────────┼──────────────┤
 │ remote-ctrl  │  terminal     │  file tree   │
 └──────────────┴───────────────┴──────────────┘
 ```
-### 7panel_log — Full-width log bar
+### 7panel_log
 ```
 ┌───────────────────────┬──────────┬────────────┐
@@ -509,11 +164,10 @@ Best for: Docker/Kubernetes workflows
 └───────────────────────────────────────────────┘
 ```
-### 8panel — Dual Claude + monitor
+### 8panel
 ```
 ┌──────────────┬──────────────┬──────────────┐
-│              │              │              │
 │  claude #1   │  claude #2   │  btop        │
 │  (main)      │  (secondary) │              │
 │              │              ├──────────────┤
@@ -527,38 +181,93 @@ Best for: Docker/Kubernetes workflows
 ---
-## Keyboard Shortcuts
+## Color Themes
-### Panel Navigation
+```bash
+b theme              # list all themes
+b theme dracula      # apply a theme (live reload)
+```
+| Theme | Style |
+|-------|-------|
+| `default` | Green/blue — clean and balanced |
+| `dracula` | Purple/pink dark theme |
+| `nord` | Arctic blue palette |
+| `gruvbox` | Retro warm colors |
+| `tokyo-night` | Blue/purple night theme |
+| `catppuccin` | Pastel warm dark (Mocha) |
+| `rose-pine` | Warm rose, soho vibes |
+| `kanagawa` | Japanese ink painting palette |
+Themes apply to tmux status bar (Powerline arrows), window tabs, pane borders, and shell prompt. Persists across sessions.
+---
+## Commands
+```bash
+# Session
+b myproject                        # start or resume
+b myproject --layout 6panel        # start with specific layout
+b stop myproject                   # stop session
+b reload myproject                 # restart session
+# Project
+b new myproject ~/path/to/project  # register project
+b ls                               # list sessions & projects
+# Config
+b config layout 7panel_log         # change default layout
+b theme dracula                    # change color theme
+b config iterm-cc on               # iTerm2 native integration
+# System
+b doctor                           # check system health
+b layouts                          # show available layouts
+b help                             # show all commands
+# AI Telegram Bot (Docker)
+b server init                      # interactive setup
+b server start                     # start server
+b server stop                      # stop server
+b server status                    # status + security report
+```
+---
+## Keyboard Shortcuts
 | Shortcut | Action |
 |----------|--------|
 | **Alt + h/j/k/l** | Move between panels (vim-style) |
 | **Alt + Arrow Keys** | Move between panels |
-| **Alt + Space** | Toggle last panel |
 | **Alt + f** | Zoom/focus current panel (toggle) |
+| **Alt + Space** | Toggle last panel |
 | **Alt + 1-9** | Switch to window by number |
-| **Alt + [ / ]** | Previous / next window |
+<details>
+<summary><b>All keyboard shortcuts</b></summary>
 ### Panel Management
 | Shortcut | Action |
 |----------|--------|
-| **Alt + \\** | Split vertically (new pane right) |
-| **Alt + -** | Split horizontally (new pane below) |
-| **Alt + x** | Close current panel (with confirmation) |
+| **Alt + \\** | Split vertically |
+| **Alt + -** | Split horizontally |
+| **Alt + x** | Close current panel |
 | **Alt + n** | New window |
+| **Alt + [ / ]** | Previous / next window |
-### Panel Resizing
+### Resizing
 | Shortcut | Action |
 |----------|--------|
 | **Alt + Shift + Arrow** | Fine resize (1 unit) |
 | **Prefix + Arrow** | Resize (5 units, prefix = Ctrl+B) |
-| **Prefix + =** | Equalize all panel sizes |
-| **Mouse drag** | Drag panel borders to resize |
+| **Prefix + =** | Equalize all panels |
+| **Mouse drag** | Drag panel borders |
-### Panel Swapping
+### Swapping
 | Shortcut | Action |
 |----------|--------|
@@ -570,11 +279,11 @@ Best for: Docker/Kubernetes workflows
 |----------|--------|
 | **Prefix + [** | Enter copy mode |
 | **v** | Begin selection |
-| **Ctrl + v** | Toggle rectangle selection |
-| **y** | Copy to system clipboard |
+| **Ctrl + v** | Rectangle selection |
+| **y** | Copy to clipboard |
 | **Escape** | Exit copy mode |
-### Session Management
+### Session
 | Shortcut | Action |
 |----------|--------|
@@ -582,166 +291,193 @@ Best for: Docker/Kubernetes workflows
 | **Prefix + S** | New session |
 | **Prefix + r** | Reload tmux config |
----
+</details>
-## Customization
+---
-### Register a project
+## Installation
-```bash
-b new myproject ~/code/myproject
-```
+<details>
+<summary><b>macOS — step by step</b></summary>
-### Change default layout
+1. Open Terminal (`Cmd + Space` → "Terminal")
+2. Run:
+   ```bash
+   curl -fsSL https://batipanel.com/install.sh | bash
+   ```
+3. Type `b` to start
-```bash
-b config layout 7panel_log
-```
+> **Alternatives**: `npx batipanel` (Node.js required) or `brew install batiai/tap/batipanel`
-### Change color theme
+</details>
-```bash
-b theme dracula
-```
+<details>
+<summary><b>Linux / WSL — step by step</b></summary>
-### Enable Nerd Font icons in file tree
+1. Open your terminal
+2. Run:
+   ```bash
+   curl -fsSL https://batipanel.com/install.sh | bash
+   ```
+3. Type `b` to start
-```bash
-b config icons on
-```
+> **Alternatives**: `npx batipanel` or `git clone https://github.com/batiai/batipanel.git && cd batipanel && bash install.sh`
-Icons are auto-detected on known Nerd Font terminals (iTerm2, WezTerm, Kitty).
+</details>
-### iTerm2 native integration
+<details>
+<summary><b>Windows (WSL2)</b></summary>
-```bash
-b config iterm-cc on     # Use iTerm2 native splits (auto-detected on first run)
-b config iterm-cc off    # Use standard tmux UI
+**Step 1**: Install WSL2 (PowerShell as Administrator):
+```powershell
+wsl --install
 ```
-### Create a custom layout
+**Step 2**: Open **Windows Terminal** > **Ubuntu** tab:
 ```bash
-cp ~/.batipanel/layouts/7panel.sh ~/.batipanel/layouts/custom.sh
-# Edit custom.sh to your needs
-b myproject --layout custom
+curl -fsSL https://batipanel.com/install.sh | bash
 ```
----
+**Step 3**: Type `b`
-## Terminal Compatibility
+> **Tip**: Use [Windows Terminal](https://aka.ms/terminal) and go fullscreen (F11) for the best experience.
-batipanel works with any terminal that supports tmux:
+</details>
-| Platform | Supported Terminals |
-|----------|---------------------|
-| **macOS** | Terminal.app, iTerm2, Alacritty, Kitty, WezTerm, Warp |
-| **Linux** | GNOME Terminal, Konsole, Alacritty, Kitty, WezTerm, xterm |
-| **Windows** | Windows Terminal + WSL2 |
+<details>
+<summary><b>npm / Homebrew / manual</b></summary>
-- **iTerm2**: Auto-detected — supports native tmux integration for seamless tabs
-- **Clipboard**: Copy from tmux works automatically on all platforms (macOS, Linux X11, WSL)
-- **True Color**: 24-bit color support enabled by default
+```bash
+# npm — one-time run
+npx batipanel
----
+# npm — global install
+npm install -g batipanel
-## Requirements
+# Homebrew
+brew tap batiai/tap
+brew install batipanel
-| Tool | Required? | Notes |
-|------|-----------|-------|
-| **tmux** | Yes | Auto-installed by the installer |
-| **Claude Code** | Recommended | AI assistant — `curl -fsSL https://claude.ai/install.sh \| bash` |
-| lazygit | Optional | Git UI — falls back to `git status` |
-| btop | Optional | System monitor — falls back to htop or top |
-| yazi | Optional | File manager — falls back to eza, tree, or find |
-| eza | Optional | Modern `ls` — falls back to tree or find |
-| Docker | Optional | Required only for `b server` (Telegram bot) |
+# Manual
+git clone https://github.com/batiai/batipanel.git
+cd batipanel && bash install.sh
+```
-All optional tools are auto-installed when possible. If any are missing, batipanel still works — each panel gracefully falls back to a simpler alternative.
+The installer auto-detects your package manager (apt, dnf, pacman, brew, port, nix, apk, zypper) and installs everything.
----
+</details>
-## Troubleshooting
+<details>
+<summary><b>Upgrading / Uninstalling</b></summary>
-### "tmux is not installed"
+```bash
+# Upgrade
+npm update -g batipanel          # npm
+brew upgrade batipanel            # Homebrew
+cd batipanel && git pull && bash install.sh  # manual
-The installer tries to install tmux automatically. If it fails:
+# Uninstall
+npm uninstall -g batipanel        # npm
+brew uninstall batipanel          # Homebrew
+bash uninstall.sh                 # manual
+```
-```bash
-# macOS
-brew install tmux
+Your projects and settings are always preserved during upgrades.
-# Ubuntu/Debian
-sudo apt install tmux
+</details>
-# Fedora
-sudo dnf install tmux
-```
+---
-### Panels look too small or overlap
+## AI Telegram Bot (OpenClaw)
-Your terminal window might be too small for the selected layout. Try:
+Deploy a personal AI bot in an isolated Docker environment with one command.
 ```bash
-b myproject --layout 4panel    # simpler layout for smaller screens
+b server init     # 3-step setup wizard (bot token, AI model, user ID)
+b server start    # start Docker server — done!
 ```
-Or maximize your terminal window / go fullscreen.
-### "claude CLI not installed"
+- **Zero extra cost** for Claude Max subscribers ($200/mo) — OpenClaw gateway uses your existing session
+- **5-layer Docker isolation** — read-only filesystem, network loopback, Telegram allowlist, sandboxed tool execution
+- Full AI agent capabilities via Telegram: web search, PDF analysis, code execution, report generation
-Install Claude Code:
+<details>
+<summary><b>Server commands & security details</b></summary>
 ```bash
-curl -fsSL https://claude.ai/install.sh | bash
+b server init       # interactive setup wizard
+b server start      # start the Docker server
+b server stop       # stop the server
+b server status     # status + security report
+b server logs [-f]  # view logs
+b server update     # pull latest image & restart
+b server config     # view config (secrets masked)
 ```
-The panel will show a reminder if Claude Code is missing — everything else still works.
+| Security Layer | Protection |
+|----------------|-----------|
+| **Container** | Read-only filesystem, dropped Linux capabilities |
+| **Sandbox** | Tool execution in separate containers |
+| **Network** | Loopback binding only (not exposed to LAN) |
+| **Access** | Telegram allowlist (only your user ID) |
+| **Credentials** | File permissions 600, gateway token auto-generated |
-### WSL: clipboard not working
+</details>
-Install xclip:
+---
-```bash
-sudo apt install xclip
-```
+## Requirements
-### How do I navigate between panels?
+| Tool | Required? | Notes |
+|------|-----------|-------|
+| **tmux** | Yes | Auto-installed |
+| **Claude Code** | Recommended | `curl -fsSL https://claude.ai/install.sh \| bash` |
+| lazygit | Optional | Git UI (fallback: `git status`) |
+| btop | Optional | Monitor (fallback: htop → top) |
+| yazi | Optional | File manager (fallback: eza → tree) |
+| Docker | Optional | Only for `b server` (Telegram bot) |
-- **Alt + h/j/k/l** — switch panels (vim-style)
-- **Alt + Arrow Keys** — switch panels
-- **Alt + f** — zoom/focus a panel (toggle fullscreen)
-- **Prefix + Arrow Keys** — resize panels (prefix = Ctrl+B by default)
-- **Mouse** — click to select a panel, drag borders to resize, scroll to view history
+All optional tools are auto-installed when possible. Missing tools gracefully fallback to simpler alternatives.
 ---
-## Contributing
+## Terminal Compatibility
-Contributions are welcome! Please see our [Contributing Guidelines](CONTRIBUTING.md) for details.
+| Platform | Supported Terminals |
+|----------|---------------------|
+| **macOS** | iTerm2, Terminal.app, Alacritty, Kitty, WezTerm, Warp |
+| **Linux** | GNOME Terminal, Konsole, Alacritty, Kitty, WezTerm, xterm |
+| **Windows** | Windows Terminal + WSL2 |
-1. Fork the repository
-2. Create your feature branch (`git checkout -b feature/amazing-feature`)
-3. Commit your changes (`git commit -m 'Add amazing feature'`)
-4. Push to the branch (`git push origin feature/amazing-feature`)
-5. Open a Pull Request
+<details>
+<summary><b>Troubleshooting</b></summary>
----
+**Panels look too small?** Try `b myproject --layout 4panel` or maximize your terminal.
-## License
+**"tmux is not installed"?** Run `brew install tmux` (macOS) or `sudo apt install tmux` (Ubuntu).
-[MIT](LICENSE) — Copyright (c) 2026 [bati.ai](https://bati.ai)
+**"claude CLI not installed"?** Run `curl -fsSL https://claude.ai/install.sh | bash`. Everything else still works without it.
-## Trademark
+**WSL clipboard not working?** Run `sudo apt install xclip`.
-"batipanel" and the batipanel logo are trademarks of batiai. The MIT license grants rights to the source code only, not to the batipanel name or branding. See [TRADEMARK.md](TRADEMARK.md) for details.
+**Navigation**: Use `Alt + h/j/k/l` to switch panels, `Alt + f` to zoom, mouse click to select.
-## Author
+</details>
+---
+## Contributing
-Made by [bati.ai](https://bati.ai)
+Contributions welcome! See [CONTRIBUTING.md](CONTRIBUTING.md) for details.
 ---
+## License
+[MIT](LICENSE) — Copyright (c) 2026 [bati.ai](https://bati.ai)
+"batipanel" and the batipanel logo are trademarks of batiai. See [TRADEMARK.md](TRADEMARK.md) for details.
 <p align="center">
-  <sub>Sponsored by <a href="https://bati.ai">bati.ai</a></sub>
+  <a href="https://batipanel.com">batipanel.com</a> · Made by <a href="https://bati.ai">bati.ai</a>
 </p>

package/VERSION CHANGED Viewed

	@@ -1 +1 @@
1	- 0.4.28
1	+ 0.4.29

package/install.sh CHANGED Viewed

@@ -762,5 +762,13 @@ else
   echo "Tip: Set your terminal font to a Nerd Font (e.g. MesloLGS NF)"
   echo "     for powerline arrow-style prompt glyphs."
   echo ""
-  echo "Open a new terminal window, then type: b"
+  echo "Type: b"
+fi
+# === reload shell so prompt theme applies immediately ===
+# only exec when running interactively (not from npm postinstall or scripts)
+if [ -t 0 ] && [ -t 1 ] && [ -z "${npm_lifecycle_event:-}" ]; then
+  echo ""
+  echo "Reloading shell to apply prompt theme..."
+  exec "$SHELL" -l
 fi

package/lib/layout.sh CHANGED Viewed

@@ -103,6 +103,9 @@ run_monitor() {
     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
+    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" \

package/package.json CHANGED Viewed

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