clawmonitor 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026
+
+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/README.md

@@ -0,0 +1,80 @@
+**[English](README.md)** · [简体中文](README.zh-CN.md) · [繁體中文](README.zh-TW.md)
+
+---
+
+# ClawMonitor
+
+Real-time OpenClaw tool call monitor. Watch all agent sessions with readable names and sorted output.
+
+## Install
+
+```bash
+# Run without installing
+npx clawmonitor
+
+# Install globally
+npm install -g clawmonitor
+clawmonitor
+```
+
+## Features
+
+- 🔧 Real-time monitoring of all OpenClaw agent tool calls
+- 📜 Shows last 10 history entries on startup (cross-session, sorted by time)
+- 📋 Readable session names (auto-parsed from conversation_label)
+- 🔄 Auto-tracks newly created sessions
+- 🎨 Colored terminal output (respects `NO_COLOR`)
+- 🖥️ Cross-platform: Linux, macOS, Windows (Git Bash / WSL)
+
+## Usage
+
+```
+clawmonitor [options]
+
+Options:
+  --all        Monitor all sessions (no time filter)
+  --compact    Compact one-line output
+  --history N  Show last N history entries (default: 10)
+  --help       Show help
+```
+
+## Examples
+
+```bash
+# Default: last 30 min sessions + 10 history
+clawmonitor
+
+# Compact mode with 20 history entries
+clawmonitor --compact --history 20
+
+# Monitor all sessions regardless of time
+clawmonitor --all
+```
+
+## Requirements
+
+- **jq** — the only external dependency
+  - Linux: `sudo apt install jq`
+  - macOS: `brew install jq`
+  - Windows: `pacman -S jq` (Git Bash) or use WSL
+
+Everything else (`tail`, `date`, `bash`) comes pre-installed.
+
+## Environment Variables
+
+| Variable | Description |
+|---|---|
+| `OPENCLAW_HOME` | Custom OpenClaw data directory |
+| `NO_COLOR` | Disable colored output |
+
+## Development
+
+```bash
+git clone https://github.com/reopenpilot/clawmonitor.git
+cd clawmonitor
+bash bin/clawmonitor.sh --help
+```
+
+## License
+
+MIT

package/README.zh-CN.md

@@ -0,0 +1,80 @@
+[English](README.md) · **[简体中文](README.zh-CN.md)** · [繁體中文](README.zh-TW.md)
+
+---
+
+# ClawMonitor
+
+实时监控 OpenClaw 所有 agent 的 tool calls，跨 session、按时间排序。
+
+## 安装
+
+```bash
+# 无需安装直接运行
+npx clawmonitor
+
+# 全局安装
+npm install -g clawmonitor
+clawmonitor
+```
+
+## 功能
+
+- 🔧 实时监控所有 OpenClaw agent 的 tool calls
+- 📜 启动时显示最近 10 条历史记录（跨 session，按时间排序）
+- 📋 可读的 session 名称（自动解析 conversation_label）
+- 🔄 自动追踪新建的 session
+- 🎨 彩色终端输出（支持 `NO_COLOR` 环境变量）
+- 🖥️ 跨平台：Linux、macOS、Windows（Git Bash / WSL）
+
+## 使用方法
+
+```
+clawmonitor [选项]
+
+选项:
+  --all        监控所有 session（不限时间）
+  --compact    精简一行输出
+  --history N  显示最近 N 条历史记录（默认 10）
+  --help       显示帮助
+```
+
+## 示例
+
+```bash
+# 默认：最近 30 分钟的 session + 10 条历史
+clawmonitor
+
+# 精简模式，显示 20 条历史
+clawmonitor --compact --history 20
+
+# 监控所有 session（不限时间）
+clawmonitor --all
+```
+
+## 依赖
+
+- **jq** — 唯一的外部依赖
+  - Linux: `sudo apt install jq`
+  - macOS: `brew install jq`
+  - Windows: `pacman -S jq`（Git Bash）或使用 WSL
+
+其他（`tail`、`date`、`bash`）系统自带。
+
+## 环境变量
+
+| 变量 | 说明 |
+|---|---|
+| `OPENCLAW_HOME` | 自定义 OpenClaw 数据目录 |
+| `NO_COLOR` | 禁用彩色输出 |
+
+## 开发
+
+```bash
+git clone https://github.com/reopenpilot/clawmonitor.git
+cd clawmonitor
+bash bin/clawmonitor.sh --help
+```
+
+## 许可证
+
+MIT

package/README.zh-TW.md

@@ -0,0 +1,80 @@
+[English](README.md) · [简体中文](README.zh-CN.md) · **[繁體中文](README.zh-TW.md)**
+
+---
+
+# ClawMonitor
+
+即時監控 OpenClaw 所有 agent 的 tool calls，跨 session、按時間排序。
+
+## 安裝
+
+```bash
+# 不用安裝直接跑
+npx clawmonitor
+
+# 全域安裝
+npm install -g clawmonitor
+clawmonitor
+```
+
+## 功能
+
+- 🔧 即時監控所有 OpenClaw agent 的 tool calls
+- 📜 啟動時顯示最近 10 筆歷史記錄（跨 session，按時間排序）
+- 📋 可讀的 session 名稱（自動解析 conversation_label）
+- 🔄 自動追蹤新建的 session
+- 🎨 彩色終端機輸出（支援 `NO_COLOR` 環境變數）
+- 🖥️ 跨平台：Linux、macOS、Windows（Git Bash / WSL）
+
+## 使用方式
+
+```
+clawmonitor [選項]
+
+選項:
+  --all        監控所有 session（不限時間）
+  --compact    精簡一行輸出
+  --history N  顯示最近 N 筆歷史記錄（預設 10）
+  --help       顯示說明
+```
+
+## 範例
+
+```bash
+# 預設：最近 30 分鐘的 session + 10 筆歷史
+clawmonitor
+
+# 精簡模式，顯示 20 筆歷史
+clawmonitor --compact --history 20
+
+# 監控所有 session（不限時間）
+clawmonitor --all
+```
+
+## 依賴
+
+- **jq** — 唯一的外部依賴
+  - Linux: `sudo apt install jq`
+  - macOS: `brew install jq`
+  - Windows: `pacman -S jq`（Git Bash）或使用 WSL
+
+其他（`tail`、`date`、`bash`）系統內建。
+
+## 環境變數
+
+| 變數 | 說明 |
+|---|---|
+| `OPENCLAW_HOME` | 自訂 OpenClaw 資料目錄 |
+| `NO_COLOR` | 停用彩色輸出 |
+
+## 開發
+
+```bash
+git clone https://github.com/reopenpilot/clawmonitor.git
+cd clawmonitor
+bash bin/clawmonitor.sh --help
+```
+
+## 授權
+
+MIT

package/bin/clawmonitor.sh

@@ -0,0 +1,449 @@
+#!/usr/bin/env bash
+# clawmonitor — Real-time OpenClaw tool call monitor
+#
+# Usage:
+#   clawmonitor              # Default: last 30 min sessions + 10 history
+#   clawmonitor --all        # Monitor all sessions
+#   clawmonitor --compact    # Compact output
+#   clawmonitor --history N  # Show N recent tool calls
+#
+# npx clawmonitor            # Run without installing
+
+set -euo pipefail
+
+# === Platform detection ===
+OS="$(uname -s 2>/dev/null || echo "unknown")"
+ARCH="$(uname -m 2>/dev/null || echo "unknown")"
+
+IS_WINDOWS=false
+if [[ "$OS" == "MINGW"* || "$OS" == "MSYS"* || "$OS" == "CYGWIN"* ]]; then
+  IS_WINDOWS=true
+fi
+
+# === Detect OpenClaw data directory ===
+if [[ -n "${OPENCLAW_HOME:-}" ]]; then
+  AGENTS_DIR="$OPENCLAW_HOME/agents"
+elif [[ -d "$HOME/.openclaw/agents" ]]; then
+  AGENTS_DIR="$HOME/.openclaw/agents"
+elif [[ -n "${XDG_DATA_HOME:-}" ]] && [[ -d "$XDG_DATA_HOME/openclaw/agents" ]]; then
+  AGENTS_DIR="$XDG_DATA_HOME/openclaw/agents"
+elif [[ "$IS_WINDOWS" == "true" ]] && [[ -d "$APPDATA/openclaw/agents" ]]; then
+  AGENTS_DIR="$APPDATA/openclaw/agents"
+else
+  echo "❌ Cannot find OpenClaw data directory."
+  echo ""
+  echo "   Tried:"
+  echo "     - \$OPENCLAW_HOME/agents"
+  echo "     - ~/.openclaw/agents"
+  echo "     - \$XDG_DATA_HOME/openclaw/agents"
+  if [[ "$IS_WINDOWS" == "true" ]]; then
+    echo "     - %APPDATA%/openclaw/agents"
+  fi
+  echo ""
+  echo "   Set OPENCLAW_HOME to your OpenClaw data directory."
+  exit 1
+fi
+
+# === Check dependencies ===
+MISSING=()
+for cmd in jq tail date; do
+  if ! command -v "$cmd" &>/dev/null; then
+    MISSING+=("$cmd")
+  fi
+done
+
+if [[ ${#MISSING[@]} -gt 0 ]]; then
+  echo "❌ Missing required commands: ${MISSING[*]}"
+  echo ""
+  echo "   Install them:"
+  echo ""
+  if [[ "$IS_WINDOWS" == "true" ]]; then
+    echo "   🪟 Windows (Git Bash / MSYS2):"
+    echo "     pacman -S jq"
+    echo ""
+    echo "   Or use WSL:"
+    echo "     sudo apt install jq"
+  elif [[ "$OS" == "Darwin" ]]; then
+    echo "   🍎 macOS:"
+    echo "     brew install jq"
+    echo ""
+    echo "   No Homebrew? Install it first:"
+    echo "     /bin/bash -c \"\$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)\""
+  else
+    echo "   🐧 Linux:"
+    echo "     sudo apt install jq        # Debian/Ubuntu"
+    echo "     sudo dnf install jq        # Fedora"
+    echo "     sudo pacman -S jq          # Arch"
+    echo "     sudo apk add jq            # Alpine"
+  fi
+  echo ""
+  echo "   jq is the only external dependency. tail and date are usually pre-installed."
+  exit 1
+fi
+
+# === Cross-platform helpers ===
+
+# Get file modification time (HH:MM:SS)
+get_mod_time() {
+  local file="$1"
+  if [[ "$OS" == "Darwin" ]]; then
+    stat -f '%Sm' -t '%H:%M:%S' "$file" 2>/dev/null || echo "???"
+  elif [[ "$IS_WINDOWS" == "true" ]]; then
+    stat -c '%y' "$file" 2>/dev/null | cut -c12-19 || echo "???"
+  else
+    stat -c '%y' "$file" 2>/dev/null | cut -c12-19 || echo "???"
+  fi
+}
+
+# Format ISO timestamp → HH:MM:SS
+format_timestamp() {
+  local ts="$1"
+  if [[ -z "$ts" || "$ts" == "null" || "$ts" == "???" ]]; then
+    echo "???"
+    return
+  fi
+
+  if [[ "$OS" == "Darwin" ]]; then
+    if date -j -f "%Y-%m-%dT%H:%M:%S" "$(echo "$ts" | cut -c1-19)" "+%H:%M:%S" 2>/dev/null; then
+      return
+    fi
+    echo "$ts" | cut -c12-19
+  else
+    date -d "$ts" "+%H:%M:%S" 2>/dev/null || echo "$ts" | cut -c12-19
+  fi
+}
+
+# Portable grep (no -P on macOS)
+grep_p() {
+  if [[ "$OS" == "Darwin" ]]; then
+    grep -E "$@"
+  else
+    grep -P "$@"
+  fi
+}
+
+# === Argument parsing ===
+COMPACT=false
+SHOW_HISTORY=false
+HISTORY_N=10
+TIME_RANGE=30  # minutes, 0 = all
+
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    --compact)
+      COMPACT=true
+      shift
+      ;;
+    --history)
+      SHOW_HISTORY=true
+      if [[ $# -gt 1 ]] && [[ "$2" =~ ^[0-9]+$ ]]; then
+        HISTORY_N="$2"
+        shift 2
+      else
+        shift
+      fi
+      ;;
+    --all)
+      TIME_RANGE=0
+      shift
+      ;;
+    --help|-h)
+      echo "clawmonitor — Real-time OpenClaw tool call monitor"
+      echo ""
+      echo "Usage: clawmonitor [options]"
+      echo ""
+      echo "  --all       Monitor all sessions (no time filter)"
+      echo "  --compact   Show only tool name + brief args"
+      echo "  --history   Show recent history before live tail"
+      echo "  --history N Show last N tool calls from history (default: 10)"
+      echo "  --help      Show this help"
+      echo ""
+      echo "  Monitors all agents under ~/.openclaw/agents/"
+      echo "  Supports Linux, macOS, and Windows (Git Bash / WSL)"
+      echo ""
+      echo "  Environment variables:"
+      echo "    OPENCLAW_HOME  Custom OpenClaw data directory"
+      echo "    NO_COLOR       Disable colored output"
+      exit 0
+      ;;
+    [0-9]*)
+      if $SHOW_HISTORY; then
+        HISTORY_N="$1"
+        shift
+      else
+        echo "Unknown argument: $1"
+        exit 1
+      fi
+      ;;
+    *)
+      echo "Unknown argument: $1"
+      exit 1
+      ;;
+  esac
+done
+
+# === Color setup ===
+if [[ -t 1 ]] && [[ "${NO_COLOR:-}" == "" ]]; then
+  RST='\033[0m' BLD='\033[1m' DIM='\033[2m'
+  CYN='\033[36m' GRN='\033[32m' YLW='\033[33m' MAG='\033[35m' RED='\033[31m'
+  BLU='\033[34m' WHT='\033[37m'
+else
+  RST='' BLD='' DIM=''
+  CYN='' GRN='' YLW='' MAG='' RED=''
+  BLU='' WHT=''
+fi
+
+# === Session management ===
+
+find_sessions() {
+  local find_cmd=(find "$AGENTS_DIR" -path "*/sessions/*.jsonl" -type f)
+  if [[ "$TIME_RANGE" -eq 0 ]]; then
+    "${find_cmd[@]}"
+  else
+    local now_epoch
+    now_epoch=$(date +%s)
+
+    "${find_cmd[@]}" | while IFS= read -r file; do
+      local mod_epoch
+      if [[ "$OS" == "Darwin" ]]; then
+        mod_epoch=$(stat -f '%m' "$file" 2>/dev/null || echo 0)
+      else
+        mod_epoch=$(stat -c '%Y' "$file" 2>/dev/null || echo 0)
+      fi
+
+      if [[ "$mod_epoch" -gt 0 ]] && (( now_epoch - mod_epoch <= TIME_RANGE * 60 )); then
+        echo "$file"
+      fi
+    done
+  fi
+}
+
+# Extract readable session name from conversation_label
+get_session_label() {
+  local file="$1"
+  local agent_name
+  agent_name=$(echo "$file" | sed "s|$AGENTS_DIR/||;s|/sessions/.*||")
+
+  local filename
+  filename=$(basename "$file" .jsonl)
+
+  local conv_label
+  conv_label=$(jq -r 'select(.type=="message" and .message.role=="user") |
+    .message.content[] | select(.type=="text") | .text' "$file" 2>/dev/null | \
+    head -20 | \
+    grep_p -o '"conversation_label"[[:space:]]*:[[:space:]]*"[^"]*"' 2>/dev/null | head -1 | \
+    sed 's/"conversation_label" : "//;s/"conversation_label": "//;s/"$//')
+
+  if [[ -n "$conv_label" ]]; then
+    local group topic group_name
+    group=$(echo "$conv_label" | grep_p -o 'id:[^ ]+' 2>/dev/null | sed 's/id://')
+    topic=$(echo "$conv_label" | grep_p -o 'topic:[0-9]+' 2>/dev/null | sed 's/topic:/t/')
+    group_name=$(echo "$conv_label" | grep_p -o '^[^ ]+' 2>/dev/null)
+
+    if [[ -n "$topic" ]]; then
+      echo "${agent_name}/${group_name}/${topic}"
+    elif [[ -n "$group_name" ]]; then
+      echo "${agent_name}/${group_name}"
+    else
+      echo "${agent_name}/${conv_label}"
+    fi
+  else
+    local short_id topic_suffix
+    short_id=$(echo "$filename" | sed 's/-topic-[0-9]*$//;s/-\([0-9a-f]\{4\}\).*/..*\1/')
+    topic_suffix=$(echo "$filename" | grep_p -o 'topic-[0-9]+' 2>/dev/null || true)
+    if [[ -n "$topic_suffix" ]]; then
+      echo "${agent_name}/DM/${topic_suffix}"
+    else
+      echo "${agent_name}/DM/${short_id}"
+    fi
+  fi
+}
+
+declare -A SESSION_LABELS
+
+cache_labels() {
+  local files="$1"
+  for f in $files; do
+    local key
+    key=$(basename "$f")
+    SESSION_LABELS["$key"]=$(get_session_label "$f")
+  done
+}
+
+# Extract tool calls from a single session JSONL
+extract_tool_calls() {
+  local file="$1"
+  local limit="${2:-0}"
+  local filename
+  filename=$(basename "$file")
+
+  local filter='select(.type=="message" and .message.role=="assistant") |
+    {ts: (.timestamp // .message.timestamp), file: "'"${filename}"'", content: [.message.content[] | select(.type=="toolCall")]} |
+    select(.content | length > 0)'
+
+  if [[ "$limit" -gt 0 ]]; then
+    jq -c "$filter" "$file" 2>/dev/null | tail -"$limit"
+  else
+    jq -c "$filter" "$file" 2>/dev/null
+  fi
+}
+
+# Format a single tool call entry
+format_tc() {
+  local json="$1"
+  local ts filename label
+  ts=$(echo "$json" | jq -r '.ts // "???"')
+  filename=$(echo "$json" | jq -r '.file // "?"')
+  label="${SESSION_LABELS[$filename]:-${filename}}"
+
+  local time_str
+  time_str=$(format_timestamp "$ts")
+
+  echo "$json" | jq -c '.content[]' 2>/dev/null | while IFS= read -r tc; do
+    local tool_name tool_id
+    tool_name=$(echo "$tc" | jq -r '.name // "?"')
+    tool_id=$(echo "$tc" | jq -r '.id // "?"' | cut -c1-12)
+
+    if $COMPACT; then
+      local brief_args
+      brief_args=$(echo "$tc" | jq -r '
+        .arguments | to_entries[:2] |
+        map("\(.key)=\(.value | tostring | .[0:80])") | join(" ")
+      ' 2>/dev/null)
+      printf "${GRN}%-13s${RST} ${BLU}%-28s${RST} ${CYN}%-9s${RST} %s\n" \
+        "$tool_name" "${label:0:28}" "$time_str" "$brief_args"
+    else
+      printf "\n${BLD}${YLW}⏱ %s${RST}  ${BLU}%s${RST}  ${MAG}%s${RST}\n" \
+        "$time_str" "${label}" "$tool_id"
+      printf "  ${GRN}▶ %s${RST}\n" "$tool_name"
+
+      echo "$tc" | jq -c '.arguments | to_entries[]' 2>/dev/null | while IFS= read -r entry; do
+        local key val
+        key=$(echo "$entry" | jq -r '.key')
+        val=$(echo "$entry" | jq -r '.value | tostring | .[0:300]')
+        [[ ${#val} -ge 300 ]] && val="${val}…"
+        printf "    ${CYN}%-14s${RST} %s\n" "$key" "$val"
+      done
+    fi
+  done
+}
+
+# === Main ===
+
+sessions=$(find_sessions | sort)
+session_count=$(echo "$sessions" | grep -c . 2>/dev/null || echo 0)
+
+if [[ "$session_count" -eq 0 ]]; then
+  echo -e "${RED}No sessions found under ${AGENTS_DIR}${RST}"
+  echo "Try --all or wait for activity."
+  exit 1
+fi
+
+cache_labels "$sessions"
+
+echo -e "${BLD}🔧 OpenClaw Tool Call Monitor${RST}"
+echo -e "${DIM}Watching ${session_count} session(s) on ${OS} — Ctrl+C to stop${RST}"
+echo ""
+
+# List all sessions
+echo -e "${BLD}📋 Active sessions:${RST}"
+for f in $sessions; do
+  filename=$(basename "$f")
+  label="${SESSION_LABELS[$filename]}"
+  mod_time=$(get_mod_time "$f")
+  printf "  ${DIM}%-9s${RST} ${BLU}%-35s${RST} ${DIM}(last: %s)${RST}\n" \
+    "$(echo "$filename" | cut -c1-8)" "${label:0:35}" "$mod_time"
+done
+
+if $COMPACT; then
+  printf "\n${DIM}%-13s %-28s %-9s %s${RST}\n" "TOOL" "SESSION" "TIME" "ARGS"
+  echo "-------------------------------------------------------------------------"
+fi
+
+# Default: show last 10 history entries
+if ! $SHOW_HISTORY; then
+  SHOW_HISTORY=true
+fi
+
+# Show history sorted by time
+if $SHOW_HISTORY; then
+  echo -e "\n${BLD}📜 Recent tool calls (sorted by time):${RST}"
+  for f in $sessions; do
+    extract_tool_calls "$f" 0
+  done | jq -s 'sort_by(.ts)' | jq -c '.[]' > /tmp/openclaw-tc-history.jsonl
+
+  if [[ "$HISTORY_N" -gt 0 ]]; then
+    tail -"$HISTORY_N" /tmp/openclaw-tc-history.jsonl | while IFS= read -r line; do
+      format_tc "$line"
+    done
+  else
+    cat /tmp/openclaw-tc-history.jsonl | while IFS= read -r line; do
+      format_tc "$line"
+    done
+  fi
+  rm -f /tmp/openclaw-tc-history.jsonl
+
+  echo -e "\n${BLD}🔴 Live monitoring:${RST}"
+  if $COMPACT; then
+    echo "-------------------------------------------------------------------------"
+  fi
+fi
+
+# Live monitoring with glob pattern for auto-tracking new sessions
+SESSIONS_GLOB="${AGENTS_DIR}/*/sessions/*.jsonl"
+shopt -s nullglob
+live_session_files=("$AGENTS_DIR"/*/sessions/*.jsonl)
+shopt -u nullglob
+
+tail -F -n 0 $SESSIONS_GLOB 2>/dev/null | {
+  current_file=""
+  if [[ "${#live_session_files[@]}" -eq 1 ]]; then
+    current_file="${live_session_files[0]}"
+  fi
+  while IFS= read -r line; do
+    # Detect tail -F file switch header
+    if [[ "$line" == "==>"* ]]; then
+      current_file=$(echo "$line" | sed 's/==> \(.*\) <==/\1/')
+      continue
+    fi
+
+    # Quick filter
+    echo "$line" | grep -q '"toolCall"' || continue
+    echo "$line" | grep -q '"assistant"' || continue
+
+    filename=$(basename "${current_file}")
+    # Dynamic label lookup for new sessions
+    if [[ -z "${SESSION_LABELS[$filename]:-}" ]]; then
+      SESSION_LABELS["$filename"]=$(get_session_label "${current_file}")
+    fi
+    label="${SESSION_LABELS[$filename]}"
+
+    ts=$(echo "$line" | jq -r '.timestamp // .message.timestamp // "???"' 2>/dev/null)
+    time_str=$(format_timestamp "$ts")
+
+    echo "$line" | jq -c '.message.content[] | select(.type=="toolCall")' 2>/dev/null | while IFS= read -r tc; do
+      tool_name=$(echo "$tc" | jq -r '.name // "?"')
+      tool_id=$(echo "$tc" | jq -r '.id // "?"' | cut -c1-12)
+
+      if $COMPACT; then
+        brief_args=$(echo "$tc" | jq -r '
+          .arguments | to_entries[:2] |
+          map("\(.key)=\(.value | tostring | .[0:80])") | join(" ")
+        ' 2>/dev/null)
+        printf "${GRN}%-13s${RST} ${BLU}%-28s${RST} ${CYN}%-9s${RST} %s\n" \
+          "$tool_name" "${label:0:28}" "$time_str" "$brief_args"
+      else
+        printf "\n${BLD}${YLW}⏱ %s${RST}  ${BLU}%s${RST}  ${MAG}%s${RST}\n" \
+          "$time_str" "${label}" "$tool_id"
+        printf "  ${GRN}▶ %s${RST}\n" "$tool_name"
+
+        echo "$tc" | jq -c '.arguments | to_entries[]' 2>/dev/null | while IFS= read -r entry; do
+          key=$(echo "$entry" | jq -r '.key')
+          val=$(echo "$entry" | jq -r '.value | tostring | .[0:300]')
+          [[ ${#val} -ge 300 ]] && val="${val}…"
+          printf "    ${CYN}%-14s${RST} %s\n" "$key" "$val"
+        done
+      fi
+    done
+  done
+}

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "clawmonitor",
+  "version": "1.0.0",
+  "description": "Real-time OpenClaw tool call monitor — watch all agent sessions with readable names and sorted output",
+  "bin": {
+    "clawmonitor": "./bin/clawmonitor.sh"
+  },
+  "scripts": {
+    "test": "bash -n bin/clawmonitor.sh"
+  },
+  "keywords": [
+    "openclaw",
+    "monitor",
+    "tool-calls",
+    "debug",
+    "cli"
+  ],
+  "author": "reopenpilot",
+  "license": "MIT",
+  "engines": {
+    "node": ">=18"
+  },
+  "files": [
+    "bin/",
+    "README.md",
+    "README.zh-CN.md",
+    "README.zh-TW.md",
+    "LICENSE"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/reopenpilot/clawmonitor.git"
+  },
+  "dependencies": {},
+  "homepage": "https://github.com/reopenpilot/clawmonitor#readme",
+  "bugs": {
+    "url": "https://github.com/reopenpilot/clawmonitor/issues"
+  }
+}