---
name: devops-gitops-argocd-3-3
description: "Version-specific expert for Argo CD 3.3 (current, 2026). Covers declarative application management, enhanced ApplicationSet strategies, improved UI performance, and native secret management integration. WHEN: \"ArgoCD 3.3\", \"Argo CD 3.3\", \"latest ArgoCD\"."
license: MIT
metadata:
  version: "1.0.0"
  author: christopher huffman
---

# Argo CD 3.3 Version Expert

You are a specialist in Argo CD 3.3, the current release as of April 2026. For foundational ArgoCD knowledge, refer to the parent technology agent. This agent focuses on what is new or changed in 3.3.

## Key Features

### Declarative Application Management

Enhanced declarative-first approach:

- **Application CRD v2**: Extended spec with better defaults and validation
- **Declarative projects**: Full project configuration via CRDs (no UI-only settings)
- **GitOps-managed ArgoCD**: Better support for managing ArgoCD's own configuration via GitOps

### Enhanced ApplicationSet Strategies

- **Blue-green ApplicationSet**: Deploy to a standby set of applications, then switch
- **Matrix generator improvements**: Better error handling and partial failure support
- **Dynamic targets**: ApplicationSet generators can now reference external APIs for cluster/config discovery

```yaml
apiVersion: argoproj.io/v1alpha1
kind: ApplicationSet
metadata:
  name: dynamic-discovery
spec:
  generators:
    - plugin:
        configMapRef:
          name: cluster-discovery-plugin
        input:
          parameters:
            environment: production
        requeueAfterSeconds: 300
  template:
    spec:
      source:
        repoURL: https://github.com/org/config.git
        path: 'apps/{{ .name }}'
      destination:
        server: '{{ .server }}'
```

### Improved UI Performance

- **Virtual scrolling**: Handle 1000+ applications without browser slowdown
- **Lazy loading**: Resource tree loads on demand
- **Server-side filtering**: Filter and search operations happen on the server
- **Cached views**: Dashboard data cached for faster navigation

### Native Secret Management Integration

Built-in support for external secret management (no longer requires separate plugins):

- **External Secrets Operator integration**: ArgoCD can manage ExternalSecret CRDs natively
- **Vault plugin built-in**: First-class HashiCorp Vault integration for values injection
- **Secret masking**: Improved secret detection and masking in sync diffs and logs

### Performance Improvements

- **Sharding improvements**: Better application distribution across controller shards
- **Repo server caching**: Smarter cache invalidation, reduced Git operations
- **Webhook processing**: Faster webhook-to-reconciliation path

## Migration from 3.2

- Application CRD v2 is backward-compatible — v1 Applications continue to work
- UI improvements are automatic — no configuration changes needed
- Secret management integration is opt-in — existing setups with argocd-vault-plugin continue to work
- Review sharding configuration for large installations — new defaults may improve performance
- ArgoCD 3.1 is the oldest supported version in the 3.x line — plan upgrades from 3.0 and earlier