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.

Quick Start

1. Installation or run locally with npm 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

OpenCode Plugin (optional)

For near-instant OpenCode status detection, install the plugin:

# Manual install — copy file to plugins directory
cp resources/opencode-plugin/ccmon.ts ~/.config/opencode/plugins/ccmon.ts

# Via Nix packages (home-manager example):
home.file.".config/opencode/plugins/ccmon.ts".source = "${pkgs.ccmon.opencode-plugin}/ccmon.ts";

Without the plugin, OpenCode sessions are detected via SQLite polling (5s interval, running/stopped only).

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

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