| name | system-check |
| description | Check system status — repos, services, containers, APIs. Use when you need to verify system health or diagnose issues. |
System Check — Status Diagnostics
Run diagnostics on your system components. Adapt the commands to your infrastructure.
Quick checks
API health
curl -s --max-time 5 "http://${DND_VPS_IP:-localhost}:${DND_VPS_PORT:-3002}/api/status" \
-H "X-Auth-Token: ${DND_API_TOKEN}"
Service status
systemctl is-active ${DND_SERVICE_NAME:-my-service} 2>/dev/null || echo "Service not found"
Container health (if using Docker)
docker ps --filter "name=${DND_CONTAINER_NAME:-my-container}" --format "{{.Names}}: {{.Status}}"
Container logs
docker logs ${DND_CONTAINER_NAME:-my-container} --tail 20 2>&1
Interpreting results
- status: online — API responding
- Up X minutes (healthy) — container running with health check passing
- EACCES — file ownership issue (docker cp creates root-owned files)
Environment variables
Configure these in your .env or shell profile:
DND_VPS_IP — your server IP (default: localhost)DND_VPS_PORT — API port (default: 3002)DND_API_TOKEN — authentication tokenDND_CONTAINER_NAME — Docker container nameDND_SERVICE_NAME — systemd service name
$ARGUMENTS
Eval
Trigger Tests
"check system health" -> activates
"is the server running" -> activates
"diagnose API issues" -> activates
"deploy new version" -> does NOT activate
Fidelity Tests
Given healthy system: reports all services online
Given API down: reports unreachable with suggestion
Given missing env vars: uses defaults, warns about configuration
