agents

List all AI agents with versions and deployment status. Use when checking agent health, versions, or deployment state.

⭐5stars🔀1forks📁View on GitHub🕐Updated Jan 11, 2026⬇️1downloads

When & Why to Use This Skill

This Claude skill provides comprehensive monitoring and management capabilities for AI agent deployments. It enables developers to track agent health, verify source versions against deployed images, and inspect Kubernetes pod statuses and logs, ensuring the operational reliability of agentic infrastructure.

Use Cases

  • System Health Monitoring: Real-time tracking of AI agent pod statuses in Kubernetes clusters to identify and resolve service interruptions immediately.
  • Version Consistency Audits: Compare local source versions from pyproject.toml with active container images to ensure the latest updates are successfully deployed.
  • Rapid Troubleshooting: Access recent logs and Git deployment history for specific agents to diagnose performance issues or configuration errors directly through the chat interface.
nameagents
descriptionList all AI agents with versions and deployment status. Use when checking agent health, versions, or deployment state.

List Agents

Show all available agents, their versions, and deployment status.

Arguments

  • agent-name: Optional specific agent name for detailed info

Instructions

List All Agents

cd /home/al/git/kubani
echo "=== AI Agents ==="
echo ""

for earthfile in agents/*/Earthfile; do
    agent_dir=$(dirname "$earthfile")
    agent_name=$(basename "$agent_dir")
    [ "$agent_name" = "core" ] && continue

    # Get version from pyproject.toml
    version=$(grep '^version = ' "$agent_dir/pyproject.toml" | sed 's/version = "\(.*\)"/\1/')

    # Get deployed image
    deployed=$(KUBECONFIG=/home/al/.kube/config kubectl get deploy $agent_name -n ai-agents -o jsonpath='{.spec.template.spec.containers[0].image}' 2>/dev/null || echo "not deployed")

    # Get pod status
    status=$(KUBECONFIG=/home/al/.kube/config kubectl get pods -n ai-agents -l app.kubernetes.io/name=$agent_name -o jsonpath='{.items[0].status.phase}' 2>/dev/null || echo "unknown")

    echo "$agent_name"
    echo "  Source version: $version"
    echo "  Deployed image: $deployed"
    echo "  Pod status: $status"
    echo ""
done

Detailed Agent Info

For a specific agent, also show:

AGENT_NAME="k8s-monitor"

# Pod details
KUBECONFIG=/home/al/.kube/config kubectl get pods -n ai-agents -l app.kubernetes.io/name=$AGENT_NAME -o wide

# Recent logs
KUBECONFIG=/home/al/.kube/config kubectl logs -n ai-agents -l app.kubernetes.io/name=$AGENT_NAME --tail=20

# Recent deployment history
git log --oneline -5 gitops/apps/ai-agents/$AGENT_NAME/deployment.yaml

Core Library

The core-agents library is shared by all agents:

version=$(grep '^version = ' agents/core/pyproject.toml | sed 's/version = "\(.*\)"/\1/')
echo "core-agents (library): v$version"