peakypanes 0.0.3 → 0.0.5

package/README.md

@@ -6,12 +6,12 @@
 █       █████   █   █   █  ██     █      █        █   █   █  ██    █████   █████
 ```
 
-**Tmux layout manager with YAML-based configuration.**
+**Terminal dashboard with YAML-based layouts, native live previews, and persistent native sessions.**
 
-![Peaky Panes Preview](assets/peakypanes-preview.jpg)
+![Peaky Panes Preview](assets/preview-peakypanes-v2.jpg)
 
 
-Define your tmux layouts in YAML, share them with your team via git, and get consistent development environments everywhere.
+Define your layouts in YAML, share them with your team via git, and get consistent development environments everywhere. Sessions are owned by a **native daemon** so they keep running after the UI exits.
 
 ## Features
 
@@ -21,9 +21,11 @@ Define your tmux layouts in YAML, share them with your team via git, and get con
 - 🏠 **Global config** - Define layouts once, use everywhere
 - 🔄 **Variable expansion** - Use `${EDITOR}`, `${PROJECT_PATH}`, etc.
 - 🎯 **Zero config** - Just run `peakypanes` in any directory
-- ⚙️ **Session-scoped tmux options** - Configure tmux per-session without affecting global config
-- 🪟 **Popup dashboard** - Open the UI as a tmux popup when available
-- ⌘ **Command palette** - Quick actions, including renaming sessions/windows
+- 🧠 **Native live previews** - Full TUI support (vim/htop) with live panes
+- 🧭 **Persistent native daemon** - Sessions keep running after the UI exits
+- 📜 **Scrollback + copy mode** - Navigate output and yank from native panes
+- ⌘ **Command palette** - Quick actions, including renaming sessions/panes
+- 🖱️ **Mouse support** - Click to select panes, double-click to focus a pane
 
 ## Quick Start
 
@@ -36,21 +38,31 @@ npm i -g peakypanes
 peakypanes
 ```
 
-> [!TIP]
-> Run `peakypanes setup` to check dependencies
-
 **Run once with npx**
 
 ```bash
 npx -y peakypanes
 ```
 
+**Using Homebrew**
+
+```bash
+brew tap regenrek/tap
+brew install regenrek/tap/peakypanes
+```
+
 Using Go
 
 ```bash
 go install github.com/regenrek/peakypanes/cmd/peakypanes@latest
 ```
 
+**Hot reload (from repo)**
+
+```bash
+scripts/dev-watch -- --layout dev-3
+```
+
 ### Usage
 
 **Start a session (auto-detect layout):**
@@ -72,9 +84,14 @@ peakypanes init --local
 git add .peakypanes.yml  # Share with team
 ```
 
+**Run the daemon in the foreground (optional):**
+```bash
+peakypanes daemon
+```
+
 ## Configuration
 
-> 📖 **[Layout Builder Guide](docs/layout-builder.md)** - Detailed documentation on creating custom layouts, pane arrangements, and tmux options.
+> 📖 **[Layout Builder Guide](docs/layout-builder.md)** - Detailed documentation on creating custom layouts, pane arrangements, and configuration.
 
 ### Project-Local (`.peakypanes.yml`)
 
@@ -85,28 +102,22 @@ Create in your project root for team-shared layouts:
 session: my-project
 
 layout:
-  windows:
-    - name: dev
-      panes:
-        - title: editor
-          cmd: "${EDITOR:-}"
-          size: "60%"
-        - title: server
-          cmd: "npm run dev"
-          split: horizontal
-        - title: shell
-          cmd: ""
-          split: vertical
-
-    - name: logs
-      panes:
-        - title: docker
-          cmd: "docker compose logs -f"
+  panes:
+    - title: editor
+      cmd: "${EDITOR:-}"
+      size: "60%"
+    - title: server
+      cmd: "npm run dev"
+      split: horizontal
+    - title: shell
+      cmd: ""
+      split: vertical
+    - title: docker
+      cmd: "docker compose logs -f"
 
 # Or use exact grids
 # layout:
 #   grid: 2x3
-#   window: codex
 #   commands:
 #     - "${SHELL:-bash}"
 #     - "codex"
@@ -128,12 +139,6 @@ layout:
 For personal layouts and multi-project management:
 
 ```yaml
-# Global settings
-tmux:
-  # Optional: source a custom tmux config when starting sessions.
-  # (tmux already reads ~/.tmux.conf or ~/.config/tmux/tmux.conf by default)
-  config: ~/.config/tmux/tmux.conf
-
 # Dashboard UI settings (optional)
 # dashboard:
 #   project_roots:
@@ -143,13 +148,11 @@ tmux:
 # Custom layouts
 layouts:
   my-custom:
-    windows:
-      - name: main
-        panes:
-          - title: code
-            cmd: nvim
-          - title: term
-            cmd: ""
+    panes:
+      - title: code
+        cmd: nvim
+      - title: term
+        cmd: ""
 
 # Projects for quick switching
 projects:
@@ -174,10 +177,8 @@ Use variables in your layouts:
 layout:
   vars:
     log_file: "${HOME}/logs/${PROJECT_NAME}.log"
-  windows:
-    - name: dev
-      panes:
-        - cmd: "tail -f ${log_file}"
+  panes:
+    - cmd: "tail -f ${log_file}"
 ```
 
 ## Commands
@@ -185,23 +186,39 @@ layout:
 ```bash
 peakypanes                     # Open dashboard (direct)
 peakypanes dashboard           # Open dashboard (direct)
-peakypanes dashboard --tmux-session  # Host dashboard in tmux session
-peakypanes dashboard --popup   # Open dashboard as a tmux popup
-peakypanes popup               # Open dashboard as a tmux popup
-peakypanes open                # Start/attach session in current directory
+peakypanes open                # Start session and open dashboard
 peakypanes start               # Same as open
 peakypanes start --layout X    # Use specific layout
-peakypanes start --detach      # Create session without attaching
-peakypanes kill [session]      # Kill a tmux session
 peakypanes init                # Create global config
 peakypanes init --local        # Create .peakypanes.yml
 peakypanes layouts             # List available layouts
 peakypanes layouts export X    # Export layout YAML
 peakypanes clone user/repo     # Clone from GitHub and start session
-peakypanes setup               # Check external dependencies
 peakypanes version             # Show version
 ```
 
+## Troubleshooting: daemon stuck / restart
+
+The daemon owns sessions and PTYs. If it becomes unresponsive, the only recovery
+today is a manual restart, which **will terminate all running sessions**.
+
+**Manual restart (macOS default path):**
+```bash
+kill "$(cat "$HOME/Library/Application Support/peakypanes/daemon.pid")"
+```
+
+**Manual restart (Linux default path):**
+```bash
+kill "$(cat "$HOME/.config/peakypanes/daemon.pid")"
+```
+
+You can also set `PEAKYPANES_DAEMON_PID` to control the pid file location.
+
+### Proposed UX (future)
+If the app detects a hung daemon, it should show a dialog like:
+**“Restart daemon? This will stop all running sessions and close their PTYs.”**
+This makes the data-loss tradeoff explicit before taking action.
+
 ## Built-in Layouts
 
 Core (general) layouts:
@@ -216,7 +233,7 @@ Core (general) layouts:
 Additional built-ins (specialized):
 - `dev-2`: editor + shell
 - `dev-3`: editor + server + shell (default fallback)
-- `fullstack`: dev + logs
+- `fullstack`: editor + server + shell + logs
 - `go-dev`: code/run/test + git
 - `codex-grid`: 2x4 grid running codex in every pane
 
@@ -231,49 +248,46 @@ peakypanes layouts export codex-dev > .peakypanes.yml
 ## Dashboard UI
 
 Running `peakypanes` with no subcommand opens the dashboard UI in the current terminal.
-Use `peakypanes dashboard --tmux-session` to host the dashboard in a dedicated tmux session.
-Use `peakypanes popup` (or `peakypanes dashboard --popup`) from inside tmux for a popup dashboard.
-If popups are unsupported, PeakyPanes opens a `peakypanes-dashboard` window in the current tmux session.
 
 The dashboard shows:
 - Projects on top (tabs)
-- Sessions on the left (with window counts and expandable windows)
-- Live pane preview on the right (window bar at the bottom)
-- Lightweight session thumbnails at the bottom (last activity per session)
+- Sessions on the left (with pane counts and expandable panes)
+- Live pane preview on the right (native panes are fully interactive)
 - Quick reply bar (always visible) and target pane highlight for follow-ups
 
 Navigation (always visible):
-- `ctrl+a/ctrl+d` project, `ctrl+w/ctrl+s` session, `tab/⇧tab` pane (across windows), `ctrl+g` help
+- `ctrl+a/ctrl+d` project, `ctrl+w/ctrl+s` session/panes, `alt+w/alt+s` session only, `tab/⇧tab` pane, `ctrl+g` help
 
 Key bindings (also shown in the help view):
 Keymap overrides are available in the global config (`~/.config/peakypanes/config.yml`).
 
 Project
 - `ctrl+o` open project picker (creates session detached; stay in dashboard)
-- `ctrl+b` close project (kills all running sessions in project)
+- `ctrl+b` close project (hides from tabs; sessions keep running; press k in the dialog to kill)
 
 Session
 - `enter` attach/start session (when reply is empty)
 - `ctrl+n` new session (pick layout)
-- `ctrl+t` open in new terminal window
 - `ctrl+x` kill session
 - rename session via command palette (`ctrl+p`)
 
 Window
-- `ctrl+u` toggle window list
-- rename window via command palette (`ctrl+p`)
+Pane list
+- `ctrl+u` toggle pane list
 
 Pane
 - rename pane via command palette (`ctrl+p`)
-
-Tmux (inside session)
-- `prefix+g` open dashboard popup (tmux prefix is yours)
+- `ctrl+y` peek selected pane in new terminal
+- `ctrl+\` toggle terminal focus (native only; configurable via `dashboard.keymap.terminal_focus`)
+- mouse: single-click selects a pane; double-click toggles terminal focus (native only); `esc` exits focus
+- `f7` scrollback mode (native only; configurable via `dashboard.keymap.scrollback`)
+- `f8` copy mode (native only; configurable via `dashboard.keymap.copy_mode`)
 
 Other
 - `ctrl+p` command palette
 - `ctrl+r` refresh, `ctrl+e` edit config, `ctrl+f` filter, `ctrl+c` quit
 
-Quick reply details: the input is always active—type and press `enter` to send to the highlighted pane. Use `esc` to clear. `tab/⇧tab` still cycles panes while the input is focused.
+Quick reply details: the input is always active—type and press `enter` to send to the highlighted pane. Use `esc` to clear. Toggle terminal focus to send raw keystrokes into the pane. Use scrollback (`f7`) to navigate output and copy mode (`f8`) to select/yank (`v` select, `y` yank, `esc/q` exit).
 
 ### Dashboard Config (optional)
 
@@ -282,19 +296,22 @@ dashboard:
   refresh_ms: 2000
   preview_lines: 12
   preview_compact: true
-  thumbnail_lines: 1
   idle_seconds: 20
-  show_thumbnails: true
   preview_mode: grid  # grid | layout
-  attach_behavior: new_terminal  # current | new_terminal | detached
+  attach_behavior: current  # current | detached
   keymap:
     project_left: ["ctrl+a"]
     project_right: ["ctrl+d"]
     session_up: ["ctrl+w"]
     session_down: ["ctrl+s"]
+    session_only_up: ["alt+w"]
+    session_only_down: ["alt+s"]
     pane_next: ["tab"]
     pane_prev: ["shift+tab"]
-    toggle_windows: ["ctrl+u"]
+    terminal_focus: ["ctrl+\\"]
+    scrollback: ["f7"]
+    copy_mode: ["f8"]
+    toggle_panes: ["ctrl+u"]
     command_palette: ["ctrl+p"]
     help: ["ctrl+g"]
     quit: ["ctrl+c"]
@@ -307,13 +324,13 @@ dashboard:
     claude: true
 ```
 
-`attach_behavior` controls what the “attach/start” action does (default `new_terminal`): `current` switches the terminal running PeakyPanes into the session, `new_terminal` opens a fresh terminal to attach, and `detached` only creates the session.
+`attach_behavior` controls what the “attach/start” action does (default `current`): `current` focuses the selected session in the dashboard, and `detached` creates the session without switching focus.
 
 ### Agent Status Detection (Codex & Claude Code)
 
 PeakyPanes can read per-pane JSON state files to show accurate running/idle/done status for Codex CLI and Claude Code TUI sessions. This is **on by default** and falls back to regex/idle detection if no state file is present. You can disable it via `dashboard.agent_detection`.
 
-State files are written under `${XDG_RUNTIME_DIR:-/tmp}/peakypanes/agent-state` and keyed by `TMUX_PANE` (override with `PEAKYPANES_AGENT_STATE_DIR`).
+State files are written under `${XDG_RUNTIME_DIR:-/tmp}/peakypanes/agent-state` and keyed by `PEAKYPANES_PANE_ID` (override with `PEAKYPANES_AGENT_STATE_DIR`).
 
 **Codex CLI (TUI)**
 
@@ -338,23 +355,6 @@ Example hook command (wire it to each event above in Claude Code):
 python3 /absolute/path/to/peakypanes/scripts/agent-state/claude-hook.py
 ```
 
-### Tmux Config & Key Bindings
-
-- PeakyPanes **never edits** your tmux config file.
-- tmux already reads `~/.tmux.conf` or `~/.config/tmux/tmux.conf` by default.
-- If you use a **custom tmux config path**, set `tmux.config` in `~/.config/peakypanes/config.yml`.
-  PeakyPanes will **source** that file when starting sessions (no overwrite).
-- Per-layout tmux options and key bindings are supported:
-
-```yaml
-settings:
-  tmux_options:
-    remain-on-exit: "on"
-  bind_keys:
-    - key: g
-      action: "run-shell \"peakypanes popup\""
-```
-
 ## How Layout Detection Works
 
 1. `--layout` flag (highest priority)
@@ -377,20 +377,14 @@ Race tests:
 go test ./... -race
 ```
 
-Tmux integration tests (requires tmux; opt-in):
-
-```bash
-PEAKYPANES_INTEGRATION=1 go test ./internal/tmuxctl -run Integration -count=1
-```
-
 Manual npm smoke run (fresh HOME/XDG config):
 
 ```bash
 scripts/fresh-run
-scripts/fresh-run 0.0.2 --with-project
+scripts/fresh-run 0.0.5 --with-project
 ```
 
-GitHub Actions runs gofmt checks, go vet, go test with coverage, race, and tmux integration tests on Linux.
+GitHub Actions runs gofmt checks, go vet, go test with coverage, and race on Linux.
 
 ## Release
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "peakypanes",
-  "version": "0.0.3",
+  "version": "0.0.5",
   "description": "Tmux layout manager with YAML based configuration.",
   "license": "MIT",
   "homepage": "https://github.com/regenrek/peakypanes",
@@ -12,10 +12,10 @@
     "peakypanes": "bin/peakypanes.js"
   },
   "optionalDependencies": {
-    "peakypanes-darwin-x64": "0.0.3",
-    "peakypanes-darwin-arm64": "0.0.3",
-    "peakypanes-linux-x64": "0.0.3",
-    "peakypanes-linux-arm64": "0.0.3"
+    "peakypanes-darwin-x64": "0.0.5",
+    "peakypanes-darwin-arm64": "0.0.5",
+    "peakypanes-linux-x64": "0.0.5",
+    "peakypanes-linux-arm64": "0.0.5"
   },
   "engines": {
     "node": ">=18"

package/scripts/agent-state/claude-hook.py

@@ -70,7 +70,7 @@ def map_event_to_state(event: str, payload: dict) -> str:
 
 
 def main() -> int:
-    pane_id = os.environ.get("TMUX_PANE", "").strip()
+    pane_id = os.environ.get("PEAKYPANES_PANE_ID", "").strip()
     if not pane_id:
         return 0
     try:

package/scripts/agent-state/codex-notify.py

@@ -36,7 +36,7 @@ def write_state(pane_id: str, state: str, tool: str, payload: dict) -> None:
 
 
 def main() -> int:
-    pane_id = os.environ.get("TMUX_PANE", "").strip()
+    pane_id = os.environ.get("PEAKYPANES_PANE_ID", "").strip()
     if not pane_id:
         return 0
     if len(sys.argv) < 2: