🦞 claw-monitor

A terminal dashboard for monitoring OpenClaw agents, cron jobs, Docker containers, and system resources in real-time on Linux/WSL or MacOS.

• Live session tracking — Watch sub-agents work in real-time with status updates
• Session labels — Shows spawn labels for easy identification
• Tool activity — Displays the current tool being executed and total tool calls
• Elapsed time — Track how long each session has been running
• Agent detail view — Select agents with arrow keys and press Enter to expand (recent tools, errors, full label)
• Toggle modes — Switch between "running only" and "all recent" views (a key)

• Process monitoring — Detects running Claude Code, Copilot CLI, and Codex processes
• Attach commands — Jump into any coding agent's interactive tmux session
• PID and runtime — See process IDs and cumulative CPU time

• OpenClaw cron jobs — Lists every job with name, schedule, model, next run, and last duration
• System cron jobs — Shows root crontab entries with schedule, next run, and last run
• Human-readable schedules — Translates cron expressions to readable format (Mon 13:00, every 15m, Tue,Fri 06:00)
• Relative next-run times — Shows when each job fires next (in 8m, in 4d)
• Error tracking — Highlights failing jobs with consecutive error counts
• Running indicator — Shows which jobs are actively executing
• Sorted by next run — Soonest jobs appear first

• CPU / Memory / Disk — Color-coded bar charts with usage percentages and details
• GPU monitoring — NVIDIA GPU usage via nvidia-smi (auto-detected)
• Docker containers — Shows running container names and status
• Kubernetes pods — Shows k8s/k3s pods (auto-detected, system namespaces filtered)
• Systemd services — Monitors key system services (auto-detected)
• Two-column layout — Resource gauges on the left, containers/pods/services on the right
• Color thresholds — Green (healthy), yellow (≥70%), red (≥90%) — configurable via env vars

• Auto-sizing — Dashboard width adapts to your terminal (60–120 columns)
• Resize handling — Responds to terminal resize events in real-time
• Internal scrolling — PgUp/PgDn/Home/End scroll when content exceeds terminal height
• Alternate screen — Uses alternate screen buffer so your scrollback is preserved on exit

git clone https://github.com/DanWahlin/claw-monitor.git
cd claw-monitor
npm install
npm run build

./bin/claw-monitor.js

Or add to your PATH for global access (run from the project root):

npm link

Then run from anywhere:

claw-monitor

claw-monitor detects running coding agents (Claude Code, Copilot CLI, Codex) via process monitoring. To jump into an agent's interactive terminal session, use the attach commands included in bin/:

# Symlink to PATH (one-time)
sudo ln -sf "$(pwd)/bin/cc-attach" /usr/local/bin/cc-attach
sudo ln -sf "$(pwd)/bin/copilot-attach" /usr/local/bin/copilot-attach
sudo ln -sf "$(pwd)/bin/codex-attach" /usr/local/bin/codex-attach

Detach from any session with Ctrl+B then D — the agent keeps running in the background.

Note: These commands attach to tmux sessions named cc, ghcp, and codex. The sessions are created by your OpenClaw agent when it launches coding tasks. If no session is running, you'll see a message telling you to start one.

All settings can be overridden with environment variables:

Example:

POLL_STATS=5000 WARN_THRESHOLD=60 claw-monitor

• Node.js 18+
• OpenClaw installed and running
• tmux (for coding agent attach/detach)

Optional (auto-detected):

• nvidia-smi — for GPU monitoring
• Docker — for container monitoring
• kubectl — for Kubernetes/k3s pod monitoring

Watches OpenClaw's session directory (~/.openclaw/agents/main/sessions/) and sessions.json metadata to identify sub-agent sessions, parse JSONL logs for tool usage, and track activity via updatedAt timestamps.

Polls ps aux to detect running coding agent processes:

Filters out wrapper processes (sudo, bash, node shims) and deduplicates to one entry per agent type.

• OpenClaw — Runs openclaw cron list --json to fetch scheduled jobs
• System — Parses crontab -l for root crontab entries

Both parse cron expressions into human-readable schedules, calculate relative next-run times, and handle day-of-month / day-of-week OR logic per the cron spec.

• CPU — Parsed from top output
• Memory — os.totalmem() / os.freemem()
• Disk — Parsed from df -BG /
• GPU — Parsed from nvidia-smi --query-gpu (when available)
• Docker — Parsed from docker ps --format (when available)
• Kubernetes — Parsed from kubectl get pods (when available); auto-detects k3s via /etc/rancher/k3s/k3s.yaml
• Systemd — Parsed from systemctl list-units (when available); filters system-internal services

• Raw ANSI terminal rendering with TypeScript
• tmux — Terminal multiplexing for coding agent sessions

MIT © Dan Wahlin