# Claude Monitor

> A live terminal dashboard for monitoring multiple Claude Code sessions at once, with Windows toast notifications.

Claude Monitor is a lightweight Node.js tool for developers who run multiple Claude Code sessions simultaneously. It provides a single terminal dashboard that shows the real-time status of every running Claude Code instance — what each session is doing, when it last acted, and critically, when any session is waiting for user input.

The dashboard refreshes every 2 seconds and displays five session states: working (executing a tool), thinking (processing a result), waiting (needs user input), done (finished), and running (process detected, no hook data yet). Sessions in the "waiting" state are highlighted in the dashboard and trigger a native Windows toast notification so the developer is alerted even when away from the terminal.

An additional crash recovery feature persists every session ID to a JSON map file. After a system crash or reboot, developers can inspect this file to identify which session belongs to which project and resume with `claude --resume <session-id>`.

The tool consists of three files: `monitor.js` (the dashboard renderer), `session-hook.js` (the Claude Code hook that writes status files), and `notify.ps1` (the PowerShell script for Windows toast notifications). Setup requires copying these files to `~/.claude/` and adding five hook entries to `~/.claude/settings.json`.

## Key pages

- /: Main landing page with setup instructions and live terminal demo

## Requirements

- Windows 10 or 11
- Node.js
- Claude Code (claude.ai/code)

## Contact

ibrahim@whhite.com

## Source

https://github.com/ibrahimokdadov/claudeMonitor