Agent skill

kargo-cli

This skill should be used when users need to manage progressive delivery via Kargo CLI. It covers freight management, stage promotion, warehouse status, and deployment pipeline operations. Integrates with ArgoCD for GitOps sync. Triggers on requests mentioning Kargo, freight, stage promotion, progressive delivery, or deployment pipelines.

View SKILL.md on GitHub Repository
Stars 1
Forks 0

Install this agent skill to your Project

npx add-skill https://github.com/oldwinter/skills/tree/main/devops-skills/kargo-cli

SKILL.md

Kargo CLI Skill

This skill enables progressive delivery management using Kargo CLI.

Environment

Connection

  • Server: http://192.168.10.117:31080
  • Web UI: http://192.168.10.117:31080
  • Credentials: admin / admin

Login Command

If token expires, re-authenticate:

bash
kargo login http://192.168.10.117:31080 --admin --password admin --insecure-skip-tls-verify

Project Overview

Project Description
kargo-simplex SimplexAI main deployment pipeline

Stages

Stage Environment ArgoCD App Auto-Promote
local K3s Local simplex-local Yes
local2 K3s Local2 simplex-local2 Yes
staging AWS EKS Staging simplex-k2-staging Yes
prod AWS EKS Production simplex-k1-prod No (Manual)

Core Concepts

Freight

A Freight represents a collection of artifacts (container images, git commits, Helm charts) that can be promoted through stages.

Stage

A Stage represents an environment in the deployment pipeline. Freights are promoted from one stage to another.

Warehouse

A Warehouse monitors artifact sources (ECR, git) for new versions and creates freights automatically.

Common Operations

Project Management

bash
# List all projects
kargo get projects

# Get project details
kargo get project kargo-simplex

Stage Operations

bash
# List stages in project
kargo get stages -p kargo-simplex

# Get specific stage details
kargo get stage staging -p kargo-simplex

# Get stage in YAML format
kargo get stage staging -p kargo-simplex -o yaml

Freight Management

bash
# List all freights in project
kargo get freights -p kargo-simplex

# Get freight details
kargo get freight <freight-id> -p kargo-simplex

# List freights verified for a stage
kargo get freights -p kargo-simplex --verified-in staging

# List freights approved for a stage
kargo get freights -p kargo-simplex --approved-for prod

Promotion Operations

bash
# Promote freight to stage
kargo promote --stage staging -p kargo-simplex --freight <freight-id>

# Promote latest available freight
kargo promote --stage staging -p kargo-simplex

# Promote to production (manual approval required)
kargo promote --stage prod -p kargo-simplex --freight <freight-id>

Warehouse Operations

bash
# List warehouses
kargo get warehouses -p kargo-simplex

# Get warehouse details
kargo get warehouse <name> -p kargo-simplex

# Refresh warehouse (check for new artifacts)
kargo refresh warehouse <name> -p kargo-simplex

Approval Operations

bash
# Approve freight for stage
kargo approve --stage prod -p kargo-simplex --freight <freight-id>

Deployment Pipeline Flow

┌─────────────┐     ┌─────────────┐     ┌─────────────┐     ┌─────────────┐
│  Warehouse  │────▶│    local    │────▶│   staging   │────▶│    prod     │
│ (ECR Watch) │     │  (Auto)     │     │   (Auto)    │     │  (Manual)   │
└─────────────┘     └─────────────┘     └─────────────┘     └─────────────┘
       │                   │                   │                   │
       ▼                   ▼                   ▼                   ▼
   New Image         K3s Local           AWS Staging         AWS Prod
   Detected          Deployed            Deployed            Deployed

Typical Workflow

  1. New image pushed to ECR → Warehouse detects
  2. Freight created automatically
  3. Local stage auto-promotes and deploys
  4. Staging stage auto-promotes after local success
  5. Production stage requires manual promotion

Status Interpretation

Stage Status

Status Meaning
Healthy Stage has current freight and is healthy
Progressing Freight is being promoted/verified
Unhealthy Promotion failed or ArgoCD sync failed

Freight Status

Field Meaning
verified Freight has been tested in a stage
approved Freight is approved for promotion to next stage

Output Formatting

Pipeline Status Summary

🚀 Kargo Pipeline Status (kargo-simplex)

┌──────────┬─────────────────────────┬───────────┬─────────────────┐
│ Stage    │ Current Freight         │ Health    │ Status          │
├──────────┼─────────────────────────┼───────────┼─────────────────┤
│ local    │ 719578f13844...         │ Healthy   │ Verified        │
│ staging  │ 719578f13844...         │ Healthy   │ Verified        │
│ prod     │ (pending)               │ -         │ Awaiting Promo  │
└──────────┴─────────────────────────┴───────────┴─────────────────┘

Troubleshooting

Freight Not Created

  1. Check warehouse status: kargo get warehouses -p kargo-simplex
  2. Refresh warehouse: kargo refresh warehouse <name> -p kargo-simplex
  3. Verify ECR credentials are valid
  4. Check warehouse subscriptions match ECR repositories

Stage Not Promoting

  1. Check stage status: kargo get stage <name> -p kargo-simplex
  2. Check if freight is verified in previous stage
  3. Check ArgoCD application sync status
  4. For prod: verify freight is approved

Authentication Expired

bash
kargo login http://192.168.10.117:31080 --admin --password admin --insecure-skip-tls-verify

Integration with ArgoCD

Kargo updates ArgoCD applications by:

  1. Modifying kustomization.yaml image tags in git
  2. Committing changes to the GitOps repository
  3. ArgoCD detects changes and syncs

Key integration points:

  • Warehouse watches same ECR as ArgoCD apps
  • Stage promotion tasks update git overlays
  • ArgoCD apps have kargo.akuity.io/authorized-stage annotation

For application sync and status, use the ArgoCD CLI skill.

Recommended Agent Skills

Expand your agent's capabilities with these related and highly-rated skills.

oldwinter/skills

fundraising

Plan and run an early-stage fundraising process and produce a Fundraising Pack (raise decision memo, round design brief, pitch narrative + deck outline, investor pipeline + tracker, outreach/follow-up scripts, diligence checklist). Use for fundraising, raising capital, venture capital, pitch deck, investor outreach, pre-seed, seed. Category: Career.

1 0
Explore
oldwinter/skills

ai-evaluation-evals

Create AI evaluation plans with benchmarks, rubrics, and error analysis workflows.

1 0
Explore
oldwinter/skills

giving-presentations

Plan and deliver persuasive, confident presentations and produce a Presentation Pack (brief, narrative, slide outline, Q&A bank, pre-brief plan, rehearsal plan, delivery checklist). Use for presentation, deck, keynote, all-hands, exec review, demo talk track. Category: Communication.

1 0
Explore
oldwinter/skills

personal-productivity

Build a Personal Productivity System Pack (weekly timebox plan, capture+to-do system, daily/weekly review rituals, and a 7-day rollout). Use for timeboxing, calendar blocking, and staying on top of high-volume leadership work. Category: Career.

1 0
Explore
oldwinter/skills

ai-product-strategy

Create an AI Product Strategy Pack (thesis, prioritized use cases, system plan, eval + learning plan, agentic safety plan, roadmap). Use for AI product strategy, LLM/agent strategy, AI roadmap, AI-first product direction.

1 0
Explore
oldwinter/skills

career-transitions

Plan and execute a career transition and produce a Career Transition Pack (progress metric + push/pull map, target archetypes, option scorecard, opportunity pipeline + outreach scripts, skills plan, 4–12 week experiment plan). Use for career change, career pivot, career transition, switching roles. Category: Career.

1 0
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results