Claude CLI Session Monitor — Productivity skill for Claude Code

claude-cli-session-monitor

A tiny terminal monitor for **multi-session Claude Code CLI** workflows.

It shows, in one screen:

• Git status across multiple worktrees/branches
• Live output snippets from tmux windows running Claude CLI sessions

Designed for orchestration scenarios like “6 parallel Claude sessions, one branch per session”.

---

Features

• Full view: detailed pane tails + per-worktree file changes
• Compact view: always-on dashboard for long-running monitoring
• Works with any tmux session name and any worktree root
• --once mode for CI/log snapshots

---

Requirements

• bash (macOS/Linux/WSL)
• tmux
• git

---

Installation

Option A: clone

git clone https://github.com/MackDing/claude-cli-session-monitor.git
cd claude-cli-session-monitor
chmod +x scripts/*.sh

Option B: copy scripts only

Copy `scripts/monitor-full.sh` and `scripts/monitor-compact.sh` into your own repo/tooling folder.

---

Usage

1) Full dashboard

./scripts/monitor-full.sh \
  --session athena-6x \
  --worktrees ../Athena-worktrees

Single snapshot:

./scripts/monitor-full.sh --once

2) Compact dashboard (recommended for always-on)

./scripts/monitor-compact.sh \
  --session athena-6x \
  --worktrees ../Athena-worktrees \
  --refresh 5

Single snapshot:

./scripts/monitor-compact.sh --once

---

Common flags

• --session : tmux session name
• --worktrees : root directory containing worktrees
• --refresh : auto-refresh interval
• --lines : lines captured from pane tail
• --once: print once and exit

---

Typical workflow

1. Create worktrees (../Athena-worktrees/*)
2. Start tmux session with N Claude windows
3. Run compact monitor in another terminal
4. Use full monitor for deeper inspection when needed

---

Keep in project or not?

Recommended:

• Keep this tool in its own open-source repo as the canonical source.
• In pro