Skip to content

README.md

Latest commit

 

History

History
123 lines (104 loc) · 2.9 KB

README.md

File metadata and controls

123 lines (104 loc) · 2.9 KB

Claude Code & OpenCode Monitor (ccmon)

Warning

This project is vibe-coded. Don't expect anything stable.

Real-time dashboard for your Claude Code & OpenCode sessions.

Screenshot 2026-02-22 at 14 29 37

Quick Start

  1. Installation or run locally with bun run serve
  2. Hook Configuration (for Claude Code)
  3. Start server with ccmon serve
  4. Open http://localhost:8080 in your browser

Features

  • View all your active Claude Code or OpenCode sessions, including their status, context usage, task progress, and sub-agents
    • Status reporting is semi-real-time for Claude Code, via hooks, but polled every 5s for OpenCode
  • Visual notifications when user attention is required (permission requests, stopped sessions, etc.)

Commands

ccmon serve [--port N]  # HTTP + WebSocket server (default port 8080)
ccmon status            # Hook handler: reads event from stdin, writes status file
ccmon dump              # Print all project states as JSON
ccmon dump --watch      # Stream project states on change

dump and dump --watch are primarily for debugging/scripting.

Installation

Via flakes

# Add flake input:
inputs.ccmon.url = "github:appaquet/ccmon";

# Add to packages:
inputs.ccmon.packages.${system}.default

Hook Configuration

Configure Claude Code hooks in ~/.claude/settings.json (or project-level .claude/settings.json). The project use them to track real-time signals that aren't available through watching session files.

{
  "hooks": {
    "UserPromptSubmit": [
      {
        "matcher": "",
        "hooks": [
          { "type": "command", "command": "ccmon status" }
        ]
      }
    ],
    "PostToolUse": [
      {
        "matcher": "",
        "hooks": [
          { "type": "command", "command": "ccmon status" }
        ]
      }
    ],
    "PermissionRequest": [
      {
        "matcher": "",
        "hooks": [
          { "type": "command", "command": "ccmon status" }
        ]
      }
    ],
    "Stop": [
      {
        "matcher": "",
        "hooks": [
          { "type": "command", "command": "ccmon status" }
        ]
      }
    ],
    "SessionEnd": [
      {
        "matcher": "",
        "hooks": [
          { "type": "command", "command": "ccmon status" }
        ]
      }
    ],
    "Notification": [
      {
        "matcher": "",
        "hooks": [
          { "type": "command", "command": "ccmon status" }
        ]
      }
    ],
    "SessionStart": [
      {
        "matcher": "",
        "hooks": [
          { "type": "command", "command": "ccmon status" }
        ]
      }
    ]
  }
}

Development

bun install     # Install dependencies
bun test        # Run tests
bun run dump    # Dump project states
bun run serve   # Start server