mcpField
A
ArgoCdCommand

ArgoCdCommand

github.com/julianobarbosaCloud & DevOps1451 installsUpdated 2d ago
Repository

About ArgoCdCommand

A CLI interaction skill for managing ArgoCD in the `cafehyna-hub` cluster. It routes requests to workflows for applications, ApplicationSets, clusters, repositories, projects, login, and troubleshooting, with production and port-forward connection modes.

Key features

  1. 01ArgoCD login guidance
  2. 02Application and ApplicationSet management
  3. 03Cluster, repository, and project operations
  4. 04Troubleshooting and log workflows
  5. 05Production and port-forward connections

Use cases

  1. 01Sync an ArgoCD application
  2. 02Create an ApplicationSet
  3. 03Inspect application logs
  4. 04Register a cluster with ArgoCD

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/julianobarbosa/claude-code-skills --skill argocdcommand

After installing, type/argocdcommandin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

Tools/
ArgoCdCli.ts
Workflows/
AppManage.md
AppSetManage.md
ClusterManage.md
Login.md
ProjectManage.md
RepoManage.md
Troubleshoot.md

Details

From the project README

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

SettingValue
Kubeconfig~/.kube/aks-rg-hypera-cafehyna-hub-config
ArgoCD Serverargocd.cafehyna.com.br
ArgoCD Namespaceargocd
Port-Forwardlocalhost:8080
Environment Setup
# 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)
# 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

ModeServerUse Case
Productionargocd.cafehyna.com.brDirect access to ArgoCD
Port-Forwardlocalhost:8080Local development/debugging

Workflow Routing

WorkflowTriggerFile
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
# 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
# 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)
# 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

ToolPurposeFile
ArgoCdCliExecute argocd commands with connection handlingTools/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

Comments

Markdown supported