> ## Documentation Index
> Fetch the complete documentation index at: https://radarhq.io/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# GitOps workspace

> Operate Argo CD Applications and Flux Kustomizations and HelmReleases from one fleet view, with topology, diagnosis, activity, and reconciliation controls.

Radar gives Argo CD and Flux a shared operational workspace. Instead of treating GitOps resources as generic CRDs, it resolves their sources, maps the resources they manage, explains unhealthy reconciliation state, and puts the appropriate controls next to the problem.

<Frame>
  <img src="https://radarhq.io/images/radar/screenshot-gitops.png" alt="Radar GitOps fleet view with Argo CD Applications and Flux Kustomizations and HelmReleases" />
</Frame>

## Start with the fleet

Open **GitOps** in the sidebar to see Argo CD Applications alongside Flux Kustomizations and HelmReleases. Each row shows the controller, source, destination, sync and health state, automation mode, and lifecycle state.

Use search and filters to narrow the fleet by sync, health, project, namespace, labels, automation, or lifecycle. Radar resolves Flux source references to their repository URL, so both ecosystems are recognizable without opening the underlying CRD.

Click a row to open its detail page. Every detail page has three top-level tabs:

* **Topology** maps the GitOps resource to its sources, dependencies, and managed Kubernetes resources.
* **Resources** lists the managed objects. The additional diagnosis available here depends on the controller and apply strategy.
* **Activity** shows the reconciliation signal Radar can read from the controller resource.

## Argo CD and Flux capabilities

The workspace is shared, but Radar does not pretend the two controllers expose identical data.

| Capability      | Argo CD                                                                                            | Flux                                                                                                       |
| --------------- | -------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------- |
| Fleet resources | Applications                                                                                       | Kustomizations and HelmReleases                                                                            |
| Source context  | Repository, path, revision, destination, and project                                               | Git, OCI, Helm, or bucket source, path or chart, revision, and target namespace                            |
| Topology        | Application-managed resources and nested Applications                                              | Source, `dependsOn`, inventory or Helm-managed resources, and nested Flux resources                        |
| Diagnosis       | Application conditions, operation failures, drift state, child health, and lifecycle issues        | Failing readiness and Helm conditions, stalled or reconciling state, source failures, and lifecycle issues |
| Resources       | Managed resources, recent Kubernetes events, and field-level drift when desired state is available | Managed-resource inventory and live resource state                                                         |
| Activity        | Current operation and deployment history, including initiator and revision                         | Current condition transitions and applied or attempted revision                                            |
| Operations      | Sync, refresh, terminate, auto-sync, rollback, and selective sync                                  | Reconcile, sync with source, suspend, and resume                                                           |

For a screenshot-led Flux walkthrough, setup guidance, and Flux-specific limitations, see [FluxCD UI and Kubernetes integration](/docs/features/integrations/flux). For exact CRD and API coverage, see the [GitOps coverage matrix](/docs/features/integrations/gitops-flux-argo).

## Understand what an application manages

The **Topology** tab is the common visual model for both controllers. Switch between graph and table views, search the resource tree, or filter by kind, sync, health, role, and namespace.

Radar follows Kubernetes ownership from the GitOps root through workloads, ReplicaSets, and Pods. It also understands controller-specific relationships:

* Argo CD Applications connect to the resources reported in their managed-resource tree. Child Applications open as their own GitOps detail pages.
* Flux Kustomizations and HelmReleases connect to their source, `dependsOn` dependencies, and managed resources discovered from Flux inventory or helm-controller labels.

Nested GitOps resources carry an **Argo** or **Flux** badge and open as their own GitOps detail pages rather than generic resource drawers. A lineage breadcrumb keeps the parent reachable as you move through nested Applications or a Flux dependency chain.

## Diagnose the current state

The issue band at the top of a detail page translates controller state into an operator-facing explanation. It separates controller-specific diagnosis from shared lifecycle problems:

* **Argo CD** - operation failures, Application conditions, unhealthy or missing children, drift with auto-sync disabled, and drift that persists after a successful automatic sync.
* **Flux** - failed `Ready`, `Healthy`, `Released`, or `TestSuccess` conditions, plus stalled or actively reconciling state, with the controller's message and affected source or dependency context preserved.
* **Both** - pending deletion, finalizer ownership, deletion age, and controller health when Radar can read the controller Pods.

The **Resources** tab provides deeper per-resource investigation for Argo CD Applications. Radar shows recent Kubernetes events and computes field-level drift when desired state is available from the Argo CD API or a resource's `kubectl.kubernetes.io/last-applied-configuration` annotation. Flux currently provides managed-resource inventory and live state, but not Git-to-live field diffs or the same per-resource event enrichment.

## Review activity

Activity reflects the history each controller exposes:

* **Argo CD** shows the current operation and deployment history with timestamps, revisions, initiators, and rollback actions.
* **Flux** shows the current condition transitions and the applied or attempted revision. It is not a complete historical operation log.

Reconciliation-related Kubernetes events also appear in the [Timeline](/docs/features/timeline), where clicking an Application, Kustomization, or HelmRelease opens its GitOps detail page.

## Operate the controller

Radar uses the operation appropriate to the selected resource. Keyboard shortcut `s` opens Argo CD Sync or triggers Flux Reconcile.

### Argo CD

| Operation                      | What it does                                                                                                           |
| ------------------------------ | ---------------------------------------------------------------------------------------------------------------------- |
| **Sync**                       | Applies the desired state with options for prune, dry run, force, replace, server-side apply, and selective resources. |
| **Refresh / Hard refresh**     | Re-fetches application state, optionally bypassing repository cache.                                                   |
| **Terminate**                  | Cancels an operation in progress.                                                                                      |
| **Suspend / Enable auto-sync** | Disables or restores automated sync while preserving its prior prune and self-heal settings.                           |
| **Rollback**                   | Syncs to a selected deployment-history entry.                                                                          |

### Flux

| Operation            | What it does                                                              |
| -------------------- | ------------------------------------------------------------------------- |
| **Reconcile**        | Requests an immediate reconciliation outside the configured interval.     |
| **Sync with source** | Reconciles the referenced source before the Kustomization or HelmRelease. |
| **Suspend / Resume** | Toggles `spec.suspend`.                                                   |

Mutating operations are disabled while a resource is terminating. The same operations are available to AI clients through Radar's [MCP server](/docs/features/mcp), with Kubernetes RBAC as the enforcement boundary.

## GitOps context across Radar

GitOps ownership remains visible outside the workspace:

* Resource drawers link tracked Kubernetes objects back to their owning Application, Kustomization, or HelmRelease.
* Topology and Timeline open GitOps resources in their dedicated detail pages.
* Helm releases installed by Flux show their owning HelmRelease and warn that direct Helm changes may be reconciled back.
* Cluster Audit flags resources stuck terminating using the same lifecycle thresholds as GitOps detail pages.

## Permissions and scope

Read-only visibility requires access to the Argo CD or Flux CRDs. Operations require the corresponding `patch` permissions. Canonical Git-rendered Argo CD diffs require a configured Argo CD API integration and access to its managed-resource data. See [in-cluster configuration](/docs/configuration/in-cluster) for Helm values and custom RBAC rules.

Radar builds GitOps relationships from the cluster it is connected to. Argo CD hub-and-spoke installations cannot show Application-to-workload edges when the controller and workloads live in different clusters. Flux normally reconciles its local cluster, so its relationships are usually available.

## Go deeper

* [FluxCD UI and Kubernetes integration](/docs/features/integrations/flux) - Flux workflows, screenshots, supported resources, setup, and limitations.
* [GitOps coverage matrix](/docs/features/integrations/gitops-flux-argo) - exact Argo CD and Flux CRD and feature coverage.
* [Topology view](/docs/features/topology) - how GitOps groupings fit into the wider cluster graph.
* [Cluster audit](/docs/features/cluster-audit) - lifecycle and reliability checks across the cluster.
* [MCP server](/docs/features/mcp) - GitOps operations and diagnosis for AI clients.