Surveil

Launch a real-time surveillance dashboard for Claude Code agent teams

az9713 d0a8bbe 9 files · 128.2 KB Updated

File contents

Agent Team Surveillance Dashboard

Launch a real-time web dashboard that monitors Claude Code agent team activity.

What it does

  • Watches ~/.claude/teams/ and ~/.claude/tasks/ for live changes
  • Shows agent roster with roles, models, and status
  • Streams inter-agent messages with type badges (task_assignment, shutdown, idle, etc.)
  • Displays a kanban task board (Pending / In Progress / Completed)
  • Persists session history in SQLite for review

How to launch

  1. Check if dependencies are installed:
cd surveil/server && [ -d node_modules ] || npm install
  1. Start the server:
node surveil/server/index.js
  1. Tell the user to open http://localhost:3847

Configuration

The server watches these directories by default:

  • Teams: ~/.claude/teams/
  • Tasks: ~/.claude/tasks/

Set environment variables to override:

  • SURVEIL_TEAMS_DIR - path to teams directory
  • SURVEIL_TASKS_DIR - path to tasks directory
  • SURVEIL_PORT - server port (default 3847)

az9713/my-agent-skills/tree/main/.claude/skills/surveil commit d0a8bbe4d2

Frequently asked questions

npx skillmds@latest add az9713/surveil