ODS: Command for Claude Code

Log-Fix: Iterative Bug Fixing from Log Analysis

Analyze logs from Docker containers, installer runs, and service health checks. Identify errors, perform root cause analysis, and interactively fix issues with user approval.

"Logs tell stories. This skill reads them and writes the fixes."

Arguments

• $ARGUMENTS - Optional filters and configuration:
  • --time <duration> - Time range: 1h, 30m, 1d, 7d (default: 1h)
  • --source <source> - Log source: docker, installer, api, all (default: all)
  • --level <level> - Minimum severity: ERROR, WARNING, all (default: ERROR)
  • --service <name> - Filter by service name (e.g., ods-llama-server, ods-open-webui, ods-dashboard)

---

Phase 0: Log Source Discovery

Detect all available log sources before analysis.

0.1 Check Docker Compose Logs

# Find the resolved compose stack
COMPOSE_FILES=""
if [ -f "ods/docker-compose.base.yml" ]; then
  COMPOSE_FILES="-f ods/docker-compose.base.yml"
  for overlay in ods/docker-compose.{amd,nvidia,apple}.yml; do
    [ -f "$overlay" ] && COMPOSE_FILES="$COMPOSE_FILES -f $overlay"
  done
fi

# Check running containers
if [ -n "$COMPOSE_FILES" ]; then
  docker compose $COMPOSE_FILES ps --format "table {{.Name}}\t{{.Status}}" || echo "Docker not running"
else
  echo "No compose files found"
fi

0.2 Check Installer Logs

INSTALL_LOG="$HOME/.ods/install.log"
if [ -f "$INSTALL_LOG" ]; then
  INSTALL_SIZE=$(du -h "$INSTALL_LOG" | cut -f1)
  INSTALL_LINES=$(wc -l < "$INSTALL_LOG")
  echo "Installer log: $INSTALL_LOG ($INSTALL_SIZE, $INSTALL_LINES lines)"
else
  echo "Installer log: NOT FOUND at $INSTALL_LOG"
fi

0.3 Check Service Health Endpoints

# LLM server health
curl -sf http://127.0.0.1:8080/health && echo "LLM server: HEALTHY" || echo "LLM server: UNREACHABLE"

# Dashboard API health
curl -sf http://127.0.0.1:3001/health && echo "Dashboard API: HEALTHY" || echo "Dashboard API: UNREACHABLE"

# Open WebUI
curl -sf http://127.0.0.1:3000 && echo "Open WebUI: HEALTHY" || echo "Open WebUI: UNREACHABLE"