git clone https://github.com/StonyTV/claude-code-monitor.git
cd claude-code-monitor
cp .env.example .env

# With Docker (recommended)
docker-compose up -d

# Without Docker
cd server && npm install && npm run dev

mkdir -p ~/.claude/hooks
cp hooks/send_event.sh ~/.claude/hooks/
chmod +x ~/.claude/hooks/send_event.sh

cd client && npm install && npm run dev

VITE_API_URL=http://your-server:3001
VITE_WS_URL=http://your-server:3001

graph LR
    A[Claude Code] -->|Events| B[Shell Hook]
    B -->|HTTP| C[Node.js Server]
    C -->|Store| D[(Storage)]
    C -->|WebSocket| E[React UI]
    D -.->|Memory/Redis/SQLite| D

# Memory (default) - Fast, no persistence
STORAGE_TYPE=memory

# Redis - Production, scalable
STORAGE_TYPE=redis
REDIS_URL=redis://localhost:6379

# SQLite - File-based persistence
STORAGE_TYPE=sqlite
SQLITE_PATH=./data/events.db

PORT=3001
NODE_ENV=production
ALLOWED_ORIGINS=http://localhost:5173,http://localhost:3000
MAX_EVENTS=10000
EVENT_TTL_DAYS=30

cd server
npm test                      # Run all tests
npm run test:watch            # Watch mode
npm run test:coverage         # Coverage report

# Server (auto-reload)
cd server && npm run dev

# Client (HMR)
cd client && npm run dev

# Docker
docker-compose up
docker-compose --profile redis up
docker-compose logs -f server

const ws = new WebSocket('ws://localhost:3001');
ws.on('message', (data) => {
  const event = JSON.parse(data);
  console.log(event);
});

# Get events
curl 'http://localhost:3001/api/events?limit=50'

# Filter by type
curl 'http://localhost:3001/api/events?event_type=PreToolUse'

# Session events
curl 'http://localhost:3001/api/events?session_id=abc123'

# Stats
curl 'http://localhost:3001/api/stats'

# Submit event
echo '{"tool_name": "Bash", "command": "npm test", "cwd": "/tmp/test-project"}' | \
  ~/.claude/hooks/send_event.sh \
  --event-type PreToolUse \
  --session-id "test-session-123" \
  --source-app "Claude Code"