home / skills / julianobarbosa / claude-code-skills / argocd-command-skill

argocd-command-skill skill

This skill streamlines ArgoCD CLI tasks for cafehyna-hub, enabling app management, syncing, and status checks across production and port-forwarded sessions.

npx playbooks add skill julianobarbosa/claude-code-skills --skill argocd-command-skill

Review the files below or copy the command above to add this skill to your agents.

Files (9)

SKILL.md

4.2 KB

---
name: ArgoCdCommand
description: ArgoCD CLI interaction for cafehyna-hub cluster. USE WHEN managing ArgoCD applications OR applicationsets OR syncing OR deploying OR checking app status OR managing clusters/repos/projects via argocd CLI at argocd.cafehyna.com.br or localhost:8080.
---

# ArgoCdCommand

Complete ArgoCD CLI interaction skill for the `cafehyna-hub` cluster at `argocd.cafehyna.com.br` or via port-forward at `localhost:8080`.

## Cluster Configuration

| Setting | Value |
|---------|-------|
| **Kubeconfig** | `~/.kube/aks-rg-hypera-cafehyna-hub-config` |
| **ArgoCD Server** | `argocd.cafehyna.com.br` |
| **ArgoCD Namespace** | `argocd` |
| **Port-Forward** | `localhost:8080` |

### Environment Setup

```bash
# Set kubeconfig for cafehyna-hub
export KUBECONFIG=~/.kube/aks-rg-hypera-cafehyna-hub-config

# Or use --kubeconfig flag
kubectl --kubeconfig ~/.kube/aks-rg-hypera-cafehyna-hub-config get pods -n argocd
```

### Aliases (Recommended)

```bash
# Add to ~/.bashrc or ~/.zshrc
alias k-hub='kubectl --kubeconfig ~/.kube/aks-rg-hypera-cafehyna-hub-config'
alias argocd-hub='KUBECONFIG=~/.kube/aks-rg-hypera-cafehyna-hub-config argocd'
```

## Connection Modes

| Mode | Server | Use Case |
|------|--------|----------|
| **Production** | `argocd.cafehyna.com.br` | Direct access to ArgoCD |
| **Port-Forward** | `localhost:8080` | Local development/debugging |

## Workflow Routing

| Workflow | Trigger | File |
|----------|---------|------|
| **Login** | "login to argocd", "authenticate" | `Workflows/Login.md` |
| **AppManage** | "create app", "delete app", "sync app", "app status" | `Workflows/AppManage.md` |
| **AppSetManage** | "create applicationset", "appset", "generate apps" | `Workflows/AppSetManage.md` |
| **ClusterManage** | "add cluster", "list clusters", "remove cluster" | `Workflows/ClusterManage.md` |
| **RepoManage** | "add repo", "list repos", "remove repository" | `Workflows/RepoManage.md` |
| **ProjectManage** | "create project", "list projects", "project settings" | `Workflows/ProjectManage.md` |
| **Troubleshoot** | "app logs", "diff", "rollback", "history" | `Workflows/Troubleshoot.md` |

## Quick Reference

### Authentication
```bash
# Login to production (with kubeconfig set)
export KUBECONFIG=~/.kube/aks-rg-hypera-cafehyna-hub-config
argocd login argocd.cafehyna.com.br --sso

# Login via port-forward
kubectl --kubeconfig ~/.kube/aks-rg-hypera-cafehyna-hub-config port-forward svc/argocd-server -n argocd 8080:443 &
argocd login localhost:8080 --insecure
```

### Common Operations
```bash
# List applications
argocd app list

# Sync application
argocd app sync <app-name>

# Get app details
argocd app get <app-name>

# List applicationsets
argocd appset list
```

### kubectl Commands (cafehyna-hub)
```bash
# Get ArgoCD pods
kubectl --kubeconfig ~/.kube/aks-rg-hypera-cafehyna-hub-config get pods -n argocd

# Get applications (CRD)
kubectl --kubeconfig ~/.kube/aks-rg-hypera-cafehyna-hub-config get applications -n argocd

# Get applicationsets (CRD)
kubectl --kubeconfig ~/.kube/aks-rg-hypera-cafehyna-hub-config get applicationsets -n argocd

# Get ArgoCD server logs
kubectl --kubeconfig ~/.kube/aks-rg-hypera-cafehyna-hub-config logs -n argocd -l app.kubernetes.io/name=argocd-server -f
```

## Tools

| Tool | Purpose | File |
|------|---------|------|
| **ArgoCdCli** | Execute argocd commands with connection handling | `Tools/ArgoCdCli.ts` |

## Examples

**Example 1: Sync an application**
```
User: "Sync the grafana application in ArgoCD"
→ Invokes AppManage workflow
→ Runs: argocd app sync grafana
→ Reports sync status and health
```

**Example 2: Create ApplicationSet**
```
User: "Create an applicationset for the monitoring stack"
→ Invokes AppSetManage workflow
→ Guides through appset creation with multi-source pattern
→ Applies via: argocd appset create -f appset.yaml
```

**Example 3: Check application logs**
```
User: "Show me logs for the failing defectdojo app"
→ Invokes Troubleshoot workflow
→ Runs: argocd app logs defectdojo --follow
→ Displays pod logs for debugging
```

**Example 4: Add new cluster**
```
User: "Register the new dev cluster with ArgoCD"
→ Invokes ClusterManage workflow
→ Runs: argocd cluster add <context-name>
→ Confirms cluster registration
```

Overview

This skill provides ArgoCD CLI interaction tailored for the cafehyna-hub cluster at argocd.cafehyna.com.br or via localhost:8080 port-forward. It streamlines common ArgoCD tasks—login, application and ApplicationSet management, syncing, status checks, repo/cluster/project operations, and troubleshooting—using the configured kubeconfig. Use it to run argocd and kubectl commands reliably against the hub environment.

How this skill works

The skill sets KUBECONFIG to ~/.kube/aks-rg-hypera-cafehyna-hub-config or accepts an explicit --kubeconfig flag, then routes user intents to workflow handlers (Login, AppManage, AppSetManage, ClusterManage, RepoManage, ProjectManage, Troubleshoot). It can operate against the production server argocd.cafehyna.com.br or a local port-forward at localhost:8080, invoking argocd CLI and kubectl for CRD queries and logs. Commands are executed via an ArgoCdCli helper that handles connection mode and command composition.

When to use it

Authenticating to ArgoCD (SSO or port-forward) for cafehyna-hub
Creating, deleting, syncing, or getting status for ArgoCD applications
Creating or applying ApplicationSets for multi-app deployments
Registering or listing clusters and repositories managed by ArgoCD
Investigating app health, diffs, logs, rollbacks, or deployment history

Best practices

Export KUBECONFIG or use kubeconfig flag to avoid operating against the wrong cluster
Prefer production server argocd.cafehyna.com.br for real operations; use localhost:8080 for local debugging with port-forward
Create shell aliases (k-hub, argocd-hub) to shorten repetitive commands
Check application CRDs via kubectl in the argocd namespace before destructive changes
Follow sync and health reports after sync to confirm successful deployments

Example use cases

Login with SSO: export KUBECONFIG and run argocd login argocd.cafehyna.com.br --sso
Sync app: argocd app sync grafana and return sync status and health
Create ApplicationSet: guide through appset creation and apply via argocd appset create -f appset.yaml
Troubleshoot failing app: argocd app logs <app> --follow and use kubectl logs for pod-level details
Register a cluster: argocd cluster add <context-name> and confirm registration

FAQ

Can I use this skill locally without exposing the production server?

Yes. Port-forward the ArgoCD server (kubectl port-forward svc/argocd-server -n argocd 8080:443 &) and log in to localhost:8080 with --insecure for local development.

Which kubeconfig does the skill use by default?

It uses ~/.kube/aks-rg-hypera-cafehyna-hub-config by default; you can also pass --kubeconfig to kubectl or set the KUBECONFIG environment variable.