claw-dashboard 1.8.0

package/.worktrees/release-packaging/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 OpenClaw
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/.worktrees/release-packaging/README.md

@@ -0,0 +1,180 @@
+# 🖥️ Claw Dashboard
+
+A beautiful, real-time terminal dashboard for monitoring OpenClaw instances — inspired by modern system monitors like **btop**, **htop**, and **mactop**.
+
+![Dashboard Preview](https://img.shields.io/badge/OpenClaw-Dashboard-00d4aa?style=for-the-badge)
+
+## ✨ Features
+
+- **🎨 Stunning Visuals**: ASCII art logo, gradient colors, donut charts, and progress bars
+- **📊 Real-time Monitoring**: Auto-refreshes every 2 seconds
+- **🖥️ System Stats**: CPU usage (per-core + average), Memory usage with visual gauges
+- **🎮 GPU Monitoring**: Apple Silicon GPU support (temperature, VRAM utilization)
+- **📈 Top Processes**: Live view of top CPU and memory consuming processes
+- **🤖 OpenClaw Integration**: Live session tracking, agent status, security audit
+- **📱 Session Management**: View all active sessions with token usage
+- **⚡ Lightweight**: Built with Node.js and blessed for minimal resource usage
+
+## 🚀 Quick Start
+
+### Prerequisites
+
+- Node.js v18+
+- OpenClaw installed and configured
+- macOS (Apple Silicon optimized)
+
+### Installation
+
+```bash
+# Install globally (recommended)
+npm install -g claw-dashboard
+
+# Or run without installing
+npx claw-dashboard
+```
+
+### Usage
+
+```bash
+# Run the dashboard
+clawdash
+
+# Or with npm start (if installed locally)
+npm start
+```
+
+## 🎮 Controls
+
+| Key | Action |
+|-----|--------|
+| `q` or `Q` | Quit the dashboard |
+| `r` or `R` | Force refresh data |
+| `?` or `h` | Toggle help panel |
+| `s` or `S` | Open/close settings panel |
+| `Esc` | Close settings panel (when open) |
+| `Ctrl+C` | Quit gracefully |
+
+## ⚙️ Settings
+
+Press `s` to open the settings panel where you can customize:
+
+- **Refresh Interval**: Toggle between 1s, 2s, 5s, or 10s
+- **Show Network**: Enable/disable network monitoring widget
+- **Show GPU**: Enable/disable GPU monitoring widget  
+- **Show Disk**: Enable/disable disk usage widget
+- **Show Processes**: Enable/disable top processes widget
+
+Settings are automatically saved to `~/.openclaw/dashboard-settings.json` and persist across sessions.
+
+Disabled widgets show `[Disabled]` and skip data fetching, reducing CPU usage.
+
+## 📦 Running Persistently
+
+### Option 1: Using `screen`
+
+```bash
+# Install screen
+brew install screen
+
+# Create a detached screen session
+screen -dmS claw-dashboard bash -c 'clawdash'
+
+# To reattach
+screen -r claw-dashboard
+
+# To detach: press Ctrl+A, then D
+```
+
+### Option 2: Using `tmux` (Recommended)
+
+```bash
+# Install tmux
+brew install tmux
+
+# Create a new tmux session
+tmux new-session -d -s claw-dashboard 'clawdash'
+
+# To attach
+tmux attach -t claw-dashboard
+
+# To detach: press Ctrl+B, then D
+```
+
+### Option 3: LaunchAgent (Auto-start on Boot)
+
+```bash
+# Copy the plist (included in package)
+cp ~/node_modules/claw-dashboard/ai.openclaw.dashboard.plist ~/Library/LaunchAgents/
+
+# Edit paths in the plist
+nano ~/Library/LaunchAgents/ai.openclaw.dashboard.plist
+# Change /Users/kdsmith/... to your home directory
+
+# Load the service
+launchctl load ~/Library/LaunchAgents/ai.openclaw.dashboard.plist
+
+# Check status
+launchctl list | grep openclaw.dashboard
+```
+
+### Option 4: Using `pm2`
+
+```bash
+# Install pm2
+npm install -g pm2
+
+# Start with pm2
+pm2 start claw-dashboard --name claw-dashboard
+
+# Save config
+pm2 save
+
+# Auto-start on boot
+pm2 startup
+```
+
+## 🔧 Troubleshooting
+
+### "command not found" after global install
+
+```bash
+# Ensure npm global bin is in your PATH
+export PATH="$(npm root -g)/../bin:$PATH"
+
+# Add to your shell profile for persistence
+echo 'export PATH="$(npm root -g)/../bin:$PATH"' >> ~/.zshrc
+```
+
+### Dashboard shows "Not Available" for OpenClaw
+
+```bash
+# Check if OpenClaw is running
+openclaw gateway status
+
+# Start if needed
+openclaw gateway start
+```
+
+### Display Issues
+
+For best results, use a terminal that supports:
+- 256 colors
+- Unicode box-drawing characters
+- TrueColor (optional)
+
+Recommended: **iTerm2**, **Kitty**, **Alacritty**
+
+## 📝 Dependencies
+
+- `blessed` - Terminal UI framework
+- `blessed-contrib` - Widgets (charts, tables, gauges)
+- `systeminformation` - System stats
+- `chalk` - Terminal colors
+
+## 🤝 Contributing
+
+Issues and PRs welcome at [github.com/openclaw/claw-dashboard](https://github.com/openclaw/claw-dashboard)
+
+## 📜 License
+
+MIT

package/.worktrees/release-packaging/ai.openclaw.dashboard.plist

@@ -0,0 +1,35 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+    <key>Label</key>
+    <string>ai.openclaw.dashboard</string>
+    <key>ProgramArguments</key>
+    <array>
+        <string>/bin/bash</string>
+        <string>-l</string>
+        <string>-c</string>
+        <string>clawdash</string>
+    </array>
+    <key>RunAtLoad</key>
+    <true/>
+    <key>KeepAlive</key>
+    <dict>
+        <key>SuccessfulExit</key>
+        <false/>
+    </dict>
+    <key>StandardOutPath</key>
+    <string>/tmp/openclaw/dashboard.out</string>
+    <key>StandardErrorPath</key>
+    <string>/tmp/openclaw/dashboard.err</string>
+    <key>EnvironmentVariables</key>
+    <dict>
+        <key>PATH</key>
+        <string>/opt/homebrew/bin:/usr/local/bin:/usr/bin:/bin:/usr/local/bin</string>
+        <key>TERM</key>
+        <string>xterm-256color</string>
+    </dict>
+    <key>ProcessType</key>
+    <string>Interactive</string>
+</dict>
+</plist>