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

# converge

> Detect and repair component configuration drift.

Use `converge` when component files have drifted from the state represented by the project, for example after pulling upstream changes or editing component-owned files by hand. `sitectl set` applies its change immediately and does not require a follow-up converge.

## Reference

Inspect each component registered by the active context's plugin and apply
any changes needed to bring the project back into alignment.

By default the command is interactive and asks before applying changes. Pass
`--report` to preview what would change without applying it.

This command dispatches to the plugin associated with the active context.
All flags and arguments are forwarded to the plugin's converge handler.

Examples:
sitectl converge
sitectl converge `--report`
sitectl converge `--component` fcrepo

```bash theme={null}
sitectl converge [flags]
```

## Workflow

```bash theme={null}
# Preview what would change without applying it
sitectl converge --report

# Apply all changes interactively
sitectl converge

# Converge a single component
sitectl converge --component fcrepo
```

## Relationship to validate

`sitectl validate` tells you *whether* something has drifted. `sitectl converge` repairs drifted components while preserving components that are already in a valid enabled or disabled state. Run validate first to understand what needs to change.

## Plugin flags

All flags are forwarded to the plugin's converge handler. For the ISLE plugin the following flags are available:

| Flag                | Description                                            |
| ------------------- | ------------------------------------------------------ |
| `--report`          | Preview changes without applying them                  |
| `--component`       | Converge a single component (e.g. `fcrepo`)            |
| `--verbose`         | Show additional detail for each component              |
| `--format`          | Output format for `--report` (table, json, yaml)       |
| `--codebase-rootfs` | Codebase rootfs path relative to the project directory |