# Argocdcommand

> 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. Use when this capability is needed.

- Skill: `tomevault-io/argocdcommand` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/argocdcommand`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/argocdcommand/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/argocdcommand

---


# 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
```

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/julianobarbosa) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-11 -->