ae958528a6
Add comprehensive Claude Code monitoring and realtime streaming to the K8s dashboard. Includes API endpoints for health, stats, summary, inventory, and live event streaming. Frontend provides overview, usage, inventory, debug, and live feed views.
K8s Agent Dashboard
Lightweight web dashboard for the K8s Agent Orchestrator system. Designed to run on Raspberry Pi clusters with minimal resource usage.
Features
- Cluster Status - View node health, resource usage, and conditions
- Pending Actions - Approve or reject actions requiring confirmation
- Action History - Audit trail of all agent actions
- Workflows - View and trigger defined workflows
Resource Requirements
Optimized for Raspberry Pi 3B+ (1GB RAM):
- Memory: 32-64Mi
- CPU: 10-100m
Development
Prerequisites
- Go 1.21+
- Docker (for building images)
Local Development
# Run locally
go run ./cmd/server --port 8080 --data ./data --claude ~/.claude
# Build binary
go build -o server ./cmd/server
# Build Docker image
docker build -t k8s-agent-dashboard:dev .
Build for ARM64
# Build multi-arch image
docker buildx build --platform linux/arm64 -t ghcr.io/user/k8s-agent-dashboard:latest .
Deployment
Using Kustomize
kubectl apply -k deploy/
Using ArgoCD
- Copy
deploy/contents to your GitOps repo underapps/k8s-agent-dashboard/ - Apply the ArgoCD application:
kubectl apply -f deploy/argocd-application.yaml
Configuration
Environment Variables
| Variable | Default | Description |
|---|---|---|
| PORT | 8080 | Server port |
Command Line Flags
| Flag | Default | Description |
|---|---|---|
| --port | 8080 | Server port |
| --data | /data | Data directory for persistent state |
| --claude | ~/.claude | Claude Code directory |
API Endpoints
| Method | Path | Description |
|---|---|---|
| GET | /api/health | Health check |
| GET | /api/status | Cluster status |
| GET | /api/pending | Pending actions |
| POST | /api/pending/{id}/approve | Approve action |
| POST | /api/pending/{id}/reject | Reject action |
| GET | /api/history | Action history |
| GET | /api/workflows | List workflows |
| POST | /api/workflows/{name}/run | Trigger workflow |
Integration with Claude Code
The dashboard reads/writes state files that can be shared with Claude Code agents:
status.json- Cluster status (written by agents)pending.json- Pending actions (read/write)history.json- Action history (append by agents)
To share state, mount the same PVC or directory in both the dashboard and Claude Code's data directory.